Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje