Building a React To-Do List
الدرس 31 من 5019:02كورس مجاني

محتوى الدرس
في هذا الدرس، سنقوم ببناء تطبيق To-Do List متكامل باستخدام React و State Management (useState). ستتعلم كيفية إدارة البيانات (إضافة وحذف العناصر)، مع تطبيق أفضل الممارسات في كتابة كود نظيف واحترافي.
1. الكود الكامل للتطبيق (Full Code)
إليك الكود المكتمل للـ Component الخاص بالتطبيق:
JavaScript
import { useState } from "react";
const ToDo = () => {
// 1. حالة النص المدخل في الـ Input
const [inputValue, setInputValue] = useState("");
// 2. قائمة المهام المبدئية
const [tasks, setTasks] = useState([
"learn react",
"go to gym",
"like this video"
]);
// 3. دالة إضافة task جديدة
const handleClick = () => {
setTasks([...tasks, inputValue]);
setInputValue(""); // إعادة تفريغ الـ Input
};
// 4. دالة حذف task بناءً على الـ Index
const handleRemoveItem = (index) => {
setTasks(tasks.filter((_, i) => i !== index));
};
return (
<div>
<h3>to do list</h3>
{/* عرض قائمة المهام */}
<ul>
{tasks.map((task, index) => {
return (
<li key={index}>
{task}{" "}
<button onClick={() => handleRemoveItem(index)}>
remove
</button>
</li>
);
})}
</ul>
{/* إدخال مهام جديدة */}
<input
type="text"
value={inputValue}
onChange={(e) => setInputValue(e.target.value)}
/>
<button onClick={handleClick}>add task</button>
</div>
);
};
export default ToDo;2. الشرح التفصيلي لأجزاء الكود (Step-by-Step)
أولاً: إدارة الـ State
JavaScript
const [inputValue, setInputValue] = useState("");
const [tasks, setTasks] = useState([
"learn react",
"go to gym",
"like this video"
]);- inputValue: نستخدمها لتخزين النص الذي يكتبه المستخدم لحظة بلحظة داخل الـ <input />.
- tasks: عبارة عن مصفوفة (Array) تحتوي على كل المهام. بدأناها بـ 3 مهام افتراضية.
ثانياً: إضافة ممارسة التفاعل مع الـ Input
JavaScript
<input
type="text"
value={inputValue}
onChange={(e) => setInputValue(e.target.value)}
/>- Controlled Component: جعلنا قيمة الـ input مربوطة بـ inputValue.
- عند أي تغيير في الـ Input، تنطلق الدالة onChange وتمرر النص الجديد لـ setInputValue(e.target.value).
ثالثاً: دالة إضافة مهمة جديدة (handleClick)
JavaScript
const handleClick = () => {
setTasks([...tasks, inputValue]);
setInputValue("");
};- [...tasks, inputValue]: نستخدم Spread Operator (...) لنأخذ نسخة من كل المهام القديمة، ونضيف عليها النص الجديد الموجود في inputValue.
- عدم التعديل المباشر (Immutability): في React لا نعدل على المصفوفة القديمة بـ push، بل ننشئ مصفوفة جديدة تمامًا ونمررها لـ setTasks.
- setInputValue(""): نقوم بتصفير حقل الإدخال بعد الإضافة لتهيئة الـ Input لإضافة مهمة جديدة.
رابعاً: عرض العناصر وحذفها (map & handleRemoveItem)
1. كود العرض بالـ JSX:
JavaScript
{tasks.map((task, index) => {
return (
<li key={index}>
{task}{" "}
<button onClick={() => handleRemoveItem(index)}>
remove
</button>
</li>
);
})}- .map(): تقوم بالتكرار على كل عنصر في المصفوفة وإرجاع عنصر <li> يحتوي على اسم المهمة وزر الحذف.
- onClick={() => handleRemoveItem(index)}: نمرر الـ index الخاص بالمهمة عند الضغط على الزر. نستخدم Arrow Function لمنع استدعاء الدالة تلقائيًا أثناء الـ Rendering.
2. دالة الحذف الذكية:
JavaScript
const handleRemoveItem = (index) => {
setTasks(tasks.filter((_, i) => i !== index));
};دعنا نفكك هذا السطر بعناية:
- tasks.filter(...): دالة تقوم بفلترة المصفوفة وإرجاع مصفوفة جديدة بالعناصر التي تحقق الشرط فقط.
- معاملات الفلترة (_, i):
- _ (Underscore): هو المعامل الأول ويرمز للعنصر نفسه (task). تم تسميته بـ _ كعُرف برمجّي يدعى (Unused Parameter)، لأننا لا نحتاج النص في الفلترة بل نعتمد على الترتيب.
- i: المعامل الثاني ويرمز لترتيب العنصر الحالي أثناء الـ Loop.
- i !== index: الشرط يعني: "أبقِ على كل العناصر التي لا يتماثل رقم ترتيبها (i) مع رقم العنصر المراد حذفه (index)".
ملخص وأهم المفاهيم (Key Concepts)
- Immutability in React: تجنب تعديل الـ Arrays بـ splice أو push واستخدم دائمًا filter و Spread Operator (...).
- Underscore _ Convention: اسم متغير عادي معتمد بـ JavaScript لإعلام المطورين بعدم استخدام هذا المعامل.
- Controlled Inputs: ربط الـ State بـ value و onChange للتحكم الكامل بأداء النموذج.