Руководство Javascript KeyboardEvent

KeyboardEvent
Properties & Methods
Таблица Key, KeyCode

1. KeyboardEvent

KeyboardEvent это интерфейс представляющий события, происходящие когда пользователь взаимодействует с клавиатурой. Включает события keydown, keypress, keyup.

KeyboardEvent это подинтерфейс UIEvent.

Javascript UiEvent

Order	Event
1	onkeydown
2	onkeypress
3	onkeyup

keydown

Событие keydown происходит когда вы нажимаете на (press down) клавишу (key). В операционной системе Windows, если вы продолжите держать клавишу в нажатом состоянии, она будет продолжать выдавать события keypress .. keydown. Но операционной системе MacOS, если вы продолжите держать клавишу в нажатом состоянии, она будет продолжать выдавать события keydown. Как в изображении ниже:

keypress

Есть 2 случая происхождения события keypress, при этом первый случай я уже объяснил выше (Смотрите событие keydown). Второй случай, вы нажимаете (press down) клавишу и быстро выпускаете (release), в этот момет происходят 2 события по данному порядку keypress, keyup.

keyup

Событие keyup происходит когда вы выпускаете (release) клавишу.

Примечание: Событие keypress не будет происходить для таких клавиш, как ALT, SHIFT, CTRL, META-KEY, ESC, Если вы хотите обнаружить (detect) нажаты ли эти клавиши или нет, вы можете использовать свойство (property) altKey, shiftKey, ctrlKey, metaKey объекта event.

keyevents-example.html

<!DOCTYPE html>
<html>
   <head>
      <title>KeyEvent Example</title>

      <script src="keyevents-example.js"></script>

   </head>
   <body>

      <h3>KeyEvent example</h3>

      <input type="text"
            onkeydown="keydownHandler(event)"
            onkeyup="keyupHandler(event)"
            onkeypress="keypressHandler(event)"/>
      <br/><br/>

      <textarea id="log-div" rows = "10" disabled>

      </textarea>
      <br/>
      <button onclick="clearLog()">Clear</button>

   </body>
</html>

keyevents-example.js

function keydownHandler(evt)  {
    appendLog("Keydown!");
}

function keyupHandler(evt)  {
    appendLog("Keyup!");
}

function keypressHandler(evt)  {
    appendLog("Keypress!");
}


function appendLog(text)  {
    var oldText = document.getElementById("log-div").value;
    document.getElementById("log-div").value = oldText+"\n"+ text;
}

function clearLog()  {
    document.getElementById("log-div").value = "";
}

2. Properties & Methods

KeyEvent это подинтерфейс у UIEvent, поэтому он наследует свойства (property) и методы с данного интерфейса.

Javascript UiEvent

Свойства	Описание
altKey	Возвращает true если клавиша "ALT" нажата, когда происходит событие.
ctrlKey	Возвращает true если клавиша "CTRL" нажата, когда происходит событие.
shiftKey	Возвращает true если клавиша "SHIFT" нажата, когда происходит событие.
metaKey	Возвращает true если клавиша "META" нажата, когда происходит событие.

Например: Нажмите клавишу 'SHIFT' и держите, потом нажмите на любую клавишу.

prop-shiftKey-example.html

<!DOCTYPE html>
<html>
   <head>
      <title>KeyEvent Example</title>

      <script src="prop-shiftKey-example.js"></script>

   </head>
   <body>

      <h3>Hold key 'SHIFT' and press any key!</h3>

      <input type="text"
            onkeydown="keydownHandler(event)"/>
      <br/><br/>

      <div id="log-div" style="color:red;"></div>

   </body>
</html>

prop-shiftKey-example.js

function keydownHandler(evt)  {

   if(evt.shiftKey) {
      document.getElementById("log-div").innerHTML ="evt.shiftKey = true";
   } else {
      document.getElementById("log-div").innerHTML ="evt.shiftKey = false";
   }

}

Свойство	Описание
keyCode	Возвращает код символа Unicode клавиши, которая активировала событие keypress, или код клавиши Unicode клавиши, которая активировала данное событие.
key	Возвращает название клавиши. Например (enter, shift, 0, 1, a, b,....)

charCode	Возвращает код символа Unicode клавиши, которая активировала событие keypress. Примечание: charCode = 0 в событии keydown, keyup.
code	Возвращает название клавиши. Например (Enter, Shift, Digit0, Digit1, KeyA, KeyB,...)

which	Возвращает charCode в событии keypress, или keyCode в событии keydown, keyup.

keyCode, key:

Каждая клавиша (key) на клавиатуре имеет представляющее число, называется keyCode. Например клавиша 'a' имеет keyCode = 65. Для клавиатуры нет понятия прописной, строчной буквы. Поэтому keyCode у 'a' или 'A' оба являются 65.

keyCode	key (name of key)
...
9	tab
12	clear
13	enter
...
48	0
49	1
50	2
51	3
....
65	a
66	b
67	c
.....

** Вы можете просмотреть детали таблицы Key & KeyCode в аппендиксе, в конце данной статьи.

prop-key-keyCode-example.html

