کتابخانه‌ی استاندارد · وب و سرویس‌ها

دام dom

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

واردسازی دام

نام آرگومان‌ها شناسه‌ی خود کد است و معادل فارسی ندارد؛ گونه‌ها، کلیدواژه‌ها و نام بسته‌ها با معادل فارسی نوشته می‌شوند.

این بسته به برنامه‌ی سلام اجازه می‌دهد یک صفحه‌ی وب را بگرداند: عنصر پیدا کند و بسازد، متن و کلاس و سبکشان را عوض کند، به کلیک و کلید واکنش نشان دهد، زمان‌سنج راه بیندازد و مقدارهای کوچک را در localStorage نگه دارد. برنامه‌ای که آن را به کار می‌برد در مرورگر اجرا می‌شود. آن را با salam js app.salam --output=app.js به جاوااسکریپت ترجمه کنید و با تگ <script src="app.js"> بار کنید؛ ریشه وقتی صفحه آماده شد اجرا می‌شود و سرچاپ در کنسول مرورگر می‌نویسد. نمونه‌های این صفحه برای همین فقط بررسی شده‌اند و اجرا نمی‌شوند. برای نقاشی بوم، برای بازی‌هایی که هر قاب صفحه‌کلید را می‌خوانند کلیدها و برای پنجره‌ی رومیزی دور یک صفحه نمایش وب را ببینید.

عنصرها و دیگر اشیای جاوااسکریپت در یک متغیر صحیح۶۴ نگه داشته می‌شوند و رویدادها و زمان‌سنج‌ها یک تابع بی‌نام مثل (): ... پایان می‌گیرند. هر تابع به یک فراخوانی مرورگر می‌رسد (تنظیم متن همان textContent است، تنظیم سبک همان style.setProperty و مانند این‌ها)، پس مستندات MDN همان فراخوانی درباره‌اش صدق می‌کند.

چیزهایی که بیشتر غافلگیر می‌کنند:

  • عنصری که نیست null جاوااسکریپت است، نه صفر. مقایسه‌ی آن با ۰ هرگز درست نمی‌شود و به کار بردنش خطا می‌دهد. پیش از با شناسه با وجود دارد بسنجید، یا برای گزینشگر با تعداد(پرسمان همه(...)) برابر ۰.
  • تنظیم اچ تی ام ال هر HTML که بگیرد اجرا می‌کند. متن کاربر را با تنظیم متن بگذارید، هرگز با تنظیم اچ تی ام ال.
  • تنظیم سبک نام CSS می‌گیرد، مثل background-color، نه شکل جاوااسکریپتی backgroundColor.
  • هنگام آماده اگر از ریشه صدا زده شود کاری نمی‌کند، چون ریشه پس از آماده شدن صفحه اجرا می‌شود و مرورگر رویداد آمادگی را تکرار نمی‌کند. کد آغازین را مستقیم در ریشه بگذارید.
  • توقف رویداد دقیقاً همان مقدار تابعی را می‌خواهد که ثبت کرده‌اید، پس آن را در متغیر نگه دارید؛ لامبدای دیگری با همان بدنه تابع دیگری است.

اجرای نمونه‌ها

هر برنامه‌ی زیر اسکریپت کامل یک صفحه است. آن را با نام app.salam ذخیره کنید، ترجمه‌اش کنید و یک فایل HTML که خروجی را بار می‌کند باز کنید:

salam js app.salam --output=app.js
echo '<!doctype html><meta charset="utf-8"><body><script src="app.js"></script>' > index.html
salam serve .

سپس به http://127.0.0.1:8000 بروید. خروجی سرچاپ در کنسول مرورگر دیده می‌شود. اگر به جای آن --output=app.html بدهید، salam js یک صفحه‌ی خودبسنده می‌نویسد.

فهرست کارها

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

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

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

تابع افزودن کار(متن: رشته):
    مورد := دام.بساز("li")
    دام.تنظیم متن(مورد، متن)
    دام.هنگام رویداد(مورد، "click"، ():
        دام.تعویض کلاس(مورد، "done")
    پایان)
    دام.افزودن(فهرست، مورد)
    شمار افزوده++
    دام.تنظیم عدد ذخیره("todo-added"، شمار افزوده برگردان صحیح۶۴)
پایان

