wip: update article.md -- browser-default actions

Author: MHMighani

2-ui/2-events/04-default-browser-action/article.md

@@ -1,36 +1,37 @@
-# اقدامات پیشفرض مرورگر
+# اکشن‌های پیشفرض مرورگر
 
-بسیاری از رویدادها اقدامات خودبه‌‍خودی از سمت مرورگر را در پی دارند
+بسیاری از رویدادها اقدامات خودبه‌خودی از سمت مرورگر را در پی دارند
 
 برای نمونه:
 
 - یک کلیک بر روی لینک - شما را به آدرس موردنظر میرساند
 - یک کلیک روی دکمه ارسال فرم - تایید و ارسال فرم به سرور آغاز می‌شود.
 - فشردن دکمه ماوس برروی متن و حرکت دادن آن - متن را انتخاب می‌کند
 
-اگر بخواهیم که یک رویداد را در جاوااسکریپت مدیریت کنیم، ممکن است نخواهیم تا اکشن پیشفرض مرورگر اتفاق بیفتد، و بخواهیم که رفتار متفاوتی به جای آن را پیاده‌سازی کنیم.
+اگر بخواهیم که یک رویداد را در جاوااسکریپت مدیریت کنیم ممکن است نخواهیم تا اکشن پیشفرض مرورگر اتفاق بیفتد و بخواهیم که رفتار متفاوتی به جای آن را پیاده‌سازی کنیم.
 
-## جلوگیری از اقدامات مرورگر
+## جلوگیری از اکشن‌های مرورگر
 
 دو راه برای اینکه به مرورگر بگوییم نمیخواهیم تا رفتار پیشفرض را انجام دهد وجود دارد:
 
-- راه اصلی استفاده از آبجکت `event` است. متدی به نام `event.preventDefault()` وجود دارد.
-- اگر هندلر با استفاده از `on<event>` مشخص شده باشد (نه با `addEventListener`) آنگاه بازگرداندن مقدار `false` به طرز مشابه عمل خواهد کرد.
+- راه اصلی استفاده از آبجکت `event` است. متدی به نام `()event.preventDefault` وجود دارد.
+- اگر هندلر با استفاده از `<on<event` مشخص شده باشد (نه با `addEventListener`) آنگاه بازگرداندن مقدار `false` به همین صورت عمل خواهد کرد.
 
 در این فایل HTML, کلیک بر روی یک لینک منجر به تغییر آدرس مروگر نمی‌شود; مرورگر کاری نمی‌کند:
 
 ```html autorun height=60 no-beautify
 <a href="/" onclick="return false">اینجا را کلیک کنید</a>
-or
+یا
 <a href="/" onclick="event.preventDefault()">اینجا</a>
 ```
 
-در مثال بعدی ما از این تکنیک برای ایجاد یک منو با جاوااسکریپت استفاده خواهیم کرد.
+در مثال بعدی، ما از این تکنیک برای ایجاد یک منو با جاوااسکریپت استفاده خواهیم کرد.
+
+```warn header="بازگرداندن `false` از یک هندلر یک استثناست"
 
-```warn header="Returning `false` from a handler is an exception"
 مقدار بازگردانده شده توسط یک هندلر معمولا نادیده گرفته می‌شود.
 
-تنها استثنا برگردانده شند `return false` از یک هندلر اختصاص داده شده با استفاده از `on<event>` است.
+تنها استثنا برگرداندن `return false` از یک هندلر اختصاص داده شده با استفاده از `<on<event` است.
 
 در همه‌ی موارد دیگر مقدار `return` نادیده گرفته می‌شود. به طور خاص بازگرداندن `true` هیچ معنایی ندارد.
 
