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

CKTIS / JavaScript

KeyboardEvent: hodnota klávesy a automatické opakování

Pomocí `key` zjistíš hodnotu klávesy a pomocí `repeat` odlišíš první stisk od automatického opakování při podržení.

Verze: ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

event.key     // string, read-only
 event.repeat  // boolean, read-only
new KeyboardEvent("keydown", { key: "Enter", repeat: true })

KeyboardEvent.key je vlastnost pouze pro čtení, jejíž hodnotou je řetězec, například "Enter", "a" nebo "A". Závisí na rozložení klávesnice a aktivních modifikátorech, jako je Shift. Na rozdíl od code, které označuje fyzickou polohu klávesy, se key může mezi událostmi změnit, pokud se změní stav modifikátoru.

KeyboardEvent.repeat je booleovská vlastnost pouze pro čtení. U skutečných událostí keydown má při prvním stisku hodnotu false a u následných událostí vyvolaných automatickým opakováním hodnotu true. Neříká, zda je klávesa právě stisknutá. Ne všechny klávesy se opakují a rychlost opakování závisí na prostředí.

Chceš-li akci provést jednou při každém stisku Enteru, ověř v obsluze keydown podmínku event.key === "Enter" && !event.repeat. Má-li se akce při podržení opakovat, nefiltruj události podle repeat.

KeyboardEvent patří mezi API webové platformy, nikoli do ECMAScriptu 2024. Nepředpokládej jeho dostupnost v každém běhovém prostředí JavaScriptu; ověř podporu v cílovém prostředí.

Příklady

{
  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 });
}

Výsledek

activate

Spusť kód v Node.js nebo v konzoli prohlížeče. Místo událostí klávesnice dostane obsluha přímo tři obyčejné objekty s vlastnostmi `key` a `repeat`. Jen pro první objekt vypíše `activate`; příklad ověřuje podmínku, ne rychlost opakování.

Související lekce

  • JavaScript · Lekce 34 · Středně pokročilá · Verze: 3
  • JavaScript · Lekce 35 · Středně pokročilá · Verze: 3
  • JavaScript · Lekce 38 · Středně pokročilá · Verze: 3

Zdroje