تابع ریشه:
    دام.تنظیم عنوان("کارهای من")
    ورودی متن = دام.بساز("input")
    دام.تنظیم ویژگی(ورودی متن، "placeholder"، "چه کاری باید انجام شود؟")
    دکمه := دام.بساز("button")
    دام.تنظیم متن(دکمه، "افزودن")
    فهرست = دام.بساز("ul")
    دام.افزودن(دام.بدنه()، ورودی متن)
    دام.افزودن(دام.بدنه()، دکمه)
    دام.افزودن(دام.بدنه()، فهرست)

    دام.هنگام رویداد(دکمه، "click"، ():
        متن := دام.دریافت مقدار(ورودی متن)
        اگر متن.طول() بزرگتر ۰:
            افزودن کار(متن)
            دام.تنظیم مقدار(ورودی متن، "")
        پایان
    پایان)
    دام.هنگام رویداد جزئی(ورودی متن، "keydown"، (رخداد: صحیح۶۴):
        اگر دام.کلید رویداد(رخداد) برابر "Enter":
            دام.جلوگیری پیش فرض(رخداد)
            متن := دام.دریافت مقدار(ورودی متن)
            اگر متن.طول() بزرگتر ۰:
                افزودن کار(متن)
                دام.تنظیم مقدار(ورودی متن، "")
            پایان
        پایان
    پایان)
    سرچاپ "کارهای افزوده شده روی این دستگاه تا کنون:"، دام.دریافت عدد ذخیره("todo-added")
پایان

هنگام رویداد گرداننده‌ای بی‌آرگومان می‌گیرد؛ وقتی خود رویداد را لازم دارید، مثلاً برای خواندن کلید با کلید رویداد یا جلوگیری از کار پیش‌فرض مرورگر با جلوگیری پیش فرض، از هنگام رویداد جزئی استفاده کنید.

کار با عنصرهایی که از قبل در صفحه هستند

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

dom-filter.salam
واردسازی دام
واردسازی رشته

تابع پالایش(ردیف‌ها: صحیح۶۴، واژه: رشته، شمارنده: صحیح۶۴):
    ناپایا نمایان := ۰
    تکرار دام.تعداد(ردیف‌ها) در ی:
        ردیف := دام.عنصر شماره(ردیف‌ها، ی)
        نام := رشته.کوچک(دام.دریافت متن(ردیف))
        اگر واژه.طول() برابر ۰ یا رشته.شامل است(نام، واژه):
            دام.تنظیم سبک(ردیف، "display"، "")
            نمایان++
        وگرنه:
            دام.تنظیم سبک(ردیف، "display"، "none")
        پایان
    پایان
    دام.تنظیم متن(شمارنده، نمایان + " از " + دام.تعداد(ردیف‌ها) + " کالا")
پایان

تابع ریشه:
    اگر وارونه (دام.وجود دارد("search") و دام.وجود دارد("count")):
        سرچاپ "این اسکریپت به #search و #count در صفحه نیاز دارد"
        برگشت
    پایان
    جستجو := دام.با شناسه("search")
    شمارنده := دام.با شناسه("count")
    ردیف‌ها := دام.پرسمان همه("#products tr")
    اگر دام.تعداد(ردیف‌ها) برابر ۰:
        دام.تنظیم متن(شمارنده، "کالایی نیست")
        برگشت
    پایان
    دام.تنظیم سبک(دام.پرسمان("#products")، "background-color"، "#fafafa")
    دام.هنگام رویداد(جستجو، "input"، ():
        پالایش(ردیف‌ها، رشته.کوچک(رشته.پیرایش(دام.دریافت مقدار(جستجو)))، شمارنده)
    پایان)
    پالایش(ردیف‌ها، ""، شمارنده)
پایان

اسکریپت انتظار نشانه‌گذاری‌ای مثل <input id="search"> <p id="count"></p> <table id="products"><tr><td>چای سبز</td></tr>...</table> را دارد. پرسمان همه ردیف‌هایی را برمی‌گرداند که همان لحظه هستند؛ ردیف‌هایی که بعداً اضافه شوند در فهرست نیستند، پس پس از تغییر جدول دوباره پرسمان کنید.

بررسی فرم هم‌زمان با نوشتن

رویداد input با هر تغییر در جعبه‌ی متن رخ می‌دهد و برای همین جای بررسی زنده است. یک تابع همه‌ی فیلدها را نگاه می‌کند، نخستین مشکل را در یک عنصر پیام می‌نویسد و دکمه را با تنظیم خاصیت منطقی و ویژگی disabled روشن و خاموش می‌کند. صدا زدن آن یک بار در پایان ریشه فرم را پیش از این‌که کاربر به آن دست بزند در وضعیت درست می‌گذارد.

