درس ۴۵ از ۵۰ · صفحه‌های وب

حالت، DOM و زمان‌سنج‌ها

درس‌های پیش رویدادها را تک‌تک نشان دادند. یک صفحه‌ی واقعی همه را کنار هم می‌گذارد: چیزی را به یاد می‌آورد، به کلیک یا کلید جواب می‌دهد و بعد آنچه خواننده می‌بیند را تازه می‌کند. این درس همین چرخه را با صفحه‌های کوچک و کامل یاد می‌دهد: شمارنده، فهرست کار، زبانه، کرنومتر، پرسش و پاسخ، و کمک‌تابع‌های دامی که هر کدام لازم دارند.

حالت در متغیرها نگه داشته می‌شود

صفحه‌ی تعاملی چرخه‌ای سه‌قدمی است: چیزی رخ می‌دهد، برنامه آنچه به یاد دارد را عوض می‌کند، و صفحه از روی آنچه برنامه به یاد دارد دوباره کشیده می‌شود. آنچه برنامه به یاد دارد حالت (state) آن است. در سلام حالت صفحه چند متغیر ناپایا در سطح بالاست، بالای بلوک صفحه:. رویدادگیرها آن‌ها را عوض می‌کنند و یک تابع، که معمولاً ترسیم یا نمایش نامش می‌گذارند، آن‌ها را در صفحه می‌نویسد.

web-dom-counter.salam
واردسازی دام

ناپایا شمار := 0

تابع ترسیم:
    نمایشگر := دام.با شناسه("value")
    دام.تنظیم متن(نمایشگر، "" + شمار)
    اگر شمار کوچکتر 0:
        دام.تنظیم سبک(نمایشگر، "color"، "#dc2626")
    وگرنه:
        دام.تنظیم سبک(نمایشگر، "color"، "#0f172a")
    پایان
پایان

تابع بیفزا:
    شمار++
    ترسیم()
پایان

تابع بکاه:
    شمار--
    ترسیم()
پایان

تابع صفرکن:
    شمار = 0
    ترسیم()
پایان

صفحه:
    عنوان = "شمارنده"
    قلم = "Tahoma"، سیستمی، ساده فضا = 1.5rem
    جعبه:
        بیشینه عرض = 16rem فضا = 0، خودکار فاصله = 20 تراز متن = وسط کادر = 1px، توپر، #e2e8f0 گردی = 14
        سرتیتر: شناسه = "value" اندازه = 1 محتوا = "0" اندازه قلم = 4rem فضا = 0، 0، 12px، 0 پایان
        دکمه: فاصله = 8px، 18px اشاره پس‌زمینه = #e0e7ff اندازه قلم = 1.1rem کادر = 1px، توپر، #cbd5e1 گردی = 8 پس‌زمینه = #f8fafc نشانگر = اشاره شناسه = "minus" کلیک = بکاه محتوا = "-1" جهت = "ltr" پایان
        دکمه: فاصله = 8px، 18px اشاره پس‌زمینه = #e0e7ff اندازه قلم = 1.1rem کادر = 1px، توپر، #cbd5e1 گردی = 8 پس‌زمینه = #f8fafc نشانگر = اشاره شناسه = "plus" کلیک = بیفزا محتوا = "+1" فضا = 0، 8px جهت = "ltr" پایان
        دکمه: فاصله = 8px، 18px اشاره پس‌زمینه = #e0e7ff اندازه قلم = 1.1rem کادر = 1px، توپر، #cbd5e1 گردی = 8 پس‌زمینه = #f8fafc نشانگر = اشاره شناسه = "zero" کلیک = صفرکن محتوا = "از نو" پایان
    پایان
پایان

ببینید نمونه چطور تقسیم شده است. شمار تنها جایی است که عدد را می‌داند. بکاه، بیفزا و صفرکن آن را عوض می‌کنند و ترسیم را صدا می‌زنند، و ترسیم تنها تابعی است که به صفحه دست می‌زند. وقتی چیزی روی صفحه اشتباه است می‌دانید کجا را نگاه کنید: یا حالت غلط است یا کشیدن. قرمز شدن عدد منفی هم قاعده‌ای درون ترسیم است، پس هر رویدادگیری که اجرا شده باشد این قاعده هر بار اعمال می‌شود.

کمک‌تابع‌ها از واردسازی دام می‌آیند و فهرست کاملشان در صفحه‌ی بسته‌ی دام است. این درس سمت صفحه را یاد می‌دهد: برای هر کار سراغ کدام کمک‌تابع بروید و اجزا چطور کنار هم می‌نشینند.

برنامه‌ی صفحه به ریشه (main) نیازی ندارد و هیچ‌کس آن را صدا نمی‌زند. اگر یکی بنویسید مترجم فقط آنچه را که ریشه صدا می‌زند به حساب می‌آورد و رویدادگیرهای شما «تابع بی‌استفاده» گزارش می‌شوند (خطای E066). کار را در رویدادگیرها بگذارید، و برای کدی که هنگام باز شدن صفحه باید اجرا شود بخش ذخیره‌سازی را ببینید.

پیدا کردن عنصرها، خواندن و نوشتن

برای عوض کردن یک عنصر اول باید به آن دسترسی داشته باشید. دام.با شناسه("value") (در انگلیسی dom.ById) عنصری را برمی‌گرداند که این شناسه را دارد، و مترجم شناسه را برایتان وارسی می‌کند: اگر هیچ عنصری در همان صفحه آن را نداشته باشد ساختن با خطای E138 متوقف می‌شود، پس اشتباه تایپی پیش از اجرای صفحه پیدا می‌شود.

E138: no element with id 'result2' in this file's layout

این وارسی فقط شناسه‌هایی را می‌بیند که به شکل متن ساده نوشته شده‌اند. شناسه‌ای که هنگام اجرا ساخته می‌شود، مثل دام.با شناسه("votes-" + نام)، وارسی نمی‌شود و اشتباهش به شکل خطا در کنسول مرورگر پیدا می‌شود. وقتی شناسه‌ای در کار نیست، دام.پرسمان(".note") نخستین عنصری را می‌دهد که با یک گزینشگر CSS جور است و دام.پرسمان همه("#books li") همه‌شان را به شکل فهرست. فهرست را با دام.تعداد(فهرست) و دام.عنصر شماره(فهرست، i) بخوانید، با شمارش از ۰.

با دسترسی به عنصر می‌توانید بخوانید و بنویسید. دام.تنظیم متن(عنصر، "...") و دام.دریافت متن(عنصر) با متن کار دارند و دام.تنظیم مقدار و دام.دریافت مقدار با آنچه در یک کادر نوشته شده است. شمارنده‌ی نویسه‌ی زیر با هر رویداد ورودی کادر را می‌خواند، تعداد و سهم از حد مجاز را نشان می‌دهد و تا وقتی یادداشت خالی یا از حد درازتر است دکمه را خاموش نگه می‌دارد.

web-dom-charcount.salam
واردسازی دام

پایا حد := 80

تابع بسنج:
    استفاده := دام.دریافت خاصیت عددی(دام.با شناسه("note")، "textLength") برگردان صحیح۶۴
    دام.تنظیم متن(دام.با شناسه("used")، "" + استفاده + " / " + حد)
    اگر استفاده بزرگتر حد:
        دام.تنظیم سبک(دام.با شناسه("used")، "color"، "#dc2626")
        دام.تنظیم سبک(دام.با شناسه("bar")، "width"، "100%")
        دام.تنظیم سبک(دام.با شناسه("bar")، "background"، "#dc2626")
    وگرنه:
        دام.تنظیم سبک(دام.با شناسه("used")، "color"، "#475569")
        دام.تنظیم سبک(دام.با شناسه("bar")، "width"، "" + استفاده * 100 / حد + "%")
        دام.تنظیم سبک(دام.با شناسه("bar")، "background"، "#4f46e5")
    پایان
    دام.تنظیم خاصیت منطقی(دام.با شناسه("post")، "disabled"، استفاده برابر 0 یا استفاده بزرگتر حد)
پایان

صفحه:
    عنوان = "شمارنده‌ی نویسه"
    قلم = "Tahoma"، سیستمی، ساده فضا = 1.5rem بیشینه عرض = 28rem
    متن بلند: شناسه = "note" ورودی = بسنج ردیف‌ها = 3 جانگهدار = "یادداشت کوتاهی بنویسید" عرض = 100% فاصله = 10 اندازه قلم = 1rem قلم = inherit گردی = 8 کادر = 1px، توپر، #cbd5e1 پایان
    جعبه: ارتفاع = 6 پس‌زمینه = #e2e8f0 گردی = 3 فضا = 6px، 0
        جعبه: شناسه = "bar" ارتفاع = 100% عرض = 0% پس‌زمینه = #4f46e5 گردی = 3 گذار = 0.15s پایان
    پایان
    جعبه: چیدمان = ردیف چینش = میان تراز = وسط
        تکه: شناسه = "used" محتوا = "0 / 80" رنگ = #475569 جهت = "ltr" پایان
        دکمه: شناسه = "post" غیرفعال = درست محتوا = "ارسال" فاصله = 6px، 16px پایان
    پایان
