قراءة بيانات النموذج
جزء من قسم أساسيات 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'));التحدي
سهلنموذج الملاحظات مُعدّ، لكن لا يُحفَظ فيه أي شيء مفيد: لا تحتوي حقول الإدخال على name، ويحفظ الإجراء سلسلتين فارغتين.
- في
app/page.jsx، أضفname="text"إلى حقل الإدخال الأول وname="author"إلى الثاني. - في
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>
);
}يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.
جميع دروس أساسيات Next.js
4الخادم والعميل
نوعان من المكوّناتقراءة رسالة الخطأسطر 'use client'اجعل أجزاء العميل صغيرةالخادم داخل العميلمراجعة: الخادم والعميل7التنقل بين صفحات العميل
الرابط النشطالتوجيه البرمجيالتصفية باستخدام URLمعالجات المساراتمراجعة: التنقل2التوجيه والروابط
المجلدات هي مساراتالمسارات المتداخلةربط الصفحاتالمسارات الديناميكيةصفحات غير موجودةمراجعة: التوجيه3التخطيطات والبيانات الوصفية
التخطيط الجذرالتنقل المشتركالتخطيطات المتداخلةالبيانات الوصفية للصفحةالبيانات الوصفية الديناميكيةمراجعة: التخطيطات6إجراءات الخادم
ما هي إجراءات الخادم؟نماذج تتفاعلقراءة بيانات النموذجتحديث الصفحةمراجعة: إجراءات الخادم