dom-form-check.salam
واردسازی دام
واردسازی رشته

ناپایا رایانامه := ۰ برگردان صحیح۶۴
ناپایا گذرواژه := ۰ برگردان صحیح۶۴
ناپایا دکمه ثبت := ۰ برگردان صحیح۶۴
ناپایا پیام := ۰ برگردان صحیح۶۴

تابع بررسی فرم():
    نشانی := دام.دریافت مقدار(رایانامه)
    رمز := دام.دریافت مقدار(گذرواژه)
    ناپایا مشکل := ""
    اگر وارونه رشته.شامل است(نشانی، "@"):
        مشکل = "یک نشانی رایانامه وارد کنید."
    وگرنه رمز.طول() کوچکتر ۸:
        مشکل = "گذرواژه دست کم ۸ نویسه لازم دارد."
    پایان
    دام.تنظیم متن(پیام، مشکل)
    دام.تنظیم خاصیت منطقی(دکمه ثبت، "disabled"، مشکل.طول() بزرگتر ۰)
    اگر مشکل.طول() بزرگتر ۰:
        دام.افزودن کلاس(پیام، "error")
    وگرنه:
        دام.حذف کلاس(پیام، "error")
    پایان
پایان

تابع ریشه:
    رایانامه = دام.بساز("input")
    دام.تنظیم ویژگی(رایانامه، "type"، "email")
    گذرواژه = دام.بساز("input")
    دام.تنظیم ویژگی(گذرواژه، "type"، "password")
    دکمه ثبت = دام.بساز("button")
    دام.تنظیم متن(دکمه ثبت، "ثبت نام")
    پیام = دام.بساز("p")
    هر عنصر در [رایانامه، گذرواژه، دکمه ثبت، پیام]:
        دام.افزودن(دام.بدنه()، عنصر)
    پایان
    دام.هنگام رویداد(رایانامه، "input"، ():
        بررسی فرم()
    پایان)
    دام.هنگام رویداد(گذرواژه، "input"، ():
        بررسی فرم()
    پایان)
    دام.هنگام رویداد(دکمه ثبت، "click"، ():
        دام.هشدار("خوش آمدید، " + دام.دریافت مقدار(رایانامه))
    پایان)
    بررسی فرم()
پایان

رویداد یک مقدار تابعی می‌خواهد، پس تابع نام‌دار را در یک لامبدای کوتاه بپیچید: (): بررسی فرم() پایان. بررسی در مرورگر فقط برای راحتی کاربر است؛ سرور باید همان چیزها را دوباره بسنجد، برای نمونه با net.http.validate.

شمارش معکوس با زمان‌سنج

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

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

ناپایا مانده := ۱۰
ناپایا زمان‌سنج := ۰ برگردان صحیح۶۴
ناپایا برچسب := ۰ برگردان صحیح۶۴

تابع ریشه:
    برچسب = دام.بساز("h1")
    دام.افزودن(دام.بدنه()، برچسب)
    دام.تنظیم متن(برچسب، "" + مانده)
    زمان‌سنج = دام.تنظیم بازه(():
        مانده--
        دام.تنظیم متن(برچسب، "" + مانده)
        اگر مانده برابر ۰:
            دام.پاک کردن بازه(زمان‌سنج)
            دام.تنظیم متن(برچسب، "زمان تمام شد")
            دام.تنظیم سبک(برچسب، "color"، "crimson")
            دام.صدا(۶۶۰، ۳۰۰)
        پایان
    پایان، ۱۰۰۰)
پایان

صدا با Web Audio API یک بوق کوتاه پخش می‌کند. مرورگرها فقط پس از این‌که کاربر روی صفحه کلیک یا تایپ کرده اجازه‌ی پخش صدا می‌دهند، پس بوق زمان‌سنجی که با بار شدن صفحه شروع شده ممکن است بی‌صدا بماند.

تابع‌ها

پرسمان Query

تابع پرسمان(sel: رشته): صحیح۶۴
نخستین عنصری که با گزینشگر CSS جور است؛ اگر نباشد null جاوااسکریپت، که با ۰ برابر نیست.
dom-Elements.salam
واردسازی دام

