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

浏览器兼容性

另见