KeyboardEvent: location 屬性

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

KeyboardEvent.location 只讀屬性返回一個 unsigned long,表示鍵盤或其它輸入裝置上按鍵的位置。

可能的值是

常量 描述
DOM_KEY_LOCATION_STANDARD 0 該按鍵只有一個版本,或者左右版本無法區分,並且不是在數字鍵盤或被認為是鍵盤一部分的按鍵上按下。
DOM_KEY_LOCATION_LEFT 1 該按鍵是左側版本;例如,在標準的 101 鍵美式鍵盤上按下了左側的 Control 鍵。此值僅用於在鍵盤上具有多個可能位置的按鍵。
DOM_KEY_LOCATION_RIGHT 2 該按鍵是右側版本;例如,在標準的 101 鍵美式鍵盤上按下了右側的 Control 鍵。此值僅用於在鍵盤上具有多個可能位置的按鍵。
DOM_KEY_LOCATION_NUMPAD 3

該按鍵位於數字鍵盤上,或者具有對應於數字鍵盤的虛擬鍵碼。

注意:NumLock 鎖定後,Firefox 始終為數字鍵盤上的按鍵返回 DOM_KEY_LOCATION_NUMPAD。否則,當 NumLock 未鎖定且鍵盤實際具有數字鍵盤時,Firefox 也始終返回 DOM_KEY_LOCATION_NUMPAD。另一方面,如果鍵盤沒有數字鍵盤,例如在筆記型電腦上,某些按鍵在 NumLock 鎖定後才會成為數字鍵盤按鍵。當這些按鍵觸發鍵盤事件時,location 屬性值取決於按鍵本身。也就是說,它不應為 DOM_KEY_LOCATION_NUMPAD

注意: NumLock 鍵的鍵盤事件在 Firefox 和 Internet Explorer 中都指示 DOM_KEY_LOCATION_STANDARD

DOM_KEY_LOCATION_MOBILE 非標準 已棄用 4

該按鍵位於移動裝置上;這可以位於物理鍵盤或虛擬鍵盤上。

DOM_KEY_LOCATION_JOYSTICK 非標準 已棄用 5

該按鍵是遊戲控制器上的按鈕或移動裝置上的操縱桿。

一個數字。

示例

js
function keyEvent(event) {
  console.log(`Location of key pressed: ${event.location}`);
}

規範

規範
UI 事件
# dom-keyboardevent-location

瀏覽器相容性

另見