KeyboardEvent key 屬性

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 ("You pressed the 'A' key!");
}

親自試一試

語法

event.key

技術細節

返回值：

字符串，代表按下的鍵盤按鈕。

可能的值：

  • 單個字符（比如 "a", "W", "4", "+" 或 "$"）
  • 多字符（比如 "F1", "Enter", "HOME" 或 "CAPS LOCK"）

注釋：在 Safari 中返回未定義。
DOM 版本： DOM Level 3

瀏覽器支持

表中的數字注明了完全支持該屬性的首個瀏覽器版本。

屬性 Chrome IE Firefox Safari Opera
key 51.0 9.0 23.0 不支持 38.0

相關頁面

HTML DOM 參考手冊：KeyboardEvent keyCode 屬性

HTML DOM 參考手冊：KeyboardEvent which 屬性

HTML DOM 參考手冊：KeyboardEvent charCode 屬性

DOM 事件 KeyboardEvent