CKTIS / JavaScript
KeyboardEvent: стойност на клавиша и състояние на съставяне на текст
Използвай `key`, за да разпознаеш стойността на клавиша, и `isComposing`, за да не задействаш клавишна комбинация, докато методът за въвеждане още съставя текст.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
event.key // string, read-only
event.isComposing // boolean, read-only
// event is a KeyboardEvent instance.
// To construct a synthetic event:
new KeyboardEvent("keydown", { key: "Enter", isComposing: true })event.key и event.isComposing са свойства само за четене на екземпляр на KeyboardEvent. Те са част от уеб платформата, а не от ECMAScript 2024. Поддръжката им зависи от средата за изпълнение.
key е низ, който отчита клавиатурната подредба и модифициращите клавиши, например "a" или "A" със Shift при обичайна подредба. Специалните клавиши имат именувани стойности като "Enter" и "Escape". Ако браузърът не разпознае клавиша, връща "Unidentified". За разлика от code, key не описва физическата позиция на клавиша. За да следиш промени в текста, слушай за събитието input, вместо да възстановяваш текста от натисканията на клавиши.
isComposing е булева стойност за конкретното събитие. При събитие, генерирано от браузъра, тя е true, ако то е настъпило след compositionstart и преди compositionend. Редакторът за метод на въвеждане (IME) може да използва Enter за потвърждаване на предложение за текст. Затова в обработчика на keydown не задействай клавишната комбинация, ако isComposing е true.
В началото или края на съставянето редът на събитията може да доведе до стойност false за isComposing, дори ако IME обработва клавиша. Тествай комбинациите от браузър и IME, които поддържаш. При нужда разгледай event.keyCode === 229 като остарял резервен вариант за съвместимост, а не като универсална гаранция.
Примери
{
const shouldRunShortcut = (event) =>
event.key === "Enter" && !event.isComposing;
for (const options of [
{ key: "Enter", isComposing: true },
{ key: "Enter", isComposing: false },
{ key: "Escape", isComposing: false },
]) {
// Without KeyboardEvent, test the predicate with a plain object.
const event = typeof KeyboardEvent === "function"
? new KeyboardEvent("keydown", options)
: options;
console.log(shouldRunShortcut(event) ? "run" : "skip");
}
}Резултат
skip run skip
Изпълни примера с Node.js или в конзолата на поддържан браузър. Ако `KeyboardEvent` не е наличен, примерът използва обикновени обекти със същите тестови стойности. Само Enter извън съставянето извежда `run`. Примерът не изпраща събития и не активира истински IME.
Свързани уроци
- JavaScript · Урок 41 · Средно · Версия: 3