پایان

تعداد از دام.دریافت خاصیت عددی(کادر، "textLength") می‌آید، خاصیتی که مرورگر برای یک متن بلند نگه می‌دارد، و نه از نوشته.طول(). در مرورگر رشته‌ی سلام بایت‌های UTF-8 را می‌شمارد، پس کلمه‌ی سلام ۸ حساب می‌شد. دریافت خاصیت عددی، دریافت خاصیت رشته ای، دریافت خاصیت منطقی و دریافت خاصیت هر خاصیتی از عنصر را می‌خوانند، و راه رسیدن به هر چیزی‌اند که کمک‌تابع‌های دیگر پوشش نمی‌دهند.

پالایش زنده به حلقه روی عنصرها نیازی ندارد، چون فهرست از یک وکتور و متن جستجو کشیده می‌شود و ردیف‌هایی که جور هستند همان ردیف‌هایی‌اند که وجود دارند. رویدادگیر ورودی متن را در یک متغیر می‌نویسد. یک هر روی کتاب‌ها، با یک اگر درونش، فقط عنوان‌هایی را راه می‌دهد که آن متن را دارند، یک تابع کوچک آن‌ها را می‌شمارد، و وقتی شمار صفر است پیامی ظاهر می‌شود.

web-dom-filter.salam
تابع قفسه(): وکتور<رشته>:
    ناپایا کتاب‌ها := وکتور {} برگردان وکتور<رشته>
    کتاب‌ها.افزودن("شازده کوچولو")
    کتاب‌ها.افزودن("غرور و تعصب")
    کتاب‌ها.افزودن("هابیت")
    کتاب‌ها.افزودن("زنان کوچک")
    کتاب‌ها.افزودن("موبی دیک")
    کتاب‌ها.افزودن("آرزوهای بزرگ")
    برگشت کتاب‌ها
پایان

تابع مطابقت(عنوان: رشته، واژه: رشته): منطقی:
    برگشت عنوان.کوچک().دربردارد(واژه.کوچک())
پایان

تابع یافته(کتاب‌ها: وکتور<رشته>، واژه: رشته): صحیح:
    ناپایا شمار := 0
    تکرار کتاب‌ها.طول() در ک:
        اگر مطابقت(کتاب‌ها.بگیر(ک)، واژه):
            شمار++
        پایان
    پایان
    برگشت شمار
پایان

تابع کل(کتاب‌ها: وکتور<رشته>): صحیح:
    برگشت کتاب‌ها.طول()
پایان

بخش صافی:
    کتاب‌ها := قفسه() برگردان وکتور<رشته>
    جستار := ""
    جعبه:
        قلم = سیستمی، ساده
        فضا = 24
        بیشینه عرض = 416
        ورودی:
            شناسه = "q"
            نوع = جستجو
            عرض = پر
            فاصله = 10
            اندازه قلم = 16
            گردی = 8
            کادر = 1، توپر، #cbd5e1
            جانگهدار = "قفسه را بگردید"
            ورودی = (v: رشته): جستار = v پایان
        پایان
        پاراگراف: شناسه = "found" رنگ = #475569 فضا = 6، 0 محتوا = یافته(کتاب‌ها، جستار) + " از " + کل(کتاب‌ها) پایان
        فهرست:
            شناسه = "books"
            فاصله = 0
            هر عنوان در کتاب‌ها:
                اگر مطابقت(عنوان، جستار):
                    مورد: کلید = عنوان فاصله = 10، 12 فضا = 6، 0 پس‌زمینه = #f1f5f9 گردی = 8 محتوا = عنوان پایان
                پایان
            پایان
        پایان
        اگر یافته(کتاب‌ها، جستار) برابر 0:
            پاراگراف: شناسه = "none" رنگ = #b45309 محتوا = "هیچ کتابی در قفسه نمی‌خواند." پایان
        پایان
    پایان
پایان

صفحه:
    عنوان = "صافی"
    صافی: پایان
پایان

وقتی ردیف‌ها دستی ساخته شوند، فهرستی که پرسمان همه می‌دهد عکس لحظه‌ای است. ردیف‌هایی که بعداً اضافه شوند در آن نیستند، پس هر بار دوباره بپرسید.

راه دیگر نوشتن دام.تنظیم اچ تی ام ال(عنصر، "...") است. مرورگر رشته را به‌عنوان HTML می‌خواند، پس می‌توان یک تکه‌ی کامل را با یک فراخوانی ساخت، و دام.تنظیم اچ تی ام ال(عنصر، "") عنصر را خالی می‌کند. خطرش هم همین است. نامی که بازدیدکننده تایپ کرده و با تنظیم اچ تی ام ال گذاشته شود به‌عنوان HTML اجرا می‌شود، و نامی مثل <img src=x onerror=...> برنامه می‌شود. متنی که از بیرون آمده همیشه با تنظیم متن گذاشته می‌شود، که هر نویسه را همان‌طور که هست نشان می‌دهد:

تابع پژواک:
    دام.تنظیم متن(دام.با شناسه("shown")، دام.دریافت مقدار(دام.با شناسه("name")))
پایان

صفحه:
    ورودی: شناسه = "name" ورودی = پژواک جانگهدار = "نام شما" پایان
    پاراگراف: شناسه = "shown" پایان
پایان

عنصری که نیست با مقدار خالی یکی نیست. دام.با شناسه و دام.پرسمان برای عنصری که وجود ندارد null جاوااسکریپت را می‌دهند و به‌کار بردنش رویدادگیر را با خطا در کنسول متوقف می‌کند. وقتی ممکن است عنصر نباشد اول بپرسید: اگر دام.وجود دارد("banner"): دام.برداشتن(دام.با شناسه("banner")) پایان.

وضعیت، سبک و ویژگی

برای عوض کردن ظاهر یا رفتار یک عنصر سه ابزار هست و ترتیب ترجیح همین ترتیب زیر است. اول وضعیت: درون یک بخش متغیری با := بسازید، در رویدادگیر عوضش کنید و سبک مربوط به آن را در یک اگر درون خود عنصر بنویسید. صفحه می‌گوید هر وضعیت چه شکلی دارد، رویدادگیر فقط می‌گوید کدام وضعیت است، و این دو از هم جدا می‌مانند. کلید پوسته‌ی زیر یک متغیر دارد، شب، و همه‌ی رنگ‌های صفحه از آن پیروی می‌کنند.

web-dom-theme.salam
بخش پوسته:
    شب := نادرست
    جعبه:
        قلم = سیستمی، ساده
        فاصله = 24
        کمینه ارتفاع = 192
        پس‌زمینه = #f8fafc
        رنگ = #0f172a
        گذار = 300ms
        اگر شب:
            پس‌زمینه = #0f172a
            رنگ = #e2e8f0
        پایان
        جعبه:
            بیشینه عرض = 416
            فاصله = 20
            پس‌زمینه = سفید
            کادر = 1، توپر، #e2e8f0
            گردی = 14
            اگر شب:
                پس‌زمینه = #1e293b
                کادر = 1، توپر، #334155
            پایان
            سرتیتر: اندازه = 2 محتوا = "عصر بخیر" فضا = 0، 0، 8، 0 پایان
            پاراگراف: محتوا = "یک متغیر وضعیت همه‌ی رنگ‌های صفحه را عوض می‌کند." پایان
            دکمه:
                شناسه = "flip"
                فاصله = 8، 16
                گردی = 8
                کادر = 1، توپر، #6366f1
                پس‌زمینه = #6366f1
                رنگ = سفید
                نشانگر = اشاره
                کلیک = (): شب = شب برابر نادرست پایان
                محتوا = شب ? "پوسته‌ی روز" : "پوسته‌ی شب"
            پایان
        پایان
    پایان
پایان

صفحه:
    عنوان = "پوسته"
    پوسته: پایان
پایان

دوم سبک‌ها: دام.تنظیم سبک(عنصر، "width"، "40%") یک ویژگی CSS را روی یک عنصر می‌گذارد، با نام CSS آن (background-color، نه backgroundColor)، و مقدار خالی آن را برمی‌دارد. برای مقداری مناسب است که هنگام اجرا حساب می‌کنید، مثل پهنای نوار در شمارنده‌ی نویسه. دام.دریافت سبک(عنصر، "display") مقداری را می‌دهد که مرورگر همین حالا به کار می‌برد، مثلاً none برای عنصر پنهان.

