CKTIS / JavaScript
KeyboardEvent: стойност на клавиша и автоматично повторение
Използвай `key`, за да разпознаеш стойността на клавиша, и `repeat`, за да различиш първото натискане от автоматичните повторения при задържане.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
event.key // string, read-only
event.repeat // boolean, read-only
new KeyboardEvent("keydown", { key: "Enter", repeat: true })KeyboardEvent.key е свойство само за четене със стойност от тип низ, например "Enter", "a" или "A". Стойността зависи от клавиатурната подредба и активните модификатори като Shift. За разлика от code, което обозначава физическата позиция на клавиша, key може да се промени между събитията, ако се промени състоянието на модификатор.
KeyboardEvent.repeat е булево свойство само за четене. При реални събития keydown стойността е false при първото натискане и true при следващите събития, породени от автоматично повторение. То не показва дали клавишът е натиснат в момента. Не всички клавиши се повтарят, а честотата на повторение зависи от средата.
За да изпълниш действие веднъж при всяко натискане на Enter, провери event.key === "Enter" && !event.repeat в обработчика на keydown. Ако действието трябва да се повтаря при задържане на клавиша, не филтрирай събитията по repeat.
KeyboardEvent е API на уеб платформата, а не част от ECMAScript 2024. Не приемай, че е налично във всяка среда за изпълнение на JavaScript; провери поддръжката в целевата среда.
Примери
{
function handleKeydown(event) {
if (event.key !== "Enter" || event.repeat) return;
console.log("activate");
}
handleKeydown({ key: "Enter", repeat: false });
handleKeydown({ key: "Enter", repeat: true });
handleKeydown({ key: "Escape", repeat: false });
}Резултат
activate
Изпълни кода в Node.js или в конзолата на браузъра. Вместо клавиатурни събития обработчикът получава директно три обикновени обекта със свойства `key` и `repeat`. Само за първия обект извежда `activate`; примерът проверява условието, а не честотата на повторение.
Свързани уроци
- JavaScript · Урок 34 · Средно · Версия: 3
- JavaScript · Урок 35 · Средно · Версия: 3
- JavaScript · Урок 38 · Средно · Версия: 3