سبد (0)

رویداد key

مثال (رویداد key)

برگرداندن دکمه ای که در صفحه کلید، هنگام روی دادن یک رویداد کلید، فشار داده شده است:

var x = event.key;

خروجی x در کد بالا:

Enter

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

در انتهای این صفحه، مثال های بیشتری آورده شده است.


تعریف و کاربرد

خصوصیت key، شناسه ی یک دکمه را، هنگام روی دادن یک رویداد کلید، برمی گرداند.

شناسه ی یک دکمه در واقع یک رشته است که دکمه های صفحه کلید با آن شناخته می شوند. 

مقدار برگشتی از این خصوصیت می تواند رشته هایی از قبیل زیر باشد:

  • یک کاراکتر تکی مانند a و W و 4 و + و یا $.
  • یک کاراکتر چند گانه مانند F1 و Enter و HOME و CAPS LOCK.

این خصوصیت "فقط خواندنی" است.

نکته: اگر شما می خواهید بدانید که آیا هنگام روی دادن یک رویداد کلید، دکمه های ALT و CTRL و META و SHIFT، فشار داده شده اند یا نه، از خصوصیت های altKey و ctrlKey و metaKey و  shiftKey استفاده کنید.


پشتیبانی مرورگرها

اعداد داخل جدول زیر نشان دهنده ی اولین ورژن مرورگری است که به طور کامل از این رویداد پشتیبانی می کند.

متد     
key پشتیبانی نمی شود 9.0 23.0 پشتیبانی نمی شود پشتیبانی نمی شود

نحوه استفاده

event.key

جزئیات تکنیکی

مقدار برگشتی

یک رشته که مشخص کننده ی دکمه ی فشار داده شده است

مقادیر امکان پذیر:

یک کاراکتر تکی مثل A و w و 4 و یا $

یک کاراکتر چند گانه مثل  F1 و Enter و HOME و CAPS LOCK

  • نکته: در مرورگر های CHROME و SAFARI و OPERA ، UNDEFINED را برمی گرداند.
DOM Version: DOM Level 3 Events

مثال

مثال - خودتان امتحان کنید

مثال (رویداد key)

نشان دادن یک پیام  در صورتی که کلید A فشار داده شود:

var x = event.key;

// If the pressed keyboard button is "a" or "A" (using caps lock or shift), alert some text.

if (x == "a" || x == "A") {
    alert ("You pressed the 'A' key!");
}

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

آموزش های مرتبط

مرجع مدل DOM در اچ تی ام ال KeyboardEvent keyCode Property

مرجع مدل DOM در اچ تی ام ال KeyboardEvent which Property

مرجع مدل DOM در اچ تی ام ال KeyboardEvent charCode Property


مرجع کلیه رویدادهای JavaScript Reference مرجع کلیه رویدادهای JavaScript


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