سوم ویژگی‌ها: دام.تنظیم ویژگی(عنصر، "aria-expanded"، "true") و دام.دریافت ویژگی(عنصر، "aria-expanded") ویژگی‌های HTML را به شکل متن می‌خوانند و می‌نویسند. بیشتر برای ویژگی‌های دسترس‌پذیری مهم‌اند، چون صفحه‌خوان aria-expanded را می‌خواند و به سبک کاری ندارد. در یک بخش ویژگی را از همان متغیر می‌نویسید: این آکاردئون هر دو را هم‌گام نگه می‌دارد، چون باز هم بخش را نشان یا پنهان می‌کند و هم aria expanded را تنظیم می‌کند.

web-dom-accordion.salam
بخش تکه(نام: رشته، سرخط: رشته):
    باز := نادرست
    جعبه:
        کادر = 1، توپر، #e2e8f0
        گردی = 10
        سرریز = پنهان
        فضا = 0، 0، 8، 0
        دکمه:
            شناسه = "h-" + نام
            عرض = پر
            تراز متن = ابتدا
            فاصله = 12، 14
            اندازه قلم = 16
            وزن قلم = 400
            کادر = 0
            پس‌زمینه = #f1f5f9
            نشانگر = اشاره
            اشاره:
                پس‌زمینه = #e0e7ff
            پایان
            اگر باز:
                وزن قلم = 700
            پایان
            aria expanded = باز ? "true" : "false"
            کلیک = (): باز = باز برابر نادرست پایان
            محتوا = سرخط
        پایان
        اگر باز:
            جعبه:
                فاصله = 0، 14، 12، 14
                محتوا: پایان
            پایان
        پایان
    پایان
پایان

صفحه:
    عنوان = "آکاردئون"
    جعبه:
        قلم = سیستمی، ساده
        فضا = 24
        بیشینه عرض = 480
        تکه: نام = "ship" سرخط = "ارسال چقدر طول می‌کشد؟"
            پاراگراف: محتوا = "دو تا چهار روز کاری داخل کشور." پایان
        پایان
        تکه: نام = "back" سرخط = "آیا می‌توانم کالا را پس بدهم؟"
            پاراگراف: محتوا = "بله، تا سی روز، اگر استفاده نشده باشد." پایان
        پایان
        تکه: نام = "pay" سرخط = "کدام روش‌های پرداخت را می‌پذیرید؟"
            پاراگراف: محتوا = "کارت و حواله بانکی." پایان
        پایان
    پایان
پایان

آکاردئون یک بخش (component) است و هر تکه باز خودش را نگه می‌دارد. بخش مربوط به استفاده‌ی دوباره به این برمی‌گردد. مرورگر برای همین کار عنصر details را هم دارد، بدون هیچ اسکریپتی (درس ساختار صفحه را ببینید). آکاردئون اینجاست چون وضعیت، سبک و ویژگی را کنار هم نشان می‌دهد.

بعضی چیزها ویژگی نیستند و خاصیت عنصرند: checked، disabled، value. ویژگی فقط مقدار آغازین را می‌دهد و خاصیت مقدار زنده است. اینها را با دام.دریافت خاصیت منطقی و دام.تنظیم خاصیت منطقی بخوانید و بنویسید:

تابع موافقت:
    زده := دام.دریافت خاصیت منطقی(دام.با شناسه("agree")، "checked")
    دام.تنظیم خاصیت منطقی(دام.با شناسه("join")، "disabled"، وارونه زده)
پایان

صفحه:
    ورودی: شناسه = "agree" نوع = تیک تغییر = موافقت پایان
    برچسب: برای = "agree" محتوا = "قوانین را می‌پذیرم" پایان
    دکمه: شناسه = "join" غیرفعال = درست محتوا = "عضویت" پایان
پایان

زبانه‌ها وضعیت و ویژگی را با هم به کار می‌برند. یک متغیر، انتخاب، می‌گوید کدام زبانه برگزیده است. هر زبانه از آن یک پرچم می‌گیرد، با یک اگر خودش را سبک می‌دهد و aria selected را می‌نویسد، و یک زنجیره‌ی اگر برگه‌ی مربوط را نشان می‌دهد.

web-dom-tabs.salam
بخش زبانه(برچسب: رشته، فعال: منطقی، برگزین):
    دکمه:
        فاصله = 10، 18
        کادر پایین = 3، توپر، شفاف
        پس‌زمینه = سفید
        اندازه قلم = 16
        وزن قلم = 400
        نشانگر = اشاره
        اشاره:
            پس‌زمینه = #f1f5f9
        پایان
        اگر فعال:
            کادر پایین = 3، توپر، #4f46e5
            وزن قلم = 700
        پایان
        aria selected = فعال ? "true" : "false"
        کلیک = برگزین
        محتوا = برچسب
    پایان
پایان

بخش زبانه‌ها:
    انتخاب := ۰
    جعبه:
        قلم = سیستمی، ساده
        فضا = 24
        بیشینه عرض = 512
        جعبه:
            چیدمان = ردیف
            نقش = tablist
            کادر پایین = 1، توپر، #e2e8f0
            زبانه: برچسب = "نمای کلی" فعال = (انتخاب برابر ۰) برگزین = (): انتخاب = ۰ پایان پایان
            زبانه: برچسب = "دستور" فعال = (انتخاب برابر ۱) برگزین = (): انتخاب = ۱ پایان پایان
            زبانه: برچسب = "نظرها" فعال = (انتخاب برابر ۲) برگزین = (): انتخاب = ۲ پایان پایان
        پایان
        اگر انتخاب برابر ۰:
            جعبه: فاصله = 14، 4 محتوا = "نانی تخت که روی سنگ داغ در حدود چهار دقیقه پخته می‌شود." پایان
        وگرنه اگر انتخاب برابر ۱:
            جعبه: فاصله = 14، 4 محتوا = "آرد، آب، نمک و یک قاشق مخمر. خمیر را یک ساعت بگذارید بماند." پایان
        وگرنه:
            جعبه: فاصله = 14، 4 محتوا = "چهار و نیم ستاره از ۲۱۲ خواننده." پایان
        پایان
    پایان
پایان

صفحه:
    عنوان = "زبانه‌ها"
    زبانه‌ها: پایان
پایان

وقتی دو چیز باید با هم عوض شوند، هر دو را از یک متغیر بسازید، همان‌طور که زبانه‌ها و برگه می‌کنند. اگر دکمه‌ی زبانه‌ها و برگه‌ها در دو جای جدا تازه می‌شدند، دیر یا زود یکی‌شان فراموش می‌شد.

ساختن و برداشتن عنصر

صفحه اغلب باید رشد کند: سطر تازه‌ای در یک فهرست، پیام تازه‌ای. در یک بخش خودتان عنصر نمی‌سازید: فهرست یک وکتور است، موارد.افزودن(متن) کاری اضافه می‌کند و هر روی موارد ردیفش را می‌کشد، و برداشتن کار از وکتور ردیف را هم می‌برد. فهرست کار زیر هر دو را انجام می‌دهد.

web-dom-todo.salam
واردسازی دام

تابع شمار(موارد: وکتور<رشته>): صحیح:
    برگشت موارد.طول()
پایان

تابع بدون(فهرست: وکتور<رشته>، کدام: رشته): وکتور<رشته>:
    ناپایا نتیجه := وکتور {} برگردان وکتور<رشته>
    ناپایا دیده := نادرست
    تکرار فهرست.طول() در ک:
        خط := فهرست.بگیر(ک)
        اگر وارونه دیده و خط برابر کدام:
            دیده = درست
        وگرنه:
            نتیجه.افزودن(خط)
        پایان
    پایان
    برگشت نتیجه
پایان

بخش وظیفه(برچسب: رشته، انجام):
    نگه‌داشته := برچسب
    جعبه:
        چیدمان = ردیف
        چینش = میان
        تراز = وسط
        فاصله = 8، 12
        فضا = 6، 0
        پس‌زمینه = #f1f5f9
        گردی = 8
        پاراگراف: فضا = 0 محتوا = برچسب پایان
        دکمه:
            کادر = 0
            پس‌زمینه = #e0e7ff
            گردی = 6
            فاصله = 4، 10
            نشانگر = اشاره
            کلیک = (): انجام(نگه‌داشته) پایان
            محتوا = "انجام شد"
        پایان
    پایان
پایان

