الدليل الشامل لنشر بيانات النموذج باستخدام React و Axios

تعلم كيفية إرسال بيانات النموذج من تطبيق React الخاص بك إلى الخادم باستخدام Axios، مكتبة عميل HTTP شائعة. تتناول هذه الدليل إعداد React وAxios، وإنشاء مكون نموذج، وإرسال بيانات النموذج باستخدام Axios، واختبار ذلك مع خدمة API وهمية مثل APIdog.

Amir Hassan

Amir Hassan

18 أغسطس 2025

الدليل الشامل لنشر بيانات النموذج باستخدام React و Axios

Apidog للمؤسسات

النشر على الخوادم المحلية

SSO و RBAC

متوافق مع SOC 2

استكشف Apidog للمؤسسات

مرحباً بكم، أيها المطورون الزملاء! اليوم، سنغوص في عالم النشر الرائع لبيانات النماذج باستخدام React وAxios. نعم، لقد سمعتموني بشكل صحيح - سنتعلم كيفية إرسال تلك البيانات اللذيذة من نموذجكم في تطبيق React إلى الخادم باستخدام مكتبة HTTP الرائعة، Axios.

تجعل Axios العملية أكثر سلاسة وكفاءة. إنها تتعامل مع أمور مثل طلبات HTTP، والاستجابات، وحتى إدارة الأخطاء بالنيابة عنك، لذلك يمكنك التركيز على كتابة كود رائع بدلاً من الانغماس في التفاصيل الدقيقة.

لماذا Axios؟

عند الحديث عن التعامل مع طلبات HTTP في عالم JavaScript، تبرز Axios لسهولة استخدامها وبساطتها. إنها مثل وجود سكين جيب سويسري لتفاعلات واجهة البرمجة - متعددة الاستخدامات، موثوقة، ودائماً في متناول اليد. وعند اقترانها مع React، تصبح ثنائياً ديناميكياً يمكنه التعامل مع أي تحدٍ في بيانات النماذج يتم طرحه.

إعداد React وAxios

حسناً، دعونا نبدأ هذه الحفلة! أولاً وقبل كل شيء، نحتاج إلى إعداد تطبيق React الخاص بنا وتثبيت Axios. إذا لم تكن قد قمت بإنشاء مشروع React جديد بالفعل، يمكنك القيام بذلك عن طريق تشغيل الأمر التالي في سطر الأوامر الخاص بك:

npx create-react-app my-awesome-app

بمجرد الانتهاء من ذلك، انتقل إلى دليل المشروع الجديد اللامع وتثبيت Axios عن طريق تشغيل:

npm install axios

رائع! لقد أصبحت مستعداً لبدء استخدام Axios في تطبيق React الخاص بك.

إنشاء مكون نموذج

الآن بعد أن حصلنا على أدواتنا جاهزة، حان الوقت لإنشاء مكون نموذج. سيكون هذا العنصر مسؤولاً عن جمع جميع بيانات النموذج اللذيذة من مستخدميك. دعونا ننشئ ملفاً جديداً يسمى FormComponent.js ونضيف الكود التالي:

import React, { useState } from 'react';

const FormComponent = () => {
  const [formData, setFormData] = useState({
    name: '',
    email: '',
    message: '',
  });

  const handleChange = (e) => {
    setFormData({ ...formData, [e.target.name]: e.target.value });
  };

  const handleSubmit = (e) => {
    e.preventDefault();
    // هنا، سنضيف الكود لنشر بيانات النموذج باستخدام Axios
  };

  return (
    <form onSubmit={handleSubmit}>
      <input
        type="text"
        name="name"
        placeholder="أدخل اسمك"
        value={formData.name}
        onChange={handleChange}
      />
      <input
        type="email"
        name="email"
        placeholder="أدخل بريدك الإلكتروني"
        value={formData.email}
        onChange={handleChange}
      />
      <textarea
        name="message"
        placeholder="أدخل رسالتك"
        value={formData.message}
        onChange={handleChange}
      />
      <button type="submit">إرسال</button>
    </form>
  );
};

export default FormComponent;

في هذا المكون، نحن نستخدم Hook useState لإدارة حالة بيانات النموذج. تقوم دالة handleChange بتحديث حالة بيانات النموذج كلما كتب المستخدم شيئاً في أحد حقول الإدخال. وأخيراً، ستقوم دالة handleSubmit بالمسؤولية عن نشر بيانات النموذج إلى واجهة برمجة التطبيقات الخاصة بنا (لا تقلق، سنصل إلى تلك الجزء قريباً!).

