CKTIS / JavaScript
KeyboardEvent: hodnota klávesu a automatické opakovanie
Pomocou `key` zistíš hodnotu klávesu a pomocou `repeat` rozlíšiš prvé stlačenie od automatického opakovania pri podržaní.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
event.key // string, read-only
event.repeat // boolean, read-only
new KeyboardEvent("keydown", { key: "Enter", repeat: true })KeyboardEvent.key je vlastnosť iba na čítanie, ktorej hodnotou je reťazec, napríklad "Enter", "a" alebo "A". Závisí od rozloženia klávesnice a aktívnych modifikátorov, ako je Shift. Na rozdiel od code, ktoré označuje fyzickú polohu klávesu, sa key môže medzi udalosťami zmeniť, ak sa zmení stav modifikátora.
KeyboardEvent.repeat je booleovská vlastnosť iba na čítanie. Pri skutočných udalostiach keydown má pri prvom stlačení hodnotu false a pri následných udalostiach vyvolaných automatickým opakovaním hodnotu true. Nehovorí, či je kláves práve stlačený. Nie všetky klávesy sa opakujú a rýchlosť opakovania závisí od prostredia.
Ak chceš akciu vykonať raz pri každom stlačení klávesu Enter, v obsluhe keydown over podmienku event.key === "Enter" && !event.repeat. Ak sa má akcia pri podržaní opakovať, nefiltruj udalosti podľa repeat.
KeyboardEvent patrí medzi API webovej platformy, nie do ECMAScriptu 2024. Nepredpokladaj jeho dostupnosť v každom prostredí na spúšťanie JavaScriptu; over podporu v cieľovom prostredí.
Prí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ýsledok
activate
Spusť kód v Node.js alebo v konzole prehliadača. Funkcia na obsluhu dostane namiesto udalostí klávesnice priamo tri obyčajné objekty s vlastnosťami `key` a `repeat`. Len pre prvý objekt vypíše `activate`; príklad overuje podmienku, nie rýchlosť opakovania.
Súvisiace lekcie
- JavaScript · Lekcia 34 · Stredne pokročilá · Verzia: 3
- JavaScript · Lekcia 35 · Stredne pokročilá · Verzia: 3
- JavaScript · Lekcia 38 · Stredne pokročilá · Verzia: 3