بخش کارنامه:
    موارد := وکتور {} برگردان وکتور<رشته>
    پیش‌نویس := ""
    جعبه:
        قلم = سیستمی، ساده
        فضا = 24
        بیشینه عرض = 416
        فرم:
            شناسه = "new"
            چیدمان = ردیف
            شکاف = 8
            ارسال = (e: صحیح۶۴):
                دام.جلوگیری پیش فرض(e)
                اگر پیش‌نویس.طول() بزرگتر 0:
                    موارد.افزودن("" + پیش‌نویس)
                    پیش‌نویس = ""
                پایان
            پایان
            ورودی:
                شناسه = "name"
                رشد = 1
                فاصله = 8
                اندازه قلم = 16
                مقدار = پیش‌نویس
                جانگهدار = "چه باید کرد؟"
                ورودی = (v: رشته): پیش‌نویس = v پایان
            پایان
            دکمه: شناسه = "add" نوع = ارسال فاصله = 8، 16 کادر = 0 پس‌زمینه = #4f46e5 رنگ = سفید گردی = 8 نشانگر = اشاره محتوا = "افزودن" پایان
        پایان
        فهرست:
            فاصله = 0
            هر کار در موارد:
                مورد:
                    کلید = کار
                    وظیفه: برچسب = کار
                        انجام = (کدام: رشته): موارد = بدون(موارد، کدام) پایان
                    پایان
                پایان
            پایان
        پایان
        پاراگراف: شناسه = "left" رنگ = #475569 محتوا = شمار(موارد) + " کار مانده" پایان
    پایان
پایان

صفحه:
    عنوان = "کارها"
    کارنامه: پایان
پایان

رویدادگیر ارسال را اول بخوانید. متن را بررسی می‌کند، آن را به موارد می‌افزاید و کادر را خالی می‌کند، و همین: هر روی موارد ردیف را می‌کشد. شمار هم متغیر نیست: شمار تابعی از موارد است، پس هیچ‌وقت با ردیف‌ها ناهمخوان نمی‌شود.

هر ردیف یک بخش کوچک با دکمه‌ی «انجام شد» خودش است. ردیف نمی‌تواند فهرستی را که جزئش است عوض کند، پس صفحه تابعی به آن می‌دهد، انجام، و ردیف آن را با متن خودش صدا می‌زند. تابع کار را در موارد پیدا می‌کند و برمی‌دارد، و ردیف هم می‌رود. دام.بساز، دام.افزودن و دام.حذف هنوز هستند، برای عنصری که هیچ بخشی نمی‌تواند بسازد، و دام.هنگام رویداد(عنصر، "click"، رویدادگیر) به عنصری که این‌طور ساخته شده رویدادگیر می‌دهد؛ وقتی رویدادگیر باید خود رویداد را ببیند از دام.هنگام رویداد جزئی و لامبدایی با پارامتر صحیح۶۴ استفاده کنید، مثل (e: صحیح۶۴): سلام(e) پایان.

شکل نمونه هم اهمیت دارد. کادر و دکمه در یک فرم با رویدادگیر ارسال هستند، پس کلید Enter هم مثل دکمه کاری را اضافه می‌کند، بی‌آنکه کنترل کلید نوشته شود. رویدادگیر دام.جلوگیری پیش فرض(e) را صدا می‌زند، چون وگرنه مرورگر فرم را می‌فرستد و صفحه را از نو بار می‌کند.

متن کاربر به‌عنوان محتوای ردیف وارد می‌شود و همیشه به شکل متن نشان داده می‌شود. اگر عنصری را دستی بسازید، متن را با دام.تنظیم متن بگذارید و هرگز با تنظیم اچ تی ام ال، به دلیلی که پیش‌تر گفته شد.

رویداد چه چیزی می‌گوید

رویدادگیری که با پارامتر صحیح۶۴ نوشته شده خود رویداد را می‌گیرد و چند کمک‌تابع آن را می‌خوانند. دام.هدف رویداد(رویداد) عنصری است که زده شد، دام.رویداد افقی و دام.رویداد عمودی مکان اشاره‌گر، دام.کلید رویداد کلید، دام.جلوگیری پیش فرض کاری را که مرورگر بعد می‌کرد لغو می‌کند و دام.توقف انتشار رویداد را از رسیدن به عنصرهای بالاتر باز می‌دارد. هر کدام درس خودشان را دارند: رویدادهای ماوس، صفحه‌کلید و فرم، کشیدن و رها کردن و لمس و رسانه و بقیه.

هدف رویداد چیزی است که اجازه می‌دهد یک رویدادگیر به چند عنصر خدمت کند، عنصرهایی که وضعیت خودشان را ندارند، مثلاً ردیف‌هایی که با دام.ساختن ساخته شده‌اند. وقتی هر عنصر می‌تواند یک بخش باشد، وضعیت خودش را به آن بدهید، همان‌طور که انتخاب‌گر صندلی زیر می‌کند: هشت صندلی که هر کدام گرفته خودشان را دارند و تابعی که صفحه پایین می‌دهد تا هر صندلی بگوید گرفته شد یا رها شد. صفحه جواب‌ها را جمع می‌زند.

web-dom-seats.salam
بخش صندلی(تغییر):
    گرفته := نادرست
    دکمه:
        عرض = 44
        ارتفاع = 44
        کادر = 2، توپر، #94a3b8
        گردی = 8، 8، 14، 14
        پس‌زمینه = سفید
        نشانگر = اشاره
        اشاره:
            کادر = 2، توپر، #4f46e5
        پایان
        اگر گرفته:
            پس‌زمینه = #4f46e5
            کادر = 2، توپر، #4f46e5
        پایان
        aria label = "صندلی"
        کلیک = ():
            گرفته = گرفته برابر نادرست
            تغییر(گرفته ? ۱ : -۱)
        پایان
    پایان
پایان

بخش صندلی‌ها:
    برگزیده := ۰
    جعبه:
        قلم = سیستمی، ساده
        فضا = 24
        جعبه:
            چیدمان = شبکه
            columns = 44، 44، 44، 44
            شکاف = 10
            صندلی: تغییر = (d: صحیح): برگزیده += d پایان پایان
            صندلی: تغییر = (d: صحیح): برگزیده += d پایان پایان
            صندلی: تغییر = (d: صحیح): برگزیده += d پایان پایان
            صندلی: تغییر = (d: صحیح): برگزیده += d پایان پایان
            صندلی: تغییر = (d: صحیح): برگزیده += d پایان پایان
            صندلی: تغییر = (d: صحیح): برگزیده += d پایان پایان
            صندلی: تغییر = (d: صحیح): برگزیده += d پایان پایان
            صندلی: تغییر = (d: صحیح): برگزیده += d پایان پایان
        پایان
        پاراگراف: شناسه = "summary" رنگ = #475569 محتوا = برگزیده + " صندلی از ۸ صندلی انتخاب شد" پایان
    پایان
پایان

صفحه:
    عنوان = "صندلی‌ها"
    صندلی‌ها: پایان
پایان

زمان‌سنج‌ها و فریم‌ها

سه کمک‌تابع تابعی را بعداً اجرا می‌کنند. دام.تنظیم مهلت(تابع، میلی‌ثانیه) یک بار پس از آن مدت اجرایش می‌کند. دام.تنظیم بازه(تابع، میلی‌ثانیه) بارها و بارها. هر دو عددی برمی‌گردانند و دام.پاک کردن مهلت(شماره) و دام.پاک کردن بازه(شماره) زمان‌سنجی را که آن شماره را دارد لغو می‌کنند. شماره را در یک متغیر سطح بالا نگه دارید که به شکل ناپایا شماره := 0 برگردان صحیح۶۴ نوشته شده، چون زمان‌سنجی که نتوانید لغوش کنید تا وقتی صفحه باز است کار می‌کند. این کمک‌تابع‌ها تابعی بی‌پارامتر می‌گیرند، پس یک لامبدا بدهید: (): تیک() پایان.

کرنومتر با فشردن «شروع» یک بازه‌ی ۱۰۰ میلی‌ثانیه‌ای راه می‌اندازد، با هر ضربه یک دهم ثانیه می‌افزاید و با فشردن «توقف» بازه را پاک می‌کند. پیام موقت همین کار را با مهلت می‌کند: پیامی نشان می‌دهد، و کلیک دوم اول مهلتی را که در انتظار بود لغو می‌کند تا پیام از آخرین کلیک دو ثانیه‌ی کامل بماند.

web-dom-stopwatch.salam
واردسازی دام

ناپایا دهم := 0
ناپایا ضربان := 0 برگردان صحیح۶۴
ناپایا روشن := نادرست

