CKTIS / JavaScript
KeyboardEvent: hodnota klávesu a stav skladania textu
Pomocou `key` rozpoznaj hodnotu klávesu a pomocou `isComposing` zabráň spusteniu klávesovej skratky, kým metóda zadávania ešte skladá text.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
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 sú vlastnosti inštancie KeyboardEvent určené len na čítanie. Patria do webového API, nie do ECMAScriptu 2024. Ich podpora závisí od prostredia, v ktorom sa kód spúšťa.
key je reťazec, ktorý zohľadňuje rozloženie klávesnice a modifikačné klávesy, napríklad "a" alebo so stlačeným Shift pri bežnom rozložení "A". Špeciálne klávesy majú pomenované hodnoty, napríklad "Enter" a "Escape". Ak prehliadač kláves nerozpozná, vráti "Unidentified". Na rozdiel od code hodnota key neopisuje fyzickú polohu klávesu. Ak chceš sledovať zmeny textu, počúvaj udalosť input namiesto skladania textu zo stlačení klávesov.
isComposing je logická hodnota konkrétnej udalosti. Pri udalosti vygenerovanej prehliadačom má hodnotu true, ak nastala po compositionstart a pred compositionend. Editor metódy zadávania (IME) môže klávesom Enter potvrdiť návrh textu. Preto v obsluhe keydown nespúšťaj skratku, ak je isComposing rovné true.
Na začiatku alebo konci skladania môže poradie udalostí spôsobiť, že isComposing bude false, aj keď kláves spracúva IME. Otestuj podporované kombinácie prehliadača a IME. V prípade potreby zváž event.keyCode === 229 ako zastarané riešenie pre kompatibilitu, nie ako univerzálnu záruku.
Prí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ýsledok
skip run skip
Spusť príklad v Node.js alebo v konzole podporovaného prehliadača. Ak `KeyboardEvent` nie je k dispozícii, príklad použije obyčajné objekty s rovnakými testovacími hodnotami. Iba Enter mimo skladania vypíše `run`. Príklad neodosiela udalosti ani neaktivuje skutočný IME.
Súvisiace lekcie
- JavaScript · Lekcia 41 · Stredne pokročilá · Verzia: 3