جلسهی 35: پروژه: فرم ثبتنام Project: The Sign-up Form
یک فرم ثبتنام واقعی برای باشگاه کدنویسی میسازی. کادرها را با نوعشان میگیری، برای هر عضو یک interface مینویسی، ورودی را با یک تابع بررسی میکنی که نتیجهی برچسبدار میدهد، و رویدادها را با نوع وصل میکنی.
در این جلسه یاد میگیری
- در پایان این جلسه میتوانی چیزهای یک صفحه را با نوع درستشان بگیری و از آنها بخوانی و در آنها بنویسی.
- در پایان این جلسه میتوانی دادهی یک فرم را در یک
interfaceبریزی. - در پایان این جلسه میتوانی تابعی بنویسی که نتیجهاش یک یونیون برچسبدار است: یا درست، یا خطا.
- در پایان این جلسه میتوانی رویدادهای صفحهکلید و نوشتن را با نوعشان به فرم وصل کنی.
درس
باشگاه کدنویسی یک فرم ثبتنام میخواهد: اسم، سن و دکمهی Join. قانون باشگاه: اسم نباید خالی باشد و سن باید بین ۸ تا ۱۸ باشد. در این پروژه هر چهار جلسهی این فاز کنار هم میآیند، بهعلاوهی چیزهایی از فازهای قبل: interface، یونیون برچسبدار و آرایهی نوعدار. این نقشهی کار است: هر بار که Join زده میشود، همین راه طی میشود.
کادرها را این بار با as میگیریم: document.getElementById("name") as HTMLInputElement. چرا as؟ چون این صفحه مالِ خودمان است و میدانیم این idها در آن هستند. این قولی است که میتوانیم سرش بمانیم، و دیگر لازم نیست در هر تابع null را بررسی کنیم. ولی مواظب باش: اگر یک id را غلط بنویسی، تایپاسکریپت چیزی نمیگوید و برنامه موقع اجرا میایستد.
قلب پروژه تابع validate است. یک Member میگیرد و یک Result برمیگرداند: یا { kind: "ok", member } یا { kind: "error", field, message }. این همان یونیون برچسبدارِ جلسهی ۱۹ است. فایدهاش: بعد از if (result.kind === "error") تایپاسکریپت میداند message هست، و بیرون از آن میداند member هست. دیگر نمیشود عضوی را که بررسی نشده به لیست اضافه کرد.
پروژه چهار قدم دارد و هر قدم روی کد قدم قبل ساخته میشود. بعد از هر قدم اجرا کن و خودت فرم را امتحان کن: اسم خالی، سن ۵، سن ۱۳. اگر خط قرمز دیدی، آرام بخوانش: کدام خط، چه چیزی لازم بود، چه چیزی دادهای. وقتی تمام شد، فرم را مالِ خودت کن: یک کادر دیگر (مثلاً شهر) اضافه کن و ببین تایپاسکریپت کجاها را نشانت میدهد که باید عوض شوند.
چالشها
- Step 1: The Fields (آسان)
- Step 2: The Member (متوسط)
- Step 3: The Check (سخت)
- Step 4: The Keys (سخت)