TypeScript Tutorial پروژه عملی پایان دوره پروژه عملی سطح: متوسط

پروژه پایانی ۱ — مدیریت کارها (Todo) تایپ‌شده

پروژه پایانی اول: یک برنامه مدیریت کارها (Todo List) کامل با TypeScript خالص که همه مهارت‌های دوره را به کار می‌گیرد: اینترفیس برای مدل داده، Literal Type برای وضعیت، ژنریک برای مخزن داده، کلاس برای منطق و DOM برای رابط کاربری.

راه‌حل قدم‌به‌قدم پروژه

  1. ۱

    هدف پروژه

    ساخت برنامه Todo با امکان افزودن، تکمیل، حذف و فیلتر کارها؛ همه داده‌ها تایپ‌شده و بدون any.

  2. ۲

    الزامات و موارد موردنیاز

    یک فایل HTML ساده با فیلد ورودی، دکمه افزودن و لیست کارها؛ TS strict فعال؛ بدون any و بدون @ts-ignore.

  3. ۳

    قدم ۱ — مدل داده را اینترفیس کنید

    اینترفیس Task با فیلدهای id، title، done بنویسید. وضعیت فیلتر را با Literal Type تعریف کنید: type Filter = 'all' | 'open' | 'done' — همین دو تعریف بقیه برنامه را امن می‌کند.

  4. ۴

    قدم ۲ — مخزن داده ژنریک بسازید

    کلاس Store<T> با آرایه private items: T[] و متدهای add، remove، getAll ژنریک تعریف کنید؛ بعد از آن Store<Task> بسازید. ژنریک اینجا یعنی مخزن برای هر داده دیگر هم قابل استفاده است.

  5. ۵

    قدم ۳ — منطق افزودن و تکمیل

    تابع addTask متن فیلد را trim و چک خالی کند؛ هر کار با id یکتا (Date.now یا شمارنده) و done:false ساخته شود. کلیک روی کار، وضعیت done را toggle کند.

  6. ۶

    قدم ۴ — رندر لیست با DOM امن

    تابع render(store) همه کارها را در ul بسازد؛ برای هر آیتم li بسازید، event listener کلیک بدهید و استایل خط خوردگی برای کارهای done بگذارید. همه querySelectorها را چک null کنید.

  7. ۷

    قدم ۵ — فیلتر و ذخیره‌سازی

    سه دکمه فیلتر اضافه کنید که متغیر Filter را عوض و دوباره render کند. در پایان، لیست را در localStorage با JSON.stringify ذخیره و در شروع با چک نوع بخوانید.

نکات مهم

  • ◆ قبل از خواندن راه‌حل، خودتان حداقل ۳۰ دقیقه تلاش کنید؛ یادگیری واقعی در همین تلاش اتفاق می‌افتد.
  • ◆ راه‌حل را بعد از دیدن، عمداً تغییر دهید و دوباره اجرا کنید تا با هر خط آن آشنا شوید.
  • ◆ اگر جایی گیر کردید، فقط بخش مشکل را جستجو کنید، نه کل پروژه را — دامنه جستجوی کوچک یادگیری را عمیق‌تر می‌کند.

کد کامل راه‌حل پروژه

interface Task {
  id: number;
  title: string;
  done: boolean;
}
type Filter = "all" | "open" | "done";

class Store<T extends { id: number }> {
  private items: T[] = [];
  add(item: T): void { this.items.push(item); }
  remove(id: number): void { this.items = this.items.filter((it) => it.id !== id); }
  get all(): T[] { return [...this.items]; }
}

const store = new Store<Task>();
let filter: Filter = "all";

function visible(): Task[] {
  return store.all.filter((t) =>
    filter === "all" ? true : filter === "done" ? t.done : !t.done
  );
}

function render(): void {
  const list = document.querySelector<HTMLUListElement>("#list");
  if (!list) return;
  list.innerHTML = "";
  for (const task of visible()) {
    const li = document.createElement("li");
    li.textContent = task.title;
    li.style.textDecoration = task.done ? "line-through" : "none";
    li.addEventListener("click", () => { task.done = !task.done; render(); });
    const del = document.createElement("button");
    del.textContent = "حذف";
    del.addEventListener("click", (e) => { e.stopPropagation(); store.remove(task.id); render(); });
    li.appendChild(del);
    list.appendChild(li);
  }
}

const input = document.querySelector<HTMLInputElement>("#input");
document.querySelector<HTMLButtonElement>("#add")?.addEventListener("click", () => {
  if (!input) return;
  const title = input.value.trim();
  if (title === "") return;
  store.add({ id: Date.now(), title, done: false });
  input.value = "";
  render();
});

["all", "open", "done"].forEach((f) => {
  document.querySelector<HTMLButtonElement>(`#f-${f}`)?.addEventListener("click", () => {
    filter = f as Filter;
    render();
  });
});

render();

اجرای زنده کد JavaScript

editor.html
در حال آماده‌سازی زمین بازی…

کد را ویرایش کنید و «اجرای کد» را بزنید — خروجی واقعی مرورگر همین‌جا رندر می‌شود؛ مثل آزمایشگاه w3schools.

خروجی مورد انتظار

پس از اجرا: با تایپ «خرید نان» و دکمه افزودن، کار جدید در لیست ظاهر می‌شود. کلیک روی کار آن را تکمیل (خط خورده) می‌کند، دکمه حذف آن را پاک می‌کند و سه دکمه فیلتر همه/باز/انجام‌شده لیست را جابه‌جا می‌کنند.

چالش اضافه (اختیاری)

یک شمارنده «X کار باز از Y» بالای لیست اضافه کنید و داده را با تاریخ ساخته‌شدن هر کار مرتب کنید.

پرسش و پاسخ این درس (۰)

هنوز دیدگاهی ثبت نشده؛ اولین نفر باشید!

دیدگاه خود را بنویسید

کپچا

دیدگاه شما پس از تأیید مدیر نمایش داده می‌شود.