Skip to content

Update Interaction: alert, prompt, confirm #248

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from Dec 21, 2022
Merged

Update Interaction: alert, prompt, confirm #248

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
990d512
Update Interaction: alert, prompt, confirm
Dec 18, 2022
7af5008
Apply suggestions from code review
Dec 20, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion 1-js/02-first-steps/06-alert-prompt-confirm/1-simple-page/task.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,6 @@ importance: 4

# یک صفحهٔ ساده

یک صفحهٔ وب ساده بسازید که نام را درخواست می‌کند و آن را نمایش می‌دهد.
یک صفحهٔ ساده وب بسازید که نام را درخواست می‌کند و آن را نمایش می‌دهد.

[demo]
14 changes: 7 additions & 7 deletions 1-js/02-first-steps/06-alert-prompt-confirm/article.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
alert("سلام");
```

این پنجرهٔ کوچک همراه با پیغام یک *modal window* است. کلمهٔ «modal» به معنای آن است که بازدیدکننده نمی‌تواند با بقیهٔ صفحه تعامل کند، دکمه‌های دیگر را بزند و یا غیره، تا زمانی که با پنجرهٔ بازشده کارش تمام شده باشد. در این مورد خاص -- تا زمانی که دکمهٔ «OK» را بزند.
کلمۀ *modal window* به این معنا می‌‌باشد که بازدیدکننده تا وقتی که پنجره باز است نمی‌تواند با بقیۀ صفحه تعامل داشته باشد، مثلا دکمه‌های دیگر را بزند و غیره. در این مثال، تا وقتی که بر روی “OK” بزند.

## prompt

Expand All @@ -27,15 +27,15 @@ result = prompt(title, [default]);
: پیغامی که به کاربر نمایش داده می‌شود.

`default`
: یک پارامتر دوم اختیاری، مقدار اولیه برای فیلد ورودی.
: پارامتر اختیاری دوم، مقدار اولیه برای فیلد ورودی.

```smart header="براکت‌های درون سینتکس `[...]`"
براکت‌های اطراف `default`در سینتکس بالا اختیاری بودن پارامتر را مشخص می‌کند.
```

بازدیدکننده می‌تواند چیزی را در فیلد ورودی prompt تایپ کند و دکمهٔ «OK» را بزند. سپس ما متن را در `result` دریافت می‌کنیم. یا بازدیدکننده می‌تواند با زدن دکمهٔ «Cancel» یا فشردن `key:Esc` ورودی را کنسل کند،
بازدیدکننده می‌تواند چیزی را در فیلد ورودی prompt تایپ کند و دکمهٔ «OK» را بزند. سپس ما متن را در `result` دریافت می‌کنیم. یا بازدیدکننده می‌تواند با زدن دکمهٔ «Cancel» یا فشردن `key:Esc` ورودی را کنسل کند.

تابع `prompt` متن دریافتی از فیلد ورودی و یا `null` در صورت کنسل شدن را بر می‌گرداند.
تابع `prompt` متن دریافتی از فیلد ورودی را بر می‌گرداند اما درصورت کنسل شدن `null` را بر می‌گرداند.

برای مثال:

Expand All @@ -54,7 +54,7 @@ alert(`You are ${age} years old!`); // You are 100 years old!
let test = prompt("تست");
```

پس، برای خوب به نظر رسیدن پِرامت‌ها در اینترنت اکسپلورر، ما پیشنهاد می‌کنیم همیشه پارامتر دوم را تعریف کنید:
پس، برای خوب به نظر رسیدن prompt ها در اینترنت اکسپلورر، ما پیشنهاد می‌کنیم همیشه پارامتر دوم را تعریف کنید:

```js run
let test = prompt("تست", ''); // <-- برای اینترنت اکسپلورر
Expand All @@ -71,7 +71,7 @@ result = confirm(question);

تابع `confirm` یک پنجرهٔ modal همراه با یک `question` (سوال) و دو دکمهٔ OK و Cancel نمایش می‌دهد.

در صورتی که OK کلیک شود، نتیجه `true` و در غیر این‌صورت، نتیجه `false` خواهد شد.
در صورتی که بر روی OK کلیک شود، نتیجه `true` و در غیر این‌صورت، نتیجه `false` خواهد شد.

برای مثال:

Expand All @@ -92,7 +92,7 @@ alert( isBoss ); // خواهد بود true پاس داده شود نتیجه OK
: نمایش یک پیغام و درخواست از کاربر برای وارد کردن متن. این تابع متن را و یا اگر دکمهٔ Cancel یا `key:Esc` زده شود `null` را بر می‌گرداند.

`confirm`
: نمایش یک پیغام و منتظرماندن برای کاربر تا دکمهٔ «OK» یا «Cancel» را فشار دهد. این تابع برای OK مقدار `true` و برای Cancel/`key:Esc` مقدار `false` را بر می‌گرداند.
: نمایش یک پیغام و منتظر ماندن برای کاربر تا دکمهٔ «OK» یا «Cancel» را فشار دهد. این تابع برای OK مقدار `true` و برای Cancel/`key:Esc` مقدار `false` را بر می‌گرداند.

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

Expand Down