CKTIS / JavaScript
KeyboardEvent: hodnota klávesy a stav skládání textu
Pomocí `key` rozpoznej hodnotu klávesy a pomocí `isComposing` zabraň spuštění klávesové zkratky, když metoda zadávání ještě skládá text.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
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 a event.isComposing jsou vlastnosti instance KeyboardEvent určené jen ke čtení. Patří do webového API, nikoli do ECMAScriptu 2024. Jejich podpora závisí na běhovém prostředí.
key je řetězec, který zohledňuje rozložení klávesnice a modifikační klávesy, například "a" nebo se stisknutým Shift na běžném rozložení "A". Speciální klávesy mají pojmenované hodnoty, například "Enter" a "Escape". Pokud prohlížeč klávesu nerozpozná, vrátí "Unidentified". Na rozdíl od code nepopisuje key fyzickou polohu klávesy. Chceš-li sledovat změny textu, poslouchej událost input místo toho, abys text sestavoval ze stisků kláves.
isComposing je logická hodnota konkrétní události. U události vyvolané prohlížečem má hodnotu true, pokud nastala po compositionstart a před compositionend. Editor metod zadávání (IME) může klávesou Enter potvrdit návrh textu. Pokud je tedy v obsluze keydown hodnota isComposing rovna true, zkratku nespouštěj.
Na začátku nebo na konci skládání může pořadí událostí způsobit, že isComposing bude false, i když klávesu zpracovává IME. Otestuj podporované kombinace prohlížeče a IME. Podle potřeby zvaž event.keyCode === 229 jako zastaralé řešení pro kompatibilitu, ne jako univerzální záruku.
Příklady
{
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");
}
}Výsledek
skip run skip
Spusť příklad v Node.js nebo v konzoli podporovaného prohlížeče. Pokud není `KeyboardEvent` k dispozici, příklad použije obyčejné objekty se stejnými testovacími hodnotami. Pouze Enter mimo skládání vypíše `run`. Příklad neodesílá události ani neaktivuje skutečný IME.
Související lekce
- JavaScript · Lekce 41 · Středně pokročilá · Verze: 3