KeyboardEvent key 속성

DOM 이벤트 키보드 이벤트

정의와 사용법

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")

주석:사파리에서는 미정의를 반환합니다.
DOM 버전: DOM Level 3

브라우저 지원

표에 나타난 숫자는 이 속성을 최초로 완전히 지원한 브라우저 버전을 나타냅니다.

속성 크롬 IE 파이어폭스 사파리 오페라
키 51.0 9.0 23.0 지원하지 않음 38.0

관련 페이지

HTML DOM 참조 문서:KeyboardEvent keyCode 속성

HTML DOM 참조 문서:KeyboardEvent which 속성

HTML DOM 참조 문서:KeyboardEvent charCode 속성

DOM 이벤트 키보드 이벤트