تابع ترسیم:
    دام.تنظیم متن(دام.با شناسه("time")، "" + دهم / 600 + ":" + دهم / 10 % 60 / 10 + دهم / 10 % 60 % 10 + "." + دهم % 10)
پایان

تابع تیک:
    دهم++
    ترسیم()
پایان

تابع آغازوپایان:
    اگر روشن:
        دام.پاک کردن بازه(ضربان)
        روشن = نادرست
        دام.تنظیم متن(دام.با شناسه("go")، "شروع")
    وگرنه:
        ضربان = دام.تنظیم بازه((): تیک() پایان، 100)
        روشن = درست
        دام.تنظیم متن(دام.با شناسه("go")، "توقف")
    پایان
پایان

تابع صفرکن:
    دهم = 0
    ترسیم()
پایان

صفحه:
    عنوان = "کرنومتر"
    قلم = "Tahoma"، سیستمی، ساده فضا = 1.5rem
    جعبه:
        بیشینه عرض = 16rem فضا = 0، خودکار فاصله = 20 تراز متن = وسط کادر = 1px، توپر، #e2e8f0 گردی = 14
        پاراگراف: شناسه = "time" محتوا = "0:00.0" اندازه قلم = 3rem قلم = "ui-monospace"، تک‌فاصله فضا = 0، 0، 12px، 0 جهت = "ltr" پایان
        دکمه: فاصله = 8px، 20px اندازه قلم = 1.05rem کادر = 1px، توپر، #cbd5e1 گردی = 8 پس‌زمینه = #f8fafc نشانگر = اشاره شناسه = "go" کلیک = آغازوپایان محتوا = "شروع" پایان
        دکمه: فاصله = 8px، 20px اندازه قلم = 1.05rem کادر = 1px، توپر، #cbd5e1 گردی = 8 پس‌زمینه = #f8fafc نشانگر = اشاره شناسه = "clear" کلیک = صفرکن محتوا = "از نو" فضا = 0، 8px، 0، 0 پایان
    پایان
پایان
web-dom-toast.salam
واردسازی دام

ناپایا منتظر := 0 برگردان صحیح۶۴

بخش پیام موقت:
    نمایان := نادرست
    جعبه:
        قلم = سیستمی، ساده
        فضا = 24
        دکمه:
            شناسه = "copy"
            فاصله = 10، 20
            اندازه قلم = 16
            گردی = 8
            کادر = 1، توپر، #4f46e5
            پس‌زمینه = #4f46e5
            رنگ = سفید
            نشانگر = اشاره
            کلیک = ():
                دام.پاک کردن مهلت(منتظر)
                نمایان = درست
                منتظر = دام.تنظیم مهلت((): نمایان = نادرست پایان، 2000)
            پایان
            محتوا = "کپی پیوند"
        پایان
        جعبه:
            شناسه = "toast"
            نقش = status
            فضا = 14، 0، 0، 0
            فاصله = 10، 14
            پس‌زمینه = #0f172a
            رنگ = سفید
            گردی = 8
            بیشینه عرض = 320
            شفافیت = 0
            جابه‌جایی = 0، 8
            تعاملی = نادرست
            گذار = 250ms
            اگر نمایان:
                شفافیت = 1
                جابه‌جایی = 0، 0
            پایان
            محتوا = "پیوند کپی شد. این پیام تا دو ثانیه‌ی دیگر محو می‌شود."
        پایان
    پایان
پایان

صفحه:
    عنوان = "پیام موقت"
    پیام موقت: پایان
پایان

مرورگر قول نمی‌دهد بازه دقیق باشد. می‌تواند دیر اجرا شود، و زبانه‌ای که در پس‌زمینه است خیلی کمتر اجرایش می‌کند. کرنومتر ضربه‌ها را می‌شمارد، که ساده است و برای نشان دادن ایده کافی. برای ساعتی که باید درست باشد، شروع را با دام.اکنون() (میلی‌ثانیه از بازشدن صفحه) به یاد بسپارید و در هر ضربه تفاوت را نشان دهید.

برای حرکت از دام.درخواست فریم(تابع) استفاده کنید. تابع را یک بار، درست پیش از آنکه مرورگر تصویر بعدی را بکشد، اجرا می‌کند و زمان را به میلی‌ثانیه می‌دهد. برای ادامه، تابع خودش فریم بعدی را می‌خواهد. این از بازه روان‌تر است، چون صفحه‌نمایش را دنبال می‌کند. توپ زیر از روی زمان گذشته جا می‌گیرد و نه با افزودن گامی ثابت، پس روی صفحه‌ی کند و صفحه‌ی تند زمان یکسانی می‌برد.

web-dom-slide.salam
واردسازی دام

ناپایا آغاز := 0.0

تابع بلغز(زمان: اعشار۶۴):
    ناپایا چپ := (زمان - آغاز) / 4.0
    اگر چپ کوچکتر 240.0:
        دام.درخواست فریم((بعدی: اعشار۶۴): بلغز(بعدی) پایان)
    وگرنه:
        چپ = 240.0
    پایان
    دام.تنظیم سبک(دام.با شناسه("ball")، "left"، "" + چپ + "px")
پایان

تابع پرتاب:
    آغاز = دام.اکنون()
    دام.درخواست فریم((زمان: اعشار۶۴): بلغز(زمان) پایان)
پایان

صفحه:
    عنوان = "لغزش"
    قلم = "Tahoma"، سیستمی، ساده فضا = 1.5rem
    جعبه: عرض = 280 ارتفاع = 44 پس‌زمینه = #e0e7ff گردی = 22 جهت = "ltr"
        جعبه: شناسه = "ball" موقعیت = مطلق بالا = 4 چپ = 0 عرض = 36 ارتفاع = 36 پس‌زمینه = #4f46e5 گردی = 50% پایان
    پایان
    دکمه: شناسه = "go" کلیک = پرتاب محتوا = "بلغزان" فضا = 14px، 0، 0، 0 فاصله = 8px، 18px کادر = 0 پس‌زمینه = #4f46e5 رنگ = سفید گردی = 8 نشانگر = اشاره قلم = inherit پایان
پایان

اگر حلقه‌ای می‌خواهید که هرگز نایستد، مثل یک بازی، دام.چرخش فریم فریم‌خواستن را خودش انجام می‌دهد. اما اول درس گذار و پویانمایی را ببینید: وقتی CSS می‌تواند حرکت را انجام دهد، بگذارید او انجام دهد.

به یاد سپردن پس از بستن صفحه

متغیرها با بسته شدن صفحه از بین می‌روند. دام.تنظیم متن ذخیره("note"، نوشته) رشته‌ای را در localStorage مرورگر نگه می‌دارد، دام.دریافت متن ذخیره("note") آن را پس می‌دهد (رشته‌ی خالی وقتی چیزی ذخیره نشده)، و تنظیم عدد ذخیره و دریافت عدد ذخیره همین کار را برای عدد صحیح می‌کنند. داده روی دستگاه خواننده و فقط برای همان سایت می‌ماند تا پاک شود. هرگز رمز یا چیز خصوصی آنجا نگذارید، و آنچه را پس می‌خوانید باور نکنید: فقط یک راحتی است و بازدیدکننده می‌تواند آن را عوض کند.

ممکن است ذخیره‌سازی در دسترس نباشد. پنجره‌ی خصوصی، تنظیم بسته یا یک قاب توکار مثل پیش‌نمایش زیر می‌تواند ردش کند. کمک‌تابع‌ها در این حالت صفحه را متوقف نمی‌کنند: نوشتن رها می‌شود و خواندن رشته‌ی خالی می‌دهد، و در کنسول هشداری می‌آید. کد شما باید باز هم درست رفتار کند. این یادداشت با تایپ ذخیره می‌کند و مقدار را پس می‌خواند تا بفهمد ذخیره شده یا نه، و اگر مرورگر نگه نداشت به خواننده می‌گوید. دکمه را بزنید، یا در یک صفحه‌ی واقعی بار دیگر بازش کنید، تا یادداشت ذخیره‌شده بارگذاری شود.

web-dom-notes.salam
واردسازی دام

تابع ذخیره:
    نوشته := دام.دریافت مقدار(دام.با شناسه("text"))
    دام.تنظیم متن ذخیره("note"، نوشته)
    اگر دام.دریافت متن ذخیره("note") برابر نوشته:
        دام.تنظیم متن(دام.با شناسه("state")، "روی این دستگاه ذخیره شد.")
    وگرنه:
        دام.تنظیم متن(دام.با شناسه("state")، "این مرورگر آن را نگه نمی‌دارد.")
    پایان
پایان

