Menu
CoddyTech

قراءة بيانات النموذج

جزء من قسم أساسيات Next.js في رحلة React على Coddy. الدرس 31 من 47.

يتلقى الإجراء وسيطًا واحدًا: كائن FormData. وهو مضمّن في المتصفح، ولا تحتاج منه إلا إلى طريقة واحدة:

export async function addNote(formData) {
    const text = formData.get('text');
    const author = formData.get('author');
    saveNote(text, author);
}

السلسلة النصية التي تمرّرها إلى get() ليست id الخاص بحقل الإدخال، وليست التسمية الخاصة به. بل هي سمة name:

<input name="author" />      →  formData.get('author')

حقل إدخال بلا name يكون غير مرئي للنموذج. يظهر الحقل، ويمكنك الكتابة فيه، لكن قيمته لا تصل أبدًا: تعيد formData.get() القيمة null. هذا هو الخطأ الأكثر شيوعًا في أول نموذج يستخدم إجراءً على الخادم، ويحدث دون أي تنبيه.

تُرجع get() دائمًا سلسلة نصية (أو null)، لذا يجب تحويل حقل الرقم:

const quantity = Number(formData.get('quantity'));
challenge icon

التحدي

سهل

نموذج الملاحظات مُعدّ، لكن لا يُحفَظ فيه أي شيء مفيد: لا تحتوي حقول الإدخال على name، ويحفظ الإجراء سلسلتين فارغتين.

  1. في app/page.jsx، أضف name="text" إلى حقل الإدخال الأول وname="author" إلى الثاني.
  2. في app/actions.js، اقرأ الحقلين من formData بدلًا من استخدام السلسلتين الفارغتين.

أبقِ المعرّفات كما هي، وأبقِ استدعاء saveNote(text, author): وحدهما القيمتان أعلاه تتغيران.

جرّب بنفسك

import './globals.css';

export const metadata = {
    title: 'My App',
};

export default function RootLayout({ children }) {
    return (
        <html lang="en">
            <body>
                {children}
            </body>
        </html>
    );
}
quiz iconاختبر نفسك

يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.

جميع دروس أساسيات Next.js