whichсвойство события
Примеры
Получите значение Unicode нажатой клавиши клавиатуры:
xРезультат вывода:
Попробуйте сами »
Дополнительные примеры приведены в нижней части этой статьи.
Определение и использование
Свойство which возвращаетonkeypressкод символа клавиши, вызвавшей событие, илиonkeydownилиonkeyupкод клавиши.
Разница между двумя типами кодов заключается в следующем:
- Код символа — число, представляющее символ ASCII
- Код клавиши — число, представляющее фактическую клавишу на клавиатуре
Оба типа значений не всегда равны. Например, строчная буква "w" и прописная буква "W" имеют одинаковый код клавиши (код "W" — "87"), но у них разные коды символов. Эти два символа дают разный вывод (коды символов для "w" и "W" — "119" и "87") — см. примеры ниже для лучшего понимания.
Совет:Если вам нужно узнать, нажал ли пользователь печатную клавишу (например, "a" или "5"), рекомендуется использовать событие onkeypress. Если вам нужно узнать, нажал ли пользователь функциональную клавишу (например, "F1", "CAPS LOCK" или "Home"), можно использовать событие onkeydown или onkeyup.
Примечание:IE8 и более ранние версии не поддерживают свойство which. Браузеры, которые его не поддерживают, могут использовать свойствоkeyCode. Однако свойство keyCode не работает в событии onkeypress в Firefox. Для совместимости с этими браузерами можно использовать следующий код:
Совет:Полный список всех символов Юникода см. в нашемПолном справочном руководстве по Unicode。
Совет:Если вам нужно преобразовать значение Unicode в символ, можно использовать методfromCharCode().
Примечание:Это свойство доступно только для чтения.
Примечание:Свойства which и keyCode предоставляют способ обеспечения совместимости с браузерами. Для последней версии событий DOM рекомендуется использовать свойствоkeyвместо этого способа.
Совет:Если вы хотите проверить, нажата ли клавиша "ALT", "CTRL", "META" или "SHIFT", вы можете использовать свойство altKey, ctrlKey, metaKey или shiftKey.
Поддержка браузеров
Числа в таблице показывают первую версию браузера, которая полностью поддерживает это свойство.
| Свойство | |||||
|---|---|---|---|---|---|
| which | Да | 9.0 | Да | Да | Да |
Синтаксис
Технические детали
| Возвращаемое значение: | Число, представляющее код символа Юникода или код клавиши Юникода |
|---|---|
| Версия DOM: | События DOM Level 2 |
Другие примеры
Примеры
Используйте onkeypress и onkeydown, чтобы продемонстрировать разницу между кодом символа и кодом клавиши:
function uniCharCode(event) {
var char = event.which || event.keyCode; // event.keyCode используется для IE8 и более ранних версий
document.getElementById("demo").innerHTML = "Код СИМВОЛА Юникода: " + char;
}
function uniKeyCode(event) {
var key = event.which || event.keyCode; // event.keyCode используется для IE8 и более ранних версий
document.getElementById("demo2").innerHTML = "Код клавиши Unicode: " + key;
}
Когда на клавиатуре нажата клавиша "a" (без Caps Lock), вывод будет следующим:
Unicode-код клавиши: 65
Попробуйте сами »
Примеры
Если нажата клавиша Esc, выведите всплывающее сообщение alert:
функция myFunction(event) {
var x = event.which || event.keyCode; // event.keyCode используется для IE8 и более ранних версий
if (x == 27) { // 27 — это клавиша ESC
alert ("Вы нажали клавишу Escape!");
}
}
Попробуйте сами »
Примеры
Преобразовать значение Unicode в символ (нельзя использовать для функциональных клавиш):
var y = String.fromCharCode(x); // Преобразовать значение в символ
Попробуйте сами »
Связанные страницы
Справочник HTML DOM:Свойство события key
Справочник HTML DOM:Свойство события keyCode
Справочник HTML DOM:Свойство события charCode
Другие расширения
Объект Event