KeyboardEvent: location 속성

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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 키가 잠겨 있지 않을 때, 그리고 숫자 키패드가 실제로 있는 경우에도 DOM_KEY_LOCATION_NUMPAD 를 반환합니다. 다른 경우에는, 노트북 컴퓨터처럼 키보드에 키패드가 없는 경우 일부 키는 NumLock 키가 잠겨 있을 때 숫자 키패드가 됩니다. 이러한 키들이 이벤트를 발생시킬 때, 위치 속성 값은 해당 키에 의존합니다. 즉, DOM_KEY_LOCATION_NUMPAD 가 아니어야 합니다.

참고: NumLock key's key events indicate DOM_KEY_LOCATION_STANDARD both on Firefox and Internet Explorer. 참고: NumLock 키의 키 이벤트는 Internet Explorer와 Firefox 모두에서 DOM_KEY_LOCATION_STANDARD 를 나타냅니다.

DOM_KEY_LOCATION_MOBILE 비표준 지원이 중단되었습니다 4

키가 모바일 기기에 있을 때입니다. 이는 물리적인 키패드나 가상 키보드 모두에 해당될 수 있습니다.

DOM_KEY_LOCATION_JOYSTICK 비표준 지원이 중단되었습니다 5

이 키는 게임 컨트롤러 혹은 모바일 기기의 조이스틱 버튼의 키 버튼이었습니다.

숫자입니다.

예제

js
function keyEvent(event) {
  console.log(`눌려진 키의 위치: ${event.location}`);
}

명세서

Specification
UI Events
# dom-keyboardevent-location

브라우저 호환성

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
location

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

같이 보기