جلب البيانات ومشروع قائمة المهام

في هذا الفصل الأخير تتصل صفحتك بالعالم الخارجي: تجلب بيانات من API، وتحفظ بيانات في المتصفح، ثم تجمع كل ما تعلمته في مشروعك الأول: قائمة مهام.

fetch و async/await

fetch يرسل طلبًا إلى عنوان ويعيد الرد. ولأن الرد يأخذ وقتًا، نستعمل async و await لننتظره بطريقة مقروءة:

async function loadUsers() {
  try {
    const response = await fetch("https://jsonplaceholder.typicode.com/users");
    if (!response.ok) throw new Error(`خطأ ${response.status}`);

    const users = await response.json();
    console.log(users);
  } catch (error) {
    console.error("تعذّر جلب البيانات:", error.message);
  }
}

loadUsers();
  • await لا تُستعمل إلا داخل دالة عليها async.
  • try و catch يلتقطان الخطأ إذا انقطع الإنترنت أو رد الخادم بخطأ، فلا يتوقف البرنامج كله.
  • JSONPlaceholder خدمة مجانية تعطي بيانات تجريبية، ممتازة للتدرب.

قراءة JSON وعرضه في الصفحة

JSON صيغة نصية لتبادل البيانات تشبه كائنات JavaScript. response.json() يحوّلها إلى كائنات تستعملها مباشرة:

const list = document.querySelector("#users");

for (const user of users) {
  const item = document.createElement("li");
  item.textContent = `${user.name}: ${user.email}`;
  list.append(item);
}

حفظ البيانات في localStorage

localStorage يحفظ نصوصًا في متصفح الزائر، وتبقى بعد إغلاق الصفحة. لحفظ مصفوفة أو كائن حوّله إلى نص بـ JSON.stringify ثم أعده بـ JSON.parse:

const tasks = [{ text: "تصميم الصفحة", done: false }];

localStorage.setItem("tasks", JSON.stringify(tasks));

const saved = JSON.parse(localStorage.getItem("tasks") ?? "[]");

لا تحفظ فيه كلمات مرور أو بيانات حساسة؛ أي كود يعمل في الصفحة يستطيع قراءته.

المشروع: قائمة مهام تضيف وتحذف وتحفظ

<form id="task-form">
  <input id="task-input" placeholder="مهمة جديدة" required>
  <button type="submit">أضف</button>
</form>
<ul id="task-list"></ul>
const form = document.querySelector("#task-form");
const input = document.querySelector("#task-input");
const list = document.querySelector("#task-list");

let tasks = JSON.parse(localStorage.getItem("tasks") ?? "[]");

function save() {
  localStorage.setItem("tasks", JSON.stringify(tasks));
}

function render() {
  list.innerHTML = ""; // تفريغ القائمة، ثم إعادة بنائها
  tasks.forEach((task, index) => {
    const item = document.createElement("li");
    item.classList.toggle("done", task.done);

    const text = document.createElement("span");
    text.textContent = task.text;
    text.addEventListener("click", () => {
      tasks[index].done = !tasks[index].done;
      save();
      render();
    });

    const remove = document.createElement("button");
    remove.textContent = "حذف";
    remove.addEventListener("click", () => {
      tasks = tasks.filter((_, i) => i !== index);
      save();
      render();
    });

    item.append(text, remove);
    list.append(item);
  });
}

form.addEventListener("submit", (event) => {
  event.preventDefault();
  const text = input.value.trim();
  if (!text) return;
  tasks.push({ text, done: false });
  input.value = "";
  save();
  render();
});

render();

لاحظ النمط: البيانات في مصفوفة tasks، وكل تغيير يعدّل المصفوفة ثم يحفظها ثم يعيد رسم القائمة بـ render(). هذا النمط نفسه ستجده في React بشكل أكثر تنظيمًا.

مهمتك

طوّر قائمة المهام: أضف ثلاثة أزرار تصفية (الكل، المنجزة، الباقية)، وعدّادًا يعرض عدد المهام الباقية، وزرًا يحذف كل المهام المنجزة. ثم انشرها على Netlify وأضفها إلى معرض أعمالك.