ویژگی 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")

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

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

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

ویژگی Chrome IE Firefox Safari Opera
کلید 51.0 9.0 23.0 پشتیبانی نمی‌شود 38.0

صفحات مرتبط

منوی مرجع HTML DOM:ویژگی keyCode رویداد KeyboardEvent

منوی مرجع HTML DOM:ویژگی which رویداد KeyboardEvent

منوی مرجع HTML DOM:ویژگی charCode رویداد KeyboardEvent

DOM رویداد KeyboardEvent