Axios و Apidog

نشر بيانات النموذج باستخدام Axios

حسناً، الآن إلى الحدث الرئيسي! دعونا نضيف الكود لنشر بيانات النموذج باستخدام Axios. أولاً، نحتاج إلى استيراد Axios في ملف FormComponent.js:

import axios from 'axios';

بعد ذلك، سنقوم بتحديث دالة handleSubmit لإجراء طلب POST إلى واجهة برمجة التطبيقات الخاصة بنا باستخدام Axios:

const handleSubmit = async (e) => {
  e.preventDefault();

  try {
    const response = await axios.post('https://api.example.com/submit-form', formData);
    console.log('تم إرسال بيانات النموذج بنجاح:', response.data);
    // يمكنك إضافة منطق إضافي هنا، مثل عرض رسالة النجاح
  } catch (error) {
    console.error('خطأ في إرسال بيانات النموذج:', error);
    // يمكنك إضافة منطق التعامل مع الأخطاء هنا، مثل عرض رسالة الخطأ
  }
};

في هذه الشفرة، نستخدم طريقة axios.post لإرسال طلب POST إلى نقطة نهاية واجهة برمجة التطبيقات الخاصة بنا (https://api.example.com/submit-form). نحن نمرر الكائن formData كجسم الطلب، والذي يحتوي على بيانات النموذج التي نريد إرسالها.

إذا كان الطلب ناجحاً، نقوم بتسجيل بيانات الاستجابة في وحدة التحكم. إذا حدث خطأ، نقوم بتسجيل رسالة الخطأ بدلاً من ذلك. يمكنك إضافة منطق إضافي هنا، مثل عرض رسالة نجاح أو خطأ للمستخدم.

Apidog: أداة مجانية لتوليد كود Axios الخاص بك

Apidog هي منصة تطوير واجهات برمجة التطبيقات التعاونية الشاملة التي توفر مجموعة شاملة من الأدوات لتصميم وتصحيح واختبار ونشر ومحاكاة واجهات برمجة التطبيقات. يمكّنك Apidog من إنشاء كود Axios تلقائياً لإجراء طلبات HTTP.

button

إليك العملية لاستخدام Apidog لتوليد كود Axios:

خطوة 1: افتح Apidog واختر طلب جديد

خطوة 2: أدخل عنوان URL لنقطة نهاية واجهة برمجة التطبيقات التي تريد إرسال طلب إليها، أدخل أي رؤوس أو معلمات سلسلة استعلام ترغب في تضمينها مع الطلب، ثم انقر على "التصميم" للانتقال إلى واجهة تصميم Apidog.

خطوة 3: اختر "توليد كود العميل" لتوليد كودك.

خطوة 4: انسخ الكود الناتج من Axios والصقه في مشروعك.

استخدام Apidog لإرسال طلبات HTTP

Apidog يقدم العديد من الميزات المتقدمة التي تعزز بشكل أكبر قدرته على اختبار طلبات HTTP. تتيح لك هذه الميزات تخصيص طلباتك والتعامل مع سيناريوهات أكثر تعقيداً بسهولة.

button

خطوة 1: افتح Apidog وأنشئ طلباً جديداً.

Apidog

خطوة 2: ابحث عن تفاصيل واجهة برمجة التطبيقات للطلب POST الذي تريد إجراؤه أو أدخلها يدوياً.

Apidog

خطوة 3: املأ المعلمات المطلوبة وأي بيانات تريد تضمينها في جسم الطلب.

Apidog

الخاتمة

تذكر أن نشر بيانات النموذج هو مجرد واحدة من العديد من الأشياء الرائعة التي يمكنك القيام بها باستخدام Axios وReact. يمكنك أيضاً استخدام Axios لإجراء طلبات GET، وPUT، وDELETE، والتعامل مع الرؤوس والمقاطعات، والعديد من الأمور الأخرى.

وهكذا! أصبحتم الآن مجهزين للتعامل مع تقديم النماذج في React باستخدام Axios مثل المطورين المحترفين. استمروا في التجربة، استمروا في التعلم، والأهم من ذلك، استمروا في البرمجة!

ممارسة تصميم API في Apidog

اكتشف طريقة أسهل لبناء واستخدام واجهات برمجة التطبيقات