تابع بارگذاری:
    ذخیره‌شده := دام.دریافت متن ذخیره("note")
    اگر ذخیره‌شده.طول() > 0:
        دام.تنظیم مقدار(دام.با شناسه("text")، ذخیره‌شده)
        دام.تنظیم متن(دام.با شناسه("state")، "یادداشت ذخیره‌شده‌ی شما بارگذاری شد.")
    وگرنه:
        دام.تنظیم متن(دام.با شناسه("state")، "هنوز چیزی ذخیره نشده است.")
    پایان
پایان

صفحه:
    عنوان = "یادداشت"
    قلم = "Tahoma"، سیستمی، ساده فضا = 1.5rem بیشینه عرض = 28rem
    متن بلند: شناسه = "text" ورودی = ذخیره ردیف‌ها = 4 جانگهدار = "یادداشت شما" عرض = 100% فاصله = 10 اندازه قلم = 1rem قلم = inherit گردی = 8 کادر = 1px، توپر، #cbd5e1 پایان
    جعبه: چیدمان = ردیف چینش = میان تراز = وسط فضا = 6px، 0
        تکه: شناسه = "state" محتوا = "هنوز چیزی ذخیره نشده است." رنگ = #475569 پایان
        دکمه: شناسه = "again" کلیک = بارگذاری محتوا = "بارگذاری یادداشت" فاصله = 6px، 14px پایان
    پایان
    اسکریپت سفارشی: محتوا = "window.addEventListener('DOMContentLoaded', function () { بارگذاری(); });" پایان
پایان

آخرین خط صفحه یک عنصر script (اسکریپت سفارشی) کوچک است. بلوک صفحه: قلاب شروعی ندارد، پس این خط از مرورگر می‌خواهد پس از خواندن صفحه بارگذاری را یک بار اجرا کند. می‌تواند نام تابع را بنویسد چون تابعی که رویدادگیر است (اینجا کلیک دکمه) جایی هم گذاشته می‌شود که مرورگر پیدایش کند. بی‌این خط، صفحه یادداشت را فقط با زدن دکمه بارگذاری می‌کرد.

هشدار، پرسش و درخواست ورودی

سه کمک‌تابع از پنجره‌های خود مرورگر استفاده می‌کنند: دام.هشدار(پیام) پیامی نشان می‌دهد، دام.تایید(پرسش) درست یا نادرست می‌دهد، و دام.درخواست ورودی(پرسش) متنی را که خواننده نوشته می‌دهد، یا رشته‌ی خالی اگر منصرف شد.

تابع بزدای:
    اگر دام.تایید("همه‌ی یادداشت‌ها پاک شوند؟"):
        دام.تنظیم متن(دام.با شناسه("notes")، "")
    پایان
پایان

صفحه:
    پاراگراف: شناسه = "notes" محتوا = "سه یادداشت" پایان
    دکمه: کلیک = بزدای محتوا = "پاک کردن همه" پایان
پایان

نوشتنشان آسان است و با آن‌ها زندگی کردن سخت. تا وقتی خواننده جواب ندهد صفحه می‌ایستد، نمی‌شود سبکشان داد، مرورگر ممکن است پیشنهاد بستنشان را بدهد، و صفحه‌ای که درون صفحه‌ی دیگری قرار گرفته اغلب اجازه‌ی نشان دادنشان را ندارد، که در این صورت تایید بی‌صدا نادرست جواب می‌دهد. برای آزمودن اولیه‌ی یک ایده به کار ببریدشان، و در صفحه‌ی نهایی از عنصر dialog (ساختار صفحه) یا پیامی درون صفحه، مثل پیام موقت بالا، استفاده کنید.

بخش‌ها، تکرار و رویدادگیرها

بخش (component) تکه‌ای از صفحه است که چند بار می‌توانید به کارش ببرید و رویدادگیرهایش می‌توانند از پارامترهای بخش استفاده کنند. در نظرسنجی زیر لامبدای درون گزینه تابع رای(نام) را با نامی که نسخه‌ی خودش با آن ساخته شده صدا می‌زند، و شمارنده شناسه‌ای دارد که از همین نام ساخته شده، پس هر نسخه رأی‌های خودش را می‌شمارد.

web-dom-poll.salam
واردسازی دام

تابع رای(نام: رشته):
    جمع := دام.با شناسه("votes-" + نام)
    دام.تنظیم متن(جمع، "" + (دام.دریافت متن(جمع).به صحیح() + 1))
پایان

بخش گزینه(نام):
    جعبه:
        کلاس = "choice" چیدمان = ردیف چینش = میان تراز = وسط فاصله = 8px، 12px فضا = 0، 0، 8px، 0 پس‌زمینه = #f1f5f9 گردی = 10
        دکمه: فاصله = 6px، 14px کادر = 1px، توپر، #6366f1 گردی = 8 پس‌زمینه = سفید رنگ = #4338ca نشانگر = اشاره قلم = inherit کلیک = (): رای(نام) پایان محتوا = "رأی به " + نام پایان
        تکه: اندازه قلم = 1.4rem وزن قلم = پررنگ رنگ = #0f172a شناسه = "votes-" + نام محتوا = "0" پایان
    پایان
پایان

صفحه:
    عنوان = "نظرسنجی"
    قلم = "Tahoma"، سیستمی، ساده فضا = 1.5rem بیشینه عرض = 26rem
    سرتیتر: اندازه = 2 محتوا = "نوشیدنی مورد علاقه‌ی شما؟" فضا = 0، 0، 12px، 0 پایان
    گزینه: نام = "چای" پایان
    گزینه: نام = "قهوه" پایان
    گزینه: نام = "آبمیوه" پایان
پایان

دو محدودیت را باید دانست. لامبدا در ویژگی صفحه پارامتر رویداد ندارد، پس وقتی رویدادگیر رویداد لازم دارد تابعی با نام بنویسید که پارامتر داشته باشد، همان‌طور که انتخاب‌گر صندلی می‌کند. و صفحه‌ی ساده ثابت است: تکرار = 8 هشت نسخه‌ی یکسان می‌سازد، اما هر (each) و اگر به مقدارهای زمان اجرا نیاز دارند و فقط در صفحه‌ای با پارامتر که سرور پرش می‌کند، درون بخشی که متغیر نگه می‌دارد، یا وقتی متغیری ناپایا را می‌خوانند کار می‌کنند (وگرنه خطای E133). آن نوع صفحه در نخستین درس این بخش آمده است، و شناسه‌هایش در هر نسخه باید فرق کنند، پس آنجا از کلاس یا هدف رویداد استفاده کنید.

بخش‌هایی که به یاد می‌سپارند: متغیر و وضعیت

نظرسنجی بالا شمارش‌هایش را در خود صفحه نگه می‌دارد و با دام دوباره می‌خواند. یک بخش می‌تواند به جای آن مقداری از آن خودش نگه دارد: خط رای ها := ۰ در آغاز بدنه‌اش به هر نسخه رای ها ی خودش را می‌دهد. کلیدواژه‌ای در کار نیست. مترجم می‌بیند هر متغیر چگونه به کار رفته و خودش تصمیم می‌گیرد چیست:

  • متغیری که کدی عوضش می‌کند (مقداردهی، ++، روشی مانند بیفزا، یک رویدادگیر، یک تابع بازخوان) را هر نسخه برای خودش نگه می‌دارد: یک بار، هنگام ساخته شدن نسخه، از مقدارش آغاز می‌شود و آنچه رویدادگیرها با آن کرده‌اند می‌ماند.
  • اگر نمایه هم آن را نشان دهد (در یک ویژگی، یک متن، یک اگر یا هر، یا مقداری که به بخش دیگری داده می‌شود)، وضعیت است: پس از آنکه رویدادگیری عوضش کرد، صفحه خودش همان نسخه را دوباره می‌کشد، متنش، ویژگی‌هایش، و اگر و هر درونش. اگر هیچ چیز در نمایه آن را نخواند (شمارنده‌ای که فقط رویدادگیر به آن نگاه می‌کند، شناسه‌ی یک زمان‌سنج)، عوض کردنش چیزی را دوباره نمی‌کشد.
  • متغیری که هیچ چیز عوضش نمی‌کند، مانند برچسب := "رای برای " + نام، برگرفته است: هر بار که نسخه کشیده می‌شود دوباره حساب می‌شود، پس همیشه دنبال پارامترها و وضعیتی می‌رود که از آن ساخته شده است.

هیچ جای دیگر صفحه دست نمی‌خورد، پس دکمه فوکوس را نگه می‌دارد و متنی که در ورودی همان نسخه نوشته شده سر جایش می‌ماند.

