فصل ۱ — شروع TypeScript
TypeScript چیست و چرا به آن نیاز داریم؟ نصب TypeScript و اجرای اولین فایل tsconfig.json — تنظیمات سختگیرانه پروژهفصل ۲ — انواع داده (Types)
انواع پایه: string، number و boolean any، unknown، void و never — چهار نوع ویژهفصل ۳ — ساختارهای داده و توابع
آرایهها، تاپلها و پیمایش امن Union و Literal Types — «یا» در دنیای نوعها توابع: پارامتر، خروجی و پارامترهای اختیاریفصل ۴ — اینترفیس و کلاس
اینترفیس — قرارداد شکل آبجکتها کلاسها با access modifiers و implementsفصل ۵ — ابزارهای پیشرفته
ژنریکها — توابع و نوعهای پارامتری TypeScript و DOM — چک انواع در مرورگر کار با API: fetch، async و نوع پاسخپروژه عملی پایان دوره
پروژه پایانی ۱ — مدیریت کارها (Todo) تایپشده پروژه پایانی ۲ — داشبورد کاربران با داده واقعی APIپروژه پایانی ۱ — مدیریت کارها (Todo) تایپشده
پروژه پایانی اول: یک برنامه مدیریت کارها (Todo List) کامل با TypeScript خالص که همه مهارتهای دوره را به کار میگیرد: اینترفیس برای مدل داده، Literal Type برای وضعیت، ژنریک برای مخزن داده، کلاس برای منطق و DOM برای رابط کاربری.
راهحل قدمبهقدم پروژه
-
۱
هدف پروژه
ساخت برنامه Todo با امکان افزودن، تکمیل، حذف و فیلتر کارها؛ همه دادهها تایپشده و بدون any.
-
۲
الزامات و موارد موردنیاز
یک فایل HTML ساده با فیلد ورودی، دکمه افزودن و لیست کارها؛ TS strict فعال؛ بدون any و بدون @ts-ignore.
-
۳
قدم ۱ — مدل داده را اینترفیس کنید
اینترفیس Task با فیلدهای id، title، done بنویسید. وضعیت فیلتر را با Literal Type تعریف کنید: type Filter = 'all' | 'open' | 'done' — همین دو تعریف بقیه برنامه را امن میکند.
-
۴
قدم ۲ — مخزن داده ژنریک بسازید
کلاس Store<T> با آرایه private items: T[] و متدهای add، remove، getAll ژنریک تعریف کنید؛ بعد از آن Store<Task> بسازید. ژنریک اینجا یعنی مخزن برای هر داده دیگر هم قابل استفاده است.
-
۵
قدم ۳ — منطق افزودن و تکمیل
تابع addTask متن فیلد را trim و چک خالی کند؛ هر کار با id یکتا (Date.now یا شمارنده) و done:false ساخته شود. کلیک روی کار، وضعیت done را toggle کند.
-
۶
قدم ۴ — رندر لیست با DOM امن
تابع render(store) همه کارها را در ul بسازد؛ برای هر آیتم li بسازید، event listener کلیک بدهید و استایل خط خوردگی برای کارهای done بگذارید. همه querySelectorها را چک null کنید.
-
۷
قدم ۵ — فیلتر و ذخیرهسازی
سه دکمه فیلتر اضافه کنید که متغیر 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
کد را ویرایش کنید و «اجرای کد» را بزنید — خروجی واقعی مرورگر همینجا رندر میشود؛ مثل آزمایشگاه w3schools.
خروجی مورد انتظار
پس از اجرا: با تایپ «خرید نان» و دکمه افزودن، کار جدید در لیست ظاهر میشود. کلیک روی کار آن را تکمیل (خط خورده) میکند، دکمه حذف آن را پاک میکند و سه دکمه فیلتر همه/باز/انجامشده لیست را جابهجا میکنند.
چالش اضافه (اختیاری)
یک شمارنده «X کار باز از Y» بالای لیست اضافه کنید و داده را با تاریخ ساختهشدن هر کار مرتب کنید.
پرسش و پاسخ این درس (۰)
هنوز دیدگاهی ثبت نشده؛ اولین نفر باشید!