@@ -66,10 +67,10 @@ menu.onclick = function(event) {
   if (event.target.nodeName != 'A') return;
 
   let href = event.target.getAttribute('href');
-  alert( href ); // ...can be loading from the server, UI generation etc
+  alert( href ); // میتواند لود از سرور یا ساخت UI و مانند آن باشد...
 
 *!*
-  return false; // prevent browser action (don't go to the URL)
+  return false; // از رفتار پیشفرض مرورگر جلوگیری میکند (به آدرس نرو)
 */!*
 };
 ```
@@ -90,18 +91,18 @@ menu.onclick = function(event) {
 <input *!*onmousedown="return false"*/!* onfocus="this.value=''" value="Click me">
 ```
 
-این بخاطر آن است که اکشن مرورگر برروی `mousedown` لغو شده است. فوکوس کردن همچنان امکان‌پذیر است اگر ما راه دیگری برای وارد کردن اینپوت استفاده کنیم.  برای مثال کلید `Tab` برای انتقل از اینپوت اول به دوم. اما بدون استفاده از کلیک ماوس.
+این بخاطر آن است که اکشن مرورگر برروی `mousedown` لغو شده است. فوکوس کردن همچنان امکان‌پذیر است اگر ما راه دیگری برای وارد کردن اینپوت استفاده کنیم.  برای مثال کلید `Tab` برای انتقال از اینپوت اول به دوم اما بدون استفاده از کلیک ماوس.
 ````
 
 # <<<<<<< HEAD
 
-## گزینه هندلر "passive"
+## امکان هندلر "passive"
 
-آپشن اختیاری `passive: true` از `addEventListener` این سیگنال را به مرورگر میدهد که مرورگر هندلر `preventDefault()` را صدا نخواهد کرد..
+آپشن اختیاری `passive: true` از `addEventListener` این سیگنال را به مرورگر میدهد که مرورگر هندلر `()preventDefault` را صدا نخواهد کرد.
 
 چرا ممکن است که به این آپشن نیاز پیدا کنیم؟
 
-ایونت هایی همچون `touchmove` در دیوایس‌های موبایلی وجود دارند (زمانی که یوزر انگشت خود را برروی صفحه‌نمایش حرکت می‌دهد) که به صورت پیشفرض باعث اسکرول می‌شوند اما این اسکرول خوردن میتواند با وجود `preventDefault()` در هندلر جلوگیری شود.
+ایونت هایی همچون `touchmove` در دیوایس‌های موبایلی وجود دارند (زمانی که یوزر انگشت خود را برروی صفحه‌نمایش حرکت می‌دهد) که به صورت پیشفرض باعث اسکرول می‌شوند اما این اسکرول خوردن میتواند با وجود `()preventDefault` در هندلر جلوگیری شود.
 
 بنابراین زمانی که مرورگر چنین ایونتی را شناسایی میکند اول از همه باید همه‌ی هندلرهارا بررسی کرده و اگر `preventDefault` جایی صدا زده نشده باشد میتواند با اسکرول خوردن ادامه یابد که این میتواند سبب تاخیرها و لرزش‌های غیرضروری شود.
 