web-dom-state.salam
بخش گزینه(نام: رشته):
    رای ها := ۰
    جعبه:
        کلاس = "choice" چیدمان = ردیف شکاف = 12px تراز = وسط فاصله = 8px، 12px فضا = 0، 0، 8px، 0 پس‌زمینه = #f1f5f9 گردی = 10
        دکمه: فاصله = 6px، 14px کادر = 1px، توپر، #6366f1 گردی = 8 پس‌زمینه = سفید رنگ = #4338ca نشانگر = اشاره قلم = inherit کلیک = (): رای ها++ پایان محتوا = "رأی به " + نام پایان
        تکه: اندازه قلم = 1.4rem وزن قلم = پررنگ رنگ = #0f172a محتوا = "" + رای ها پایان
        اگر رای ها بزرگتربرابر ۳:
            تکه: کلاس = "hot" اندازه قلم = 0.9rem رنگ = #b45309 محتوا = "پرطرفدار" پایان
        پایان
    پایان
پایان

صفحه:
    عنوان = "نظرسنجی با متغیر"
    قلم = "Tahoma"، سیستمی، ساده فضا = 1.5rem بیشینه عرض = 26rem
    سرتیتر: اندازه = 2 محتوا = "نوشیدنی مورد علاقه‌ی شما؟" فضا = 0، 0، 12px، 0 پایان
    گزینه: نام = "چای" پایان
    گزینه: نام = "قهوه" پایان
    گزینه: نام = "آبمیوه" پایان
پایان

متغیری که عوض می‌شود از اعلانش آغاز می‌شود، که می‌تواند از پارامترهای بخش استفاده کند (شمار := آغاز) و به گونه‌ای دیدنی نیاز دارد: یک مقدار ثابت، یک پارامتر گونه‌دار، یا مقدار برگردان گونه، مثل موارد := وکتور {} برگردان وکتور<رشته>. بلوک صفحه: هم می‌تواند در آغازش همین‌گونه متغیر اعلان کند، به جای متغیرهای ناپایا بالای آن. درون بخش، اگر و هر می‌توانند وضعیت را بخوانند و سطری که کلید دارد هنگام جابه‌جا شدن سطرها عنصرش را نگه می‌دارد. بخشی که وضعیت دارد می‌تواند درون هر باشد: هر سطر نسخه‌ی خودش از وضعیت را دارد که هنگام جابه‌جا شدن سطرها دنبال کلید سطر می‌رود (یا شناسه، یا اگر هیچ‌کدام نباشد جایگاهش). خود صفحه هم می‌تواند متغیر ناپایا را بخواند: هر عنصر، اگر یا هر که یکی را بخواند پس از هر رویدادگیری که آن را عوض کند دوباره کشیده می‌شود. در وب یک محدودیت هست: نسخه‌ها، و بخش‌هایی از صفحه که متغیر ناپایا می‌خوانند، را اسکریپت صفحه می‌کشد، پس فقط وقتی جاوااسکریپت روشن است دیده می‌شوند. همین صفحه با salam run page.salam --ui=native در پنجره‌ی بومی اجرا می‌شود و آنجا این محدودیت نیست.

گفت‌وگوی بخش‌ها با هم

یک بخش اغلب باید به بخشی که دورش است خبر بدهد که چیزی رخ داد. دو راه هست و هر دو هم در وب و هم در پنجره‌ی بومی کار می‌کنند.

راه اول تابع بازخوان (callback) است: والد تابعی را به‌عنوان پارامتر می‌دهد و فرزند آن را در رویدادگیرش صدا می‌زند. لامبدا در والد نوشته شده، پس وضعیت والد را عوض می‌کند و والد دوباره کشیده می‌شود. فرزندی که والدش چیزی نداده، فراخوانی را ساده رد می‌کند.

بخش شمارنده(تغییر):
    شمار := ۰
    دکمه: کلیک = (): شمار++ تغییر(شمار) پایان محتوا = "+۱" پایان
پایان

بخش جفت:
    جمع := ۰
    جعبه:
        پاراگراف: محتوا = "جمع " + جمع پایان
        شمارنده: تغییر = (م: صحیح): جمع += م پایان پایان
    پایان
پایان

راه دوم رویدادی است که بالا می‌رود، برای وقتی که خبر باید بیش از یک سطح برود. فرزند می‌نویسد برانگیز("افزوده شد"، بها) و جایی که بخش به کار رفته آن را با هنگام افزوده شد = (ب: صحیح): ... پایان می‌گیرد. رویداد به نزدیک‌ترین رویدادگیر می‌رسد، سپس به همه‌ی سطح‌های بالاتر، تا خط هنگام افزوده شد در آغاز بلوک صفحه. رویدادگیری که بایست() را صدا بزند جلوی ادامه‌اش را می‌گیرد. اینجا هر قفسه آنچه را به آن افزوده شده می‌شمارد و صفحه بها را جمع می‌زند، و نمونه‌ی رایگان در قفسه‌ی خودش می‌ایستد:

web-dom-events.salam
ناپایا کل := ۰

بخش کالا(نام: رشته، بها: صحیح):
    جعبه:
        کلاس = "item" چیدمان = ردیف شکاف = 12px تراز = وسط فضا = 6px، 0
        تکه: محتوا = نام + "، " + بها + " سکه" پایان
        دکمه: فاصله = 4px، 12px کادر = 1px، توپر، #6366f1 گردی = 8 پس‌زمینه = سفید رنگ = #4338ca نشانگر = اشاره قلم = inherit کلیک = (): برانگیز("افزوده شد"، بها) پایان محتوا = "بیفزا" پایان
    پایان
پایان

بخش قفسه(سرنام: رشته):
    شمار := ۰
    جعبه:
        کلاس = "shelf" فاصله = 8px، 12px فضا = 0، 0، 12px، 0 پس‌زمینه = #f1f5f9 گردی = 10
        سرتیتر: اندازه = 3 محتوا = سرنام + ": " + شمار + " افزوده" پایان
        کالا: نام = "چای" بها = ۳ هنگام افزوده شد = (): شمار++ پایان پایان
        کالا: نام = "کیک" بها = ۵ هنگام افزوده شد = (): شمار++ پایان پایان
        کالا:
            نام = "نمونه"
            بها = ۰
            هنگام افزوده شد = ():
                شمار++
                بایست()
            پایان
        پایان
    پایان
پایان

صفحه:
    عنوان = "رویدادهایی که بالا می‌روند"
    هنگام افزوده شد = (ب: صحیح): کل += ب پایان
    قلم = "Tahoma"، سیستمی، ساده فضا = 1.5rem بیشینه عرض = 26rem
    سرتیتر: اندازه = 2 محتوا = "سبد: " + کل + " سکه" فضا = 0، 0، 12px، 0 پایان
    قفسه: سرنام = "صبح" پایان
    قفسه: سرنام = "عصر" پایان
پایان

رویدادگیر مقدار را با یک پارامتر گونه‌دار می‌گیرد، یا وقتی لازمش ندارد بی‌پارامتر است. مترجم مسیر را هنگام ساختن صفحه پیدا می‌کند، پس یک رویداد بیش از صدا زدن خود رویدادگیرها هزینه ندارد و فقط بخش‌هایی که وضعیتشان عوض شده دوباره کشیده می‌شوند. دستورهای رویدادگیر بلندتر را در خط‌های جدا بنویسید، همان‌طور که نمونه می‌نویسد: در یک خط، شمار = ن بایست() عبارت ن بایست را یک نام می‌خواند.

کنار هم گذاشتن: یک پرسش و پاسخ

این یکی بزرگ‌تر است و از هر چیزی کمی دارد. وضعیت سه متغیر است: کدام پرسش دیده می‌شود، امتیاز، و کدام پاسخ برگزیده شده (منفی یک تا وقتی هیچ‌کدام نشده). پرسش‌ها در نشانه‌گذاری نیستند. یک تابع پرسش و پاسخ‌هایش را به شکل یک رشته می‌دهد، بشکاف("|") آن را تکه‌تکه می‌کند و یک تابع کوچک پاسخ برگزیده را برای هر گزینه به یک نشان تبدیل می‌کند که گزینه با اگر آن را به رنگ خودش درمی‌آورد. افزودن یک پرسش یعنی افزودن یک سطر.

web-dom-quiz.salam
تابع پرسش(شماره: صحیح): رشته:
    ترابرد شماره:
        0: برگشت "کدام عنصر بزرگ‌ترین سرتیتر است؟|h1|h6|header|0" پایان
        1: برگشت "کدام ویژگی به تصویر متن جایگزین می‌دهد؟|alt|src|title|0" پایان
        وگرنه: برگشت "کدام رویداد با هر تایپ در یک کادر رخ می‌دهد؟|click|input|load|1" پایان
    پایان
    برگشت ""
