jQuery метод .keydown()
Определение и применение
jQuery метод .keydown() позволяет привязать JavaScript обработчик событий keydown (нажатие на
любую клавишу клавиатуры), или запускает это событие на выбранный элемент.
Событие "keydown" посылается элементу в тот момент, когда пользователь нажимает клавишу на клавиатуре. Если эта клавиша удерживается нажатой, то событие вызывается многократно. Это событие может быть прикреплено к любому элементу, но сработает только на тех элементах, которые имеют фокус.
Обратите внимание, что событие "keydown" в отличии от события "keypress" (метод .keypress()), которое не срабатывает на специальных кнопках (Alt, Ctrl, Shift, Esc, PrScr и тому подобное), срабатывает при нажатии на любую кнопку.
jQuery синтаксис:
Синтаксис 1.0:
$( selector ).keydown() // метод используется без параметров
$( selector ).keydown( handler )handler - Function( Event eventObject )
Синтаксис 1.4.3:
$( selector ).keydown( eventData, handler )eventData - Anything
handler - Function( Event eventObject )
Обращаю Ваше внимание, что метод .keydown(), используемый вместе с функцией, переданной в качестве параметра (handler) является, короткой записью метода .on(), а без параметра является короткой записью метода .trigger():
$( selector ).on( "keydown", handler )
$( selector ).trigger( "keydown" )
Добавлен в версии jQuery
1.0 (синтаксис обновлен в версии 1.4.3)Значения параметров
| Параметр | Описание |
|---|---|
| eventData | Объект, содержащий данные, которые будут переданы в обработчик событий. |
| handler |
Функция, которая будет выполнена каждый раз, когда событие срабатывает. Функция в качестве параметра может
принимать объект Event.
|
Пример старого кода
Метод .keydown() — пример 1
Нажмите . Используйте кнопки в результате и наблюдайте изменения. Измените JavaScript и запустите пример повторно. Используется jQuery 4.0.0.
index.html
<button>Клик</button>
<div>Элемент div</div>
main.js
$(document).ready(function () {
$('button').click(function () {
// задаем функцию при нажатиии на элемент button
$('div').keydown() // вызываем событие keydown на элементе <div>
})
$('div').keydown(function () {
// задаем функцию при нажатиии любой клавиши клавиатуры на элементе
$('div').css('background', 'green') // задаем цвет заднего фона элемента
})
})
style.css
body {
margin: 16px;
font:
16px/1.5 system-ui,
sans-serif;
overflow-wrap: anywhere;
}
img,
input,
select,
textarea,
button {
max-width: 100%;
}
Нажмите , чтобы запустить пример.
В этом примере с использованием jQuery метода .keydown() мы при нажатии на элемент
<button>
(кнопка) вызываем событие "keydown" на элементе
<div>. Самому элементу
<div>
задаем, что при срабатывании события "keydown" на элементе выполнить функцию, которая с использованием метода
.css()
установит цвет заднего фона элемента зелёным.
Обратите внимание, что напрямую мы не можем вызвать у элемента
<div>
событие "keydown" по той причине, что элемент не может получить фокус.
Рассмотрим следующий пример в котором с помощью метода .keydown() будем выводить в консоль браузера код нажатой пользователем клавиши на клавиатуре:
Метод .keydown() — пример 2
Нажмите . Измените JavaScript и запустите пример повторно. Используется jQuery 4.0.0.
index.html
main.js
$(document).ready(function () {
$('body').keydown(function (event) {
// задаем функцию при нажатиии любой клавиши клавиатуры на элементе
console.log(event.which) // выводим код нажатой клавиши
})
})
style.css
body {
margin: 16px;
font:
16px/1.5 system-ui,
sans-serif;
overflow-wrap: anywhere;
}
img,
input,
select,
textarea,
button {
max-width: 100%;
}
Нажмите , чтобы запустить пример.
В этом примере с использованием jQuery метода .keydown() мы при нажатии на элементе
<body>
вызываем событие "keydown", в котором вызываем функию, которая в качестве параметра принимает объект
Event и выводим в консоль значения свойства which этого объекта, которое содержит код нажатой клавиши
клавиатуры. В нашем примере были нажаты и выведены в консоль коды клавиш на клавиатуре по очереди:
basicweb. Обратите внимание на то, что мы в этом примере получаем код клавиши (скан-код), а не символа.
Даже если мы бы ввели basicweb в русской раскладке результат вывода в консоль был бы тот же. Чтобы вывести
код символа вы можете воспользоваься методом
.keypress().