الأحداث والنماذج

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

معالجة النقر والإرسال

function DeleteButton({ onDelete }) {
  return (
    <button type="button" onClick={onDelete}>
      حذف
    </button>
  );
}

في React تكتب الأحداث بصيغة camelCase: onClick و onSubmit و onChange، وتمرّر لها دالة، لا استدعاء دالة. اكتب onClick={onDelete} أو onClick={() => onDelete(id)}، ولا تكتب onClick={onDelete()} لأنها تُنفَّذ فورًا عند الرسم.

الحقول المتحكَّم بها

الحقل المتحكَّم به (Controlled Input) قيمته محفوظة في الحالة، وكل كتابة تحدّثها:

const [title, setTitle] = useState("");

<input
  value={title}
  onChange={(e) => setTitle(e.target.value)}
  placeholder="مهمة جديدة"
/>;

هكذا تكون قيمة الحقل دائمًا في متغير تعرفه، فتستطيع التحقق منها، وتفريغها، أو تعطيل الزر حسبها.

التحقق من المدخلات

const trimmed = title.trim();
const error = trimmed.length > 0 && trimmed.length < 3 ? "العنوان قصير جدًا" : "";
const canSubmit = trimmed.length >= 3;

لاحظ أن error و canSubmit لا يحتاجان حالة خاصة بهما؛ نحسبهما من title في كل رسم. قاعدة مهمة: لا تجعل حالةً ما يمكن حسابه من حالة أخرى.

مثال: نموذج إضافة مهمة

import { useState } from "react";

export function AddTaskForm({ onAdd }) {
  const [title, setTitle] = useState("");
  const [priority, setPriority] = useState("normal");

  const trimmed = title.trim();
  const tooShort = trimmed.length > 0 && trimmed.length < 3;

  function handleSubmit(event) {
    event.preventDefault();
    if (trimmed.length < 3) return;
    onAdd({ id: crypto.randomUUID(), title: trimmed, priority, done: false });
    setTitle("");
  }

  return (
    <form onSubmit={handleSubmit}>
      <input value={title} onChange={(e) => setTitle(e.target.value)} placeholder="مهمة جديدة" />
      <select value={priority} onChange={(e) => setPriority(e.target.value)}>
        <option value="low">منخفضة</option>
        <option value="normal">عادية</option>
        <option value="high">عالية</option>
      </select>
      <button type="submit" disabled={trimmed.length < 3}>أضف</button>
      {tooShort && <p role="alert">العنوان قصير جدًا</p>}
    </form>
  );
}

crypto.randomUUID() يولّد معرّفًا فريدًا في المتصفحات الحديثة. والمكون الأب يستقبل المهمة الجديدة عبر onAdd ويضيفها إلى حالته.

مهمتك

اربط AddTaskForm بتطبيقك: أضف المهام إلى الحالة في App، وأضف حقل تاريخ للموعد النهائي (type="date")، واعرض المهام ذات الأولوية العالية بلون مختلف.