پایان

تابع قسمت(شماره: صحیح، ک: صحیح): رشته:
    برگشت پرسش(شماره).بشکاف("|").بگیر(ک)
پایان

تابع شماره پاسخ(شماره: صحیح): صحیح:
    برگشت قسمت(شماره، 4).به صحیح()
پایان

تابع نشان(شماره: صحیح، برگزیده: صحیح، ک: صحیح): صحیح:
    اگر برگزیده کوچکتر 0:
        برگشت 0
    پایان
    اگر ک برابر شماره پاسخ(شماره):
        برگشت 1
    پایان
    اگر ک برابر برگزیده:
        برگشت 2
    پایان
    برگشت 0
پایان

بخش گزینه(برچسب: رشته، نشان: صحیح، انتخاب):
    دکمه:
        عرض = پر
        فضا = 6، 0
        فاصله = 10، 14
        تراز متن = ابتدا
        اندازه قلم = 16
        کادر = 1، توپر، #cbd5e1
        گردی = 8
        پس‌زمینه = سفید
        نشانگر = اشاره
        اشاره:
            پس‌زمینه = #eef2ff
        پایان
        اگر نشان برابر 1:
            پس‌زمینه = #dcfce7
            کادر = 1، توپر، #16a34a
        پایان
        اگر نشان برابر 2:
            پس‌زمینه = #fee2e2
            کادر = 1، توپر، #dc2626
        پایان
        کلیک = انتخاب
        محتوا = برچسب
    پایان
پایان

بخش پرسشنامه:
    پرسیده := 0
    امتیاز := 0
    برگزیده := -1
    جعبه:
        قلم = سیستمی، ساده
        فضا = 24
        بیشینه عرض = 448
        اگر پرسیده کوچکتر 3:
            سرتیتر: شناسه = "ask" اندازه = 3 محتوا = قسمت(پرسیده، 0) پایان
            گزینه: برچسب = قسمت(پرسیده، 1) نشان = نشان(پرسیده، برگزیده، 0) انتخاب = ():
                اگر برگزیده کوچکتر 0:
                    برگزیده = 0
                    اگر شماره پاسخ(پرسیده) برابر 0:
                        امتیاز++
                    پایان
                پایان
            پایان پایان
            گزینه: برچسب = قسمت(پرسیده، 2) نشان = نشان(پرسیده، برگزیده، 1) انتخاب = ():
                اگر برگزیده کوچکتر 0:
                    برگزیده = 1
                    اگر شماره پاسخ(پرسیده) برابر 1:
                        امتیاز++
                    پایان
                پایان
            پایان پایان
            گزینه: برچسب = قسمت(پرسیده، 3) نشان = نشان(پرسیده، برگزیده، 2) انتخاب = ():
                اگر برگزیده کوچکتر 0:
                    برگزیده = 2
                    اگر شماره پاسخ(پرسیده) برابر 2:
                        امتیاز++
                    پایان
                پایان
            پایان پایان
            پاراگراف:
                شناسه = "verdict"
                رنگ = #475569
                محتوا = (برگزیده کوچکتر 0) ? "یک پاسخ انتخاب کنید." : ((برگزیده برابر شماره پاسخ(پرسیده)) ? "درست است." : "این بار نه.")
            پایان
        وگرنه:
            سرتیتر: اندازه = 3 محتوا = "امتیاز شما " + امتیاز + " از ۳ بود." پایان
        پایان
        دکمه:
            شناسه = "next"
            فاصله = 8، 18
            کادر = 0
            پس‌زمینه = #4f46e5
            رنگ = سفید
            گردی = 8
            نشانگر = اشاره
            کلیک = ():
                اگر پرسیده برابر 3:
                    پرسیده = 0
                    امتیاز = 0
                    برگزیده = -1
                وگرنه برگزیده بزرگتربرابر 0:
                    پرسیده++
                    برگزیده = -1
                پایان
            پایان
            محتوا = (پرسیده برابر 3) ? "دوباره بازی کن" : "بعدی"
        پایان
    پایان
پایان

صفحه:
    عنوان = "پرسشنامه"
    پرسشنامه: پایان
پایان

به نگهبان در هر گزینه توجه کنید: وقتی پاسخی برگزیده شد برگزیده دیگر منفی نیست و کلیک‌های بعدی کاری نمی‌کنند، پس هیچ‌کس دو بار امتیاز نمی‌گیرد. این را هم ببینید که «بعدی» تا وقتی پاسخی انتخاب نشده کاری نمی‌کند. چنین بررسی‌هایی باز هم وضعیت‌اند و از پنهان و آشکار کردن دکمه‌ها ارزان‌ترند.

الگوی همه‌ی صفحه‌های این درس یکی است. تصمیم بگیرید صفحه چه چیزی باید به یاد داشته باشد. صفحه را از آن وضعیت توصیف کنید. هر رویدادگیر را وادار کنید فقط وضعیت را عوض کند.

وقتی کار نمی‌کند

  • کنسول مرورگر را باز کنید (F12 و بعد Console). خطای یک رویدادگیر با شماره‌ی سطرش آنجا می‌آید و روی صفحه چیزی نمی‌آید. بیشتر مشکل‌های زیر در آن دیده می‌شوند.
  • آنچه می‌خواهید بدانید چاپ کنید. سرچاپ "کلیک‌ها:"، شمار در یک رویدادگیر مثل console.log در کنسول می‌نویسد. ساده‌ترین راه برای دیدن این است که رویدادگیر اصلاً اجرا می‌شود یا نه و حالت چیست.
  • با کلیک چیزی نمی‌شود. ببینید نام تابع نامی که مرورگر از پیش دارد (reset، open، close، focus؛ یادداشت درس ماوس را ببینید) نباشد، و ببینید در پرونده ریشه نیست. فراخوانی با پرانتز، کلیک = بیشتر()، شکست بی‌صدا نیست: مترجم با خطای E137 رد می‌کند، چون ویژگی خود تابع را می‌خواهد.
  • «Cannot read properties of null». شناسه یا گزینشگری با هیچ چیز جور نشد. آن را با صفحه مقایسه کنید و یادتان باشد شناسه‌هایی که هنگام اجرا ساخته می‌شوند را مترجم وارسی نمی‌کند.
  • صفحه عوض می‌شود و بعد برمی‌گردد. فرمی فرستاده شد. در رویدادگیر ارسال آن دام.جلوگیری پیش فرض(رویداد) را صدا بزنید.
  • فهرستی کهنه شده. نتیجه‌ی پرسمان همه عکس لحظه است. پس از افزودن یا برداشتن عنصرها دوباره بپرسید.
  • متن فارسی اشتباه شمرده می‌شود. رشته.طول() در مرورگر بایت می‌شمارد. برای آنچه خواننده می‌بیند از textLength مثل بالا استفاده کنید.
ناپایا کلیک‌ها := 0

تابع بیشتر:
    کلیک‌ها++
    سرچاپ "کلیک‌ها:"، کلیک‌ها
پایان

صفحه:
    دکمه: کلیک = بیشتر محتوا = "کلیک کنید و کنسول را ببینید" پایان
پایان

هر کاری که صفحه در مرورگر می‌کند را خواننده می‌تواند ببیند و عوض کند. هر چه اهمیت دارد، مثل قیمت، دسترسی و حد مجاز، را روی سرور دوباره بررسی کنید. نخستین درس این بخش نشان می‌دهد برنامه‌ی سلام چطور صفحه را می‌فرستد، و صفحه‌ی بسته‌ی دام هر کمک‌تابع را با امضایش فهرست کرده است.

خودتان امتحان کنید

  • فهرست کار را وادار کنید کارهایش را نگه دارد: هنگام عوض شدن فهرست متن هر کار را با تنظیم متن ذخیره ذخیره کنید و هنگام باز شدن صفحه پس بخوانید، مثل نمونه‌ی یادداشت.
  • یک پرسش چهارم به پرسش و پاسخ اضافه کنید و زیر امتیاز نهایی سطری بگذارید که بگوید چند پاسخ پشت سر هم درست بوده است.
  • کرنومتر را به شمارش معکوس تبدیل کنید: از ۳۰ ثانیه شروع کنید، در صفر بایستید و با دام.تنظیم مهلت یا همان بازه وقتی زمان تمام شد پیامی نشان دهید.
  • آکاردئون را طوری کنید که با باز شدن یک بخش بقیه بسته شوند و همیشه فقط یکی باز باشد. با پرسمان همه همه را ببینید.