<!DOCTYPE html>
<html>
   <head>
      <title>KeyEvent Example</title>

      <script>
          function keydownHandler(evt) {
            var logDiv = document.getElementById("log-div");

            logDiv.innerHTML = "event.key= " + evt.key +"<br/>"
                             + "event.keyCode= "+ evt.keyCode;
          }
      </script>

   </head>
   <body>

      <h3>event.key, event.keyCode</h3>

      <input type="text" onkeydown="keydownHandler(event)"/>
      <br/><br/>

      <div id="log-div" style="color:red;"></div>
   </body>
</html>

code, charCode

keyCode	key (Name of key)	code (Name of key)
.....
16	shift	ShiftLeft
.....
48	0	Digit0
49	1	Digit1
50	2	Digit2
51	3	Digit3
....
65	a	KeyA
66	b	KeyB
67	c	KeyC
68	d	KeyD
69	e	KeyE
.....

charCode присваивается значение только в событии keypress, он всегда имеет значение 0 в событии keydown & keyup. charCode это число представляющее символ Unicode, на который нажимает пользователь.

prop-code-charCode-example.html

<!DOCTYPE html>
<html>
   <head>
      <title>KeyEvent Example</title>

      <script>
          function keypressHandler(evt) {
            var logDiv = document.getElementById("log-div");

            logDiv.innerHTML = "event.code= " + evt.code +"<br/>"
                             + "event.charCode= "+ evt.charCode;
          }
      </script>

   </head>
   <body>

      <h3>event.code, event.charCode</h3>

      <input type="text" onkeypress="keypressHandler(event)"/>
      <br/><br/>

      <div id="log-div" style="color:red;"></div>

   </body>
</html>

keyCode vs charCode

key	keyCode (keydown/keyup)	keyCode (keypress)	charCode (keypress)
.....
a/A	65 / 65	97 / 65	97 / 65
b/B	66 / 66	98 / 66	98 / 66
c/C	67 / 67	99 / 67	99 / 67
d/D	68 / 68	100 / 68	100 / 68
e/E	69 / 69	101 / 69	101 / 69
.....
Свойство	Описание
isComposing	Возвращает true если состояние события composing (Составляется). Если наоборот возвращает false.
location	Возвращает расположение клавиши на клавиатуре или устройстве.
repeat	Возвращает true если клавиша нажата (hold down) постоянно. Если наоборот возвращает false.
Метод	Описание
getModifierState()	Возвращает true, если настоящая клавиша активирована.

3. Таблица Key, KeyCode

keyCode	Key (Name of key).
0	That key has no keycode
3	break
8	backspace / delete
9	tab
12	clear
13	enter
16	shift
17	ctrl
18	alt
19	pause/break
20	caps lock
21	hangul
25	hanja
27	escape
28	conversion
29	non-conversion
32	spacebar
33	page up
34	page down
35	end
36	home
37	left arrow
38	up arrow
39	right arrow
40	down arrow
41	select
42	print
43	execute
44	Print Screen
45	insert
46	delete
47	help
48	0
49	1
50	2
51	3
52	4
53	5
54	6
55	7
56	8
57	9
58	:
59	semicolon (firefox), equals
60	<
61	equals (firefox)
63	ß
64	@ (firefox)
65	a
66	b
67	c
68	d
69	e
70	f
71	g
72	h
73	i
74	j
75	k
76	l
77	m
78	n
79	o
80	p
81	q
82	r
83	s
84	t
85	u
86	v
87	w
88	x
89	y
90	z
91	Windows Key / Left ⌘ / Chromebook Search key
92	right window key
93	Windows Menu / Right ⌘
95	sleep
96	numpad 0
97	numpad 1
98	numpad 2
99	numpad 3
100	numpad 4
101	numpad 5
102	numpad 6
103	numpad 7
104	numpad 8
105	numpad 9
106	multiply
107	add
108	numpad period (firefox)
109	subtract
110	decimal point
111	divide
112	f1
113	f2
114	f3
115	f4
116	f5
117	f6
118	f7
119	f8
120	f9
121	f10
122	f11
123	f12
124	f13
125	f14
126	f15
127	f16
128	f17
129	f18
130	f19
131	f20
132	f21
133	f22
134	f23
135	f24
144	num lock
145	scroll lock
160	^
161	!
162	؛ (arabic semicolon)
163	#
164	$
165	ù
166	page backward
167	page forward
168	refresh
169	closing paren (AZERTY)
170	*
171	~ + * key
172	home key
173	minus (firefox), mute/unmute
174	decrease volume level
175	increase volume level
176	next
177	previous
178	stop
179	play/pause
180	e-mail
181	mute/unmute (firefox)
182	decrease volume level (firefox)
183	increase volume level (firefox)
186	semi-colon / ñ
187	equal sign
188	comma
189	dash
190	period
191	forward slash / ç
192	grave accent / ñ / æ / ö
193	?, / or °
194	numpad period (chrome)
219	open bracket
220	back slash
221	close bracket / å
222	single quote / ø / ä
223	`
224	left or right ⌘ key (firefox)
225	altgr
226	< /git >, left back slash
230	GNOME Compose Key
231	ç
233	XF86Forward
234	XF86Back
235	non-conversion
240	alphanumeric
242	hiragana/katakana
243	half-width/full-width
244	kanji
251	unlock trackpad (Chrome/Edge)
255	toggle touchpad

Руководство Javascript KeyboardEvent

1. KeyboardEvent

2. Properties & Methods

3. Таблица Key, KeyCode

Pуководства ECMAScript, Javascript

Pуководства ECMAScript, Javascript

Новейшие статьи