CKTIS / JavaScript
KeyboardEvent: hodnota klávesu a stav klávesu Shift
`key` udáva hodnotu klávesu a `shiftKey` informuje, či bol pri udalosti aktívny Shift. Pomocou oboch vlastností rozlíšiš Enter od Shift+Enter.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
event.key // string, read-only
event.shiftKey // boolean, read-onlykey a shiftKey sú dve vlastnosti inštancie KeyboardEvent určené iba na čítanie. event.key je reťazec: obsahuje textovú reprezentáciu klávesu, ktorý vytvára tlačiteľný znak, alebo preddefinovanú hodnotu pre špeciálny kláves, napríklad "Enter". Pri udalostiach generovaných prehliadačom ovplyvňujú key rozloženie klávesnice a aktívne modifikačné klávesy. Ak záleží na fyzickej polohe klávesu, použi namiesto toho event.code.
event.shiftKey je logická hodnota: true, ak bol Shift pri udalosti aktívny, inak false. Opisuje danú udalosť, nie aktuálny stav klávesnice. Nezamieňaj event.key === "Shift", ktoré rozpozná samotný kláves Shift, s event.shiftKey, ktoré môže mať hodnotu true aj pri inom klávese.
V obsluhe udalosti keydown podmienka event.key === "Enter" && event.shiftKey rozpozná Enter s aktívnym Shiftom. Nevylučuje pritom iné modifikačné klávesy. KeyboardEvent je webové API, nie súčasť ECMAScriptu 2024; jeho dostupnosť závisí od prostredia, v ktorom sa kód spúšťa.
Príklady
{
const eventInits = [
{ key: "Enter" },
{ key: "Enter", shiftKey: true },
];
// Without KeyboardEvent, use plain objects to model just these two properties.
const events = eventInits.map((init) =>
typeof KeyboardEvent === "function"
? new KeyboardEvent("keydown", init)
: { key: init.key, shiftKey: init.shiftKey ?? false }
);
for (const event of events) {
const isShiftEnter = event.key === "Enter" && event.shiftKey;
console.log(`${event.key} | shiftKey=${event.shiftKey} | match=${isShiftEnter}`);
}
}Výsledok
Enter | shiftKey=false | match=false Enter | shiftKey=true | match=true
Spusť kód vo vývojárskej konzole prehliadača alebo ako skript v Node.js. V prehliadači vytvorí dve syntetické udalosti `KeyboardEvent`, ale neodošle ich. Ak konštruktor nie je dostupný, použije obyčajné objekty, ktoré napodobňujú iba vlastnosti `key` a `shiftKey`. V oboch objektoch má `key` hodnotu `"Enter"`. Pri prvom je `shiftKey` v možnostiach vynechané, takže má hodnotu `false`; pri druhom je nastavené na `true`. Podmienku spĺňa iba druhý objekt.
Súvisiace lekcie
- JavaScript · Lekcia 40 · Stredne pokročilá · Verzia: 3