خصوصیت key رویداد KeyboardEvent

DOM ڈیویسن KeyboardEvent

تعریف و استفاده

خصوصیت key نام‌گذاری کلید را بازمی‌گرداند که در هنگام وقوع رویداد کلید فشرده شده است.

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

  • یک کاراکتر (مثلاً "a", "W", "4", "+" یا "$")
  • چند کاراکتر (مثلاً "F1", "Enter", "HOME" یا "CAPS LOCK")

توضیحات:این خصوصیت فقط خواندنی است.

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

مثال

مثال 1

گرفتن کلید فشرده شده در هنگام وقوع رویداد کلید:

var x = event.key;

آزمایش کنید

مثال 2

اگر کاربر کلید "A" را فشرده کند، یک متن نشان داده می‌شود:

var x = event.key;
// اگر کلید فشرده شده "a" یا "A" (با استفاده از CapsLock یا Shift) باشد، یک متن نشان داده می‌شود.
if (x == "a" || x == "A") { 
  alert ("شما کلید 'A' را فشرده‌اید!");
}

آزمایش کنید

قوانین نوشتاری

رویداد.key

جزئیات فنی

مقدار بازگشتی:

رشته، که نشان‌دهنده کلید فشرده شده روی صفحه‌کلید است.

ممکنه‌یار:

  • یک کاراکتر (مثلاً "a", "W", "4", "+" یا "$")
  • چند کاراکتر (مثلاً "F1", "Enter", "HOME" یا "CAPS LOCK")

توضیحات:در سافاری به عنوان نامتعیین برمی‌گردد.
نسخه DOM: DOM سطح 3

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

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

خصوصیات کروم آئی ای افرکس سافاری آپرا
کلید 51.0 9.0 23.0 ناممکن 38.0

صفحات مرتبط

HTML DOM مرجع:بندقہ کی شرح میں keyCode کا حصہ

HTML DOM مرجع:بندقہ کی شرح میں which کا حصہ

HTML DOM مرجع:بندقہ کی شرح میں charCode کا حصہ

DOM ڈیویسن KeyboardEvent