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