@@ -117,7 +118,7 @@ menu.onclick = function(event) {
 
 یک مورد استفاده جالب برای این وجود دارد.
 
-به یاد دارید که در فصل <info:bubbling-and-capturing> راجع به `()event.propagation` اینکه چرا bubbling خوب نیست صحبت کردیم؟
+به یاد دارید که در فصل <info:bubbling-and-capturing> راجع به `()event.propagation` و اینکه چرا bubbling خوب نیست صحبت کردیم؟
 
 گاهی اوقات برای اینکه به باقی ایونت هندلرها خبر بدهیم که ایونت هندل شده میتوانیم از `event.defaultPrevented` استفاده کنیم.
 
@@ -133,7 +134,7 @@ menu.onclick = function(event) {
 </button>
 ```
 
-حالا علاوه بر context menu میخواهیم تا یک منو به وسعت داکیومنت پیاده‌سازی کنیم.
+حالا علاوه بر context menu میخواهیم تا یک منو تعریف شده در داکیومنت پیاده‌سازی کنیم.
 
 با کلیک‌راست نزدیک‌ترین context menu ظاهر خواهد شد.
 
@@ -210,10 +211,10 @@ menu.onclick = function(event) {
 حالا همه چیز به درستی کار میکند. این راه حل حتی اگر المنت‌های تودرتویی داشته باشیم که هرکدام منوی خودشان را داشته باشند هم کار می‌کند. فقط اطمینان حاصل کنید که `event.defaultPrevented` در هر یک از هندلرهای `contextmenu` چک می‌شود.
 
 ```smart header="event.stopPropagation() and event.preventDefault()"
-به خوبی میتوانیم ببینیم که `event.stopPropagation()` و `event.preventDefault()` (که همچنین به عنوان `return false` شناخته می‌شود) دو چیز متفاوت از هم هستند که به یکدیگر ربطی ندارند.
+واضح است که `()event.stopPropagation` و `()event.preventDefault` (که همچنین به عنوان `return false` شناخته می‌شود) دو چیز متفاوت از هم هستند که به یکدیگر ربطی ندارند.
 ```
 
-```smart header="Nested context menus architecture"
+```smart header="معماری context menu های تودرتو"
 همچنین راه‌های جایگزینی برای پیاده‌‍سازی منوهای تودرتو وجود دارد. یکی از آنها این است که یک آبجکت گلوبال با یک هندلر برای `document.oncontextmenu` داشته باشیم و همچنین متدهایی که به ما اجازه می‌دهند تا دیگر هندلرهایی را در آن ذخیره کنیم.
 
 آبجت هرگونه کلیک راستی را گرفته، نگاهی به هندلرهای آن می‌اندازد و هندلر مناسب را اجرا میکند.
@@ -234,7 +235,7 @@ menu.onclick = function(event) {
 
 اگر بخواهیم تا ایونت را به طور خاص با جاوااسکریپت هندل کنیم می‌توانیم از همه‌ی اکشن‌های پیشفرض جلوگیری کنیم.
 
-برای جلوگیری از یک اکشن پیشفرض میتوانیم از `event.preventDefault()` یا `return false` استفاده کنیم. دومین متد تنها برای هندلرهای اختصاص یافته با `on<event>` کار می‌کند.
+برای جلوگیری از یک اکشن پیشفرض میتوانیم از `()event.preventDefault` یا `return false` استفاده کنیم. دومین متد تنها برای هندلرهای اختصاص یافته با `<on<event` کار می‌کند.
 
 اگر از اکشن پیشفرض جلوگیری شده باشد مقدار `event.defaultPrevented` به `true` تغییر می‌کند در غیراینصورت `false` می‌شود.
 
@@ -245,5 +246,5 @@ menu.onclick = function(event) {
 
 این موضوع علاوه بر اینکه "چیز خوبی است" کد HTML شما را از نظر دسترسی‌پذیری بهتر میکند.
 
-علاوه بر این اگر مثال `<a>` را درنظر بگیریم باید به این نکته توجه کنید که: یک مرورگر به ما این اجازه را می‌دهد تا این لینک‌ها را در یک پنجره جدید باز کنیم (بار کلیک راست  برروی منوها) و کاربران این رو دوست دارند. اما اگر کاری کنیم که یک دکمه مانند لینک رفتار کند و حتی با استفاده از css ظاهرش را مانند یک لینک کنیم آنگاه ویژگی‌های منحصر به فرد تگ `<a>` برای آن عمل نخواهد کرد.
+علاوه بر این اگر مثال `<a>` را درنظر بگیریم باید به این نکته توجه کنید که: یک مرورگر به ما این اجازه را می‌دهد تا این لینک‌ها را در یک پنجره جدید باز کنیم (با کلیک راست  برروی منوها) و کاربران این رفتار را دوست دارند. اما اگر کاری کنیم که یک دکمه مانند لینک رفتار کند و حتی با استفاده از css ظاهرش را مانند یک لینک کنیم آنگاه ویژگی‌های منحصر به فرد تگ `<a>` برای آن عمل نخواهد کرد.
 ```