تابع ریشه:
    فهرست := دام.بساز("ul")
    دام.تنظیم ویژگی(فهرست، "id"، "books")
    دام.افزودن(دام.بدنه()، فهرست)
    تکرار ۳ در ش:
        م := دام.بساز("li")
        دام.تنظیم متن(م، "کتاب " + (ش + ۱))
        دام.افزودن کلاس(م، "book")
        دام.افزودن(فهرست، م)
    پایان
    سرچاپ دام.وجود دارد("books")، دام.وجود دارد("nothing")

    همه := دام.پرسمان همه("li.book")
    سرچاپ دام.تعداد(همه)
    دوم := دام.عنصر شماره(همه، ۱)
    سرچاپ دام.دریافت متن(دوم)
    دام.تعویض کلاس(دوم، "selected")
    سرچاپ دام.دریافت ویژگی(دوم، "class")
    دام.حذف کلاس(دوم، "book")
    سرچاپ دام.دریافت ویژگی(دوم، "class")

    دام.تنظیم سبک(دوم، "color"، "red")
    سرچاپ دام.دریافت سبک(دوم، "color")
    اول := دام.پرسمان("li")
    دام.برداشتن(اول)
    سرچاپ دام.تعداد(دام.پرسمان همه("li"))

    ج := دام.با شناسه("books")
    دام.تنظیم اچ تی ام ال(ج، "<li>تازه</li>")
پایان

پرسمان همه QueryAll

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

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Elements.salam

با شناسه ById

تابع با شناسه(id: رشته): صحیح۶۴
عنصر با این شناسه؛ اگر نباشد null، پس اول با وجود دارد بسنجید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Elements.salam

وجود دارد Exists

تابع وجود دارد(id: رشته): منطقی
عنصری با این شناسه هست.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Elements.salam

بساز Create

تابع بساز(tag: رشته): صحیح۶۴
عنصر تازه با این تگ؛ هنوز در صفحه نیست تا آن را افزودن کنید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Elements.salam

بدنه Body

تابع بدنه(): صحیح۶۴
عنصر body صفحه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Elements.salam

سند Document

تابع سند(): صحیح۶۴
شیء document.
dom-Objects.salam
واردسازی دام

تابع ریشه:
    س := دام.سند()
    سرچاپ دام.دریافت خاصیت رشته ای(س، "title")
    دام.تنظیم خاصیت رشته ای(س، "title"، "صفحه‌ی من")
    سرچاپ دام.دریافت خاصیت رشته ای(س، "title")
    پ := دام.پنجره()
    سرچاپ دام.دریافت خاصیت عددی(پ، "innerWidth") == دام.عرض پنجره()
    سرچاپ دام.عرض سند() > ۰، دام.ارتفاع سند() > ۰

    جعبه := دام.بساز("input")
    دام.تنظیم خاصیت منطقی(جعبه، "disabled"، درست)
    سرچاپ دام.دریافت خاصیت منطقی(جعبه، "disabled")
    دام.تنظیم خاصیت عددی(جعبه، "tabIndex"، ۳)
    سرچاپ دام.دریافت خاصیت عددی(جعبه، "tabIndex")
    دام.تنظیم خاصیت(جعبه، "parentRef"، دام.بدنه())
    سرچاپ دام.دریافت خاصیت(جعبه، "parentRef") == دام.بدنه()

    ریاضی := دام.سراسری("Math")
    سرچاپ دام.فراخوان یک(ریاضی، "abs"، -۵)، دام.فراخوان دو(ریاضی، "max"، ۲، ۹)
    سرچاپ دام.فراخوان سه(ریاضی، "max"، ۱، ۲، ۳)، دام.فراخوان چهار(ریاضی، "min"، ۴، ۳، ۲، ۱)
    _ := دام.فراخوان(جعبه، "focus")
    _ := دام.فراخوان رشته یک(جعبه، "removeAttribute"، "placeholder")
    _ := دام.فراخوان رشته دو(جعبه، "setAttribute"، "name"، "q")
    سرچاپ دام.دریافت ویژگی(جعبه، "name")

    بوم := دام.بساز("canvas")
    ز := دام.دریافت زمینه(بوم، "2d")
    سرچاپ ز != ۰

    دام.تنظیم عدد ذخیره("best"، ۴۲)
    دام.تنظیم متن ذخیره("name"، "مریم")
    سرچاپ دام.دریافت عدد ذخیره("best")، دام.دریافت متن ذخیره("name")

    ت := دام.تصادفی()
    سرچاپ ت >= ۰.۰ و ت < ۱.۰، دام.تصادفی صحیح(۶) < ۶
    سرچاپ دام.اکنون() >= ۰.۰

    دکمه := دام.بساز("button")
    سلام کن := ():
        سرچاپ "سلام"
    پایان
    دام.هنگام رویداد(دکمه، "click"، سلام کن)
    دام.توقف رویداد(دکمه، "click"، سلام کن)

    عکس := دام.بارگذاری تصویر("logo.png")
    سرچاپ دام.تصویر آماده(عکس)
    دام.صدا(۴۴۰، ۲۰۰)
    اگر دام.تایید("ادامه بدهیم؟"):
        نام := دام.درخواست ورودی("نامت چیست؟")
        دام.هشدار("سلام " + نام)
    پایان
پایان

پنجره Window

تابع پنجره(): صحیح۶۴
شیء window.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

سراسری Global

تابع سراسری(name: رشته): صحیح۶۴
یک شیء سراسری جاوااسکریپت با این نام، مثل Math.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

افزودن Append

تابع افزودن(parent: صحیح۶۴، child: صحیح۶۴)
عنصر را به انتهای فرزندان عنصر دیگر می‌افزاید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Elements.salam

برداشتن Remove

تابع برداشتن(el: صحیح۶۴)
عنصر را از صفحه برمی‌دارد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Elements.salam

تنظیم متن SetText

تابع تنظیم متن(el: صحیح۶۴، text: رشته)
متن عنصر را تنظیم می‌کند؛ HTML آن تفسیر نمی‌شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Elements.salam

دریافت متن GetText

تابع دریافت متن(el: صحیح۶۴): رشته
متن عنصر.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Elements.salam

تنظیم اچ تی ام ال SetHtml

تابع تنظیم اچ تی ام ال(el: صحیح۶۴، html: رشته)
HTML درون عنصر را تنظیم می‌کند. متنی را که کاربر نوشته این‌جا نگذارید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Elements.salam

تنظیم مقدار SetValue

تابع تنظیم مقدار(el: صحیح۶۴، value: رشته)
مقدار یک جعبه‌ی ورودی.
dom-Events.salam
واردسازی دام

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

تابع ریشه:
    دکمه := دام.بساز("button")
    دام.تنظیم متن(دکمه، "بزن")
    دام.تنظیم ویژگی(دکمه، "data-autofire"، "click")
    دام.افزودن(دام.بدنه()، دکمه)
    دام.هنگام رویداد(دکمه، "click"، ():
        شمار++
        سرچاپ "کلیک"، شمار
    پایان)

    جعبه := دام.بساز("input")
    دام.تنظیم ویژگی(جعبه، "data-autofire"، "keydown")
    دام.افزودن(دام.بدنه()، جعبه)
    دام.تنظیم مقدار(جعبه، "سلام")
    سرچاپ دام.دریافت مقدار(جعبه)
    دام.هنگام رویداد جزئی(جعبه، "keydown"، (ر: صحیح۶۴):
        اگر دام.کلید رویداد(ر) == "Enter":
            دام.جلوگیری پیش فرض(ر)
        پایان
        دام.توقف انتشار(ر)
        سرچاپ "هدف:"، دام.دریافت مقدار(دام.هدف رویداد(ر))
    پایان)

    دام.رویداد جزئی پنجره("mousemove"، (ر: صحیح۶۴):
        سرچاپ دام.رویداد افقی(ر)، دام.رویداد عمودی(ر)
    پایان)
    دام.رویداد جزئی پنجره("touchstart"، (ر: صحیح۶۴):
        سرچاپ دام.لمس افقی(ر)، دام.لمس عمودی(ر)
    پایان)
    دام.رویداد پنجره("scroll"، ():
        سرچاپ دام.پیمایش افقی()، دام.پیمایش عمودی()
    پایان)
    دام.هنگام آماده(():
        سرچاپ "صفحه آماده است"
    پایان)
    دام.هنگام تغییر اندازه(():
        سرچاپ دام.عرض پنجره()، دام.ارتفاع پنجره()
    پایان)
پایان

دریافت مقدار GetValue

تابع دریافت مقدار(el: صحیح۶۴): رشته
مقدار فعلی جعبه‌ی ورودی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Events.salam

تنظیم سبک SetStyle

تابع تنظیم سبک(el: صحیح۶۴، prop: رشته، value: رشته)
یک خاصیت CSS را با نام CSS آن تنظیم می‌کند، مثل color یا background-color؛ مقدار خالی آن را برمی‌دارد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Elements.salam

دریافت سبک GetStyle

تابع دریافت سبک(el: صحیح۶۴، prop: رشته): رشته
مقدار خاصیت CSS که روی خود عنصر تنظیم شده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Elements.salam

تنظیم ویژگی SetAttr

تابع تنظیم ویژگی(el: صحیح۶۴، name: رشته، value: رشته)
یک ویژگی HTML را تنظیم می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Elements.salam

دریافت ویژگی GetAttr

تابع دریافت ویژگی(el: صحیح۶۴، name: رشته): رشته
مقدار یک ویژگی؛ اگر نباشد، رشته‌ی خالی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Elements.salam

افزودن کلاس AddClass

تابع افزودن کلاس(el: صحیح۶۴، name: رشته)
کلاسی به عنصر می‌افزاید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Elements.salam

حذف کلاس RemoveClass

تابع حذف کلاس(el: صحیح۶۴، name: رشته)
کلاسی را برمی‌دارد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Elements.salam

تعویض کلاس ToggleClass

تابع تعویض کلاس(el: صحیح۶۴، name: رشته)
اگر کلاس هست برمی‌دارد، وگرنه می‌افزاید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Elements.salam

هنگام رویداد OnEvent

تابع هنگام رویداد(el: صحیح۶۴، event: رشته، handler: تابع())
تابعی را برای یک رویداد عنصر ثبت می‌کند، مثل click.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Events.salam

هنگام رویداد جزئی OnEventE

تابع هنگام رویداد جزئی(el: صحیح۶۴، event: رشته، handler: تابع(صحیح۶۴))
مثل تابع بالا، ولی تابع شیء رویداد را هم می‌گیرد تا با کلید رویداد و مانند آن بخوانیدش.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Events.salam

رویداد جزئی پنجره OnWindowE

تابع رویداد جزئی پنجره(event: رشته، handler: تابع(صحیح۶۴))
تابع با شیء رویداد برای رویدادهای پنجره، مثل keydown.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Events.salam

توقف رویداد OffEvent

تابع توقف رویداد(el: صحیح۶۴، event: رشته، handler: تابع())
تابعی را که پیش‌تر ثبت شده برمی‌دارد؛ باید همان تابع را بدهید، پس آن را در یک متغیر نگه دارید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

رویداد پنجره OnWindow

تابع رویداد پنجره(event: رشته، handler: تابع())
تابع برای یک رویداد پنجره، مثل scroll.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Events.salam

هنگام آماده OnReady

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

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Events.salam

هنگام تغییر اندازه OnResize

تابع هنگام تغییر اندازه(handler: تابع())
تابع را با هر تغییر اندازه‌ی پنجره صدا می‌زند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Events.salam

درخواست فریم RequestFrame

تابع درخواست فریم(handler: تابع(اعشار۶۴))
تابع را پیش از رسم فریم بعدی یک بار صدا می‌زند؛ تابع زمان را بر حسب میلی‌ثانیه می‌گیرد.
dom-Timers.salam
واردسازی دام

ناپایا تیک := ۰
ناپایا بازه := ۰ برگردان صحیح۶۴

تابع ریشه:
    دام.تنظیم عنوان("زمان‌سنج")
    آغاز := دام.اکنون()
    _ := دام.تنظیم مهلت(():
        سرچاپ "یک ثانیه گذشت"
    پایان، ۱۰۰۰)
    لغو := دام.تنظیم مهلت(():
        سرچاپ "این اجرا نمی‌شود"
    پایان، ۵۰۰۰)
    دام.پاک کردن مهلت(لغو)
    بازه = دام.تنظیم بازه(():
        تیک++
        اگر تیک == ۳:
            دام.پاک کردن بازه(بازه)
        پایان
    پایان، ۲۰۰)
    دام.درخواست فریم((زمان: اعشار۶۴):
        سرچاپ "فریم پس از"، زمان - آغاز
    پایان)
    دام.چرخش فریم((زمان: اعشار۶۴):
        _ := زمان
    پایان)
پایان

تنظیم مهلت SetTimeout

تابع تنظیم مهلت(handler: تابع()، ms: صحیح۶۴): صحیح۶۴
تابع را پس از این قدر میلی‌ثانیه یک بار صدا می‌زند و شناسه‌ای برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Timers.salam

تنظیم بازه SetInterval

تابع تنظیم بازه(handler: تابع()، ms: صحیح۶۴): صحیح۶۴
تابع را هر این قدر میلی‌ثانیه صدا می‌زند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Timers.salam

پاک کردن مهلت ClearTimeout

تابع پاک کردن مهلت(id: صحیح۶۴)
مهلتی را که هنوز اجرا نشده لغو می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Timers.salam

پاک کردن بازه ClearInterval

تابع پاک کردن بازه(id: صحیح۶۴)
تکرار را متوقف می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Timers.salam

عرض پنجره WinWidth

تابع عرض پنجره(): اعشار۶۴
عرض پنجره بر حسب پیکسل.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Events.salam

ارتفاع پنجره WinHeight

تابع ارتفاع پنجره(): اعشار۶۴
ارتفاع پنجره.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Events.salam

عرض سند DocWidth

تابع عرض سند(): اعشار۶۴
عرض سند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

ارتفاع سند DocHeight

تابع ارتفاع سند(): اعشار۶۴
ارتفاع سند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

پیمایش افقی ScrollX

تابع پیمایش افقی(): اعشار۶۴
مقدار پیمایش افقی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Events.salam

پیمایش عمودی ScrollY

تابع پیمایش عمودی(): اعشار۶۴
مقدار پیمایش عمودی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Events.salam

اکنون Now

تابع اکنون(): اعشار۶۴
زمان دقیق از بارگذاری صفحه، بر حسب میلی‌ثانیه؛ برای اندازه‌گیری فاصله‌ها.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Timers.salam

دریافت خاصیت GetProp

تابع دریافت خاصیت(obj: صحیح۶۴، name: رشته): صحیح۶۴
خاصیتی از یک شیء که خودش شیء است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

دریافت خاصیت عددی GetNum

تابع دریافت خاصیت عددی(obj: صحیح۶۴، name: رشته): اعشار۶۴
خاصیت عددی؛ اگر نباشد یا عدد نباشد ۰.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

دریافت خاصیت رشته ای GetStr

تابع دریافت خاصیت رشته ای(obj: صحیح۶۴، name: رشته): رشته
خاصیت رشته‌ای.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

دریافت خاصیت منطقی GetBool

تابع دریافت خاصیت منطقی(obj: صحیح۶۴، name: رشته): منطقی
خاصیت بولی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

تنظیم خاصیت SetProp

تابع تنظیم خاصیت(obj: صحیح۶۴، name: رشته، value: صحیح۶۴)
خاصیتی را به یک شیء تنظیم می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

تنظیم خاصیت عددی SetNum

تابع تنظیم خاصیت عددی(obj: صحیح۶۴، name: رشته، value: اعشار۶۴)
خاصیت عددی را تنظیم می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

تنظیم خاصیت رشته ای SetStr

تابع تنظیم خاصیت رشته ای(obj: صحیح۶۴، name: رشته، value: رشته)
خاصیت رشته‌ای را تنظیم می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

تنظیم خاصیت منطقی SetBool

تابع تنظیم خاصیت منطقی(obj: صحیح۶۴، name: رشته، value: منطقی)
خاصیت بولی را تنظیم می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

فراخوان Call0

تابع فراخوان(obj: صحیح۶۴، method: رشته): صحیح۶۴
متدی از شیء را بی‌آرگومان صدا می‌زند و نتیجه را برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

فراخوان یک Call1

تابع فراخوان یک(obj: صحیح۶۴، method: رشته، a: اعشار۶۴): صحیح۶۴
با یک آرگومان عددی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

فراخوان دو Call2

تابع فراخوان دو(obj: صحیح۶۴، method: رشته، a: اعشار۶۴، b: اعشار۶۴): صحیح۶۴
با دو آرگومان عددی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

فراخوان سه Call3

تابع فراخوان سه(obj: صحیح۶۴، method: رشته، a: اعشار۶۴، b: اعشار۶۴، c: اعشار۶۴): صحیح۶۴
با سه آرگومان عددی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

فراخوان چهار Call4

تابع فراخوان چهار(obj: صحیح۶۴، method: رشته، a: اعشار۶۴، b: اعشار۶۴، c: اعشار۶۴، d: اعشار۶۴): صحیح۶۴
با چهار آرگومان عددی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

فراخوان رشته یک CallS1

تابع فراخوان رشته یک(obj: صحیح۶۴، method: رشته، a: رشته): صحیح۶۴
با یک آرگومان رشته‌ای.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

فراخوان رشته دو CallS2

تابع فراخوان رشته دو(obj: صحیح۶۴، method: رشته، a: رشته، b: رشته): صحیح۶۴
با دو آرگومان رشته‌ای.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

دریافت زمینه GetContext

تابع دریافت زمینه(canvas: صحیح۶۴، kind: رشته): صحیح۶۴
زمینه‌ی رسم یک عنصر canvas، مثل 2d؛ برای رسم ساده‌تر بوم را ببینید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

عنصر شماره ItemAt

تابع عنصر شماره(listobj: صحیح۶۴، idx: صحیح۶۴): صحیح۶۴
عنصری از فهرستی که پرسمان همه برگرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Elements.salam

تعداد CountOf

تابع تعداد(listobj: صحیح۶۴): صحیح۶۴
شمار عنصرهای فهرست.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Elements.salam

هدف رویداد EventTarget

تابع هدف رویداد(ev: صحیح۶۴): صحیح۶۴
عنصری که رویداد روی آن رخ داد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Events.salam

رویداد افقی EventX

تابع رویداد افقی(ev: صحیح۶۴): اعشار۶۴
جای افقی نشانگر موش در رویداد، از لبه‌ی چپ پنجره (clientX).

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Events.salam

رویداد عمودی EventY

تابع رویداد عمودی(ev: صحیح۶۴): اعشار۶۴
جای عمودی نشانگر.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Events.salam

کلید رویداد EventKey

تابع کلید رویداد(ev: صحیح۶۴): رشته
کلید فشرده‌شده، مثل Enter یا a.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Events.salam

جلوگیری پیش فرض PreventDefault

تابع جلوگیری پیش فرض(ev: صحیح۶۴)
جلوی کار پیش‌فرض مرورگر را می‌گیرد، مثل فرستادن فرم.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Events.salam

توقف انتشار StopPropagation

تابع توقف انتشار(ev: صحیح۶۴)
نمی‌گذارد رویداد به عنصرهای بالاتر برسد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Events.salam

هشدار Alert

تابع هشدار(msg: رشته)
پیامی در پنجره‌ی مرورگر نشان می‌دهد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

تایید Confirm

تابع تایید(msg: رشته): منطقی
پرسشی با دکمه‌های تایید و لغو؛ اگر کاربر تایید کرد، درست.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

درخواست ورودی Prompt

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

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

تنظیم عنوان SetTitle

تابع تنظیم عنوان(title: رشته)
عنوان زبانه‌ی مرورگر را تنظیم می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Timers.salam

چرخش فریم EveryFrame

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

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Timers.salam

تصادفی Random

تابع تصادفی(): اعشار۶۴
عدد تصادفی از ۰ تا کمتر از ۱.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

تصادفی صحیح RandomInt

تابع تصادفی صحیح(n: صحیح۶۴): صحیح۶۴
عدد صحیح تصادفی از ۰ تا کمتر از n.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

صدا Tone

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

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

بارگذاری تصویر LoadImage

تابع بارگذاری تصویر(src: رشته): صحیح۶۴
بارگذاری تصویری را آغاز می‌کند و شیء آن را برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

تصویر آماده ImageReady

تابع تصویر آماده(img: صحیح۶۴): منطقی
تصویر کامل بارگذاری شده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

دریافت عدد ذخیره StoreGetInt

تابع دریافت عدد ذخیره(key: رشته): صحیح۶۴
عددی که در حافظه‌ی مرورگر (localStorage) ذخیره شده؛ اگر نباشد، صفر.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

تنظیم عدد ذخیره StoreSetInt

تابع تنظیم عدد ذخیره(key: رشته، v: صحیح۶۴)
عددی را در حافظه‌ی مرورگر ذخیره می‌کند؛ پس از بستن صفحه هم می‌ماند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

دریافت متن ذخیره StoreGetStr

تابع دریافت متن ذخیره(key: رشته): رشته
متن ذخیره‌شده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

تنظیم متن ذخیره StoreSetStr

تابع تنظیم متن ذخیره(key: رشته، v: رشته)
متنی را ذخیره می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Objects.salam

لمس افقی TouchX

تابع لمس افقی(ev: صحیح۶۴): اعشار۶۴
جای افقی نخستین انگشت در رویداد لمسی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Events.salam

لمس عمودی TouchY

تابع لمس عمودی(ev: صحیح۶۴): اعشار۶۴
جای عمودی نخستین انگشت.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: dom-Events.salam