CKTIS / JavaScript
KeyboardEvent: hodnota klávesy a stav klávesy Shift
`key` udává hodnotu klávesy a `shiftKey` říká, zda byl při události aktivní Shift. Pomocí obou vlastností rozlišíš Enter od Shift+Enter.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
event.key // string, read-only
event.shiftKey // boolean, read-onlykey a shiftKey jsou dvě vlastnosti instance KeyboardEvent určené pouze ke čtení. event.key je řetězec: obsahuje textovou reprezentaci klávesy, která vytváří tisknutelný znak, nebo předem definovanou hodnotu pro speciální klávesu, například "Enter". U událostí vyvolaných prohlížečem ovlivňuje key rozložení klávesnice a stav modifikačních kláves. Pokud záleží na fyzické poloze klávesy, použij místo toho event.code.
event.shiftKey je logická hodnota: true, pokud byl Shift při události aktivní, jinak false. Popisuje danou událost, ne aktuální stav klávesnice. Nezaměňuj event.key === "Shift", které rozpozná samotnou klávesu Shift, s event.shiftKey, které může mít hodnotu true i u jiné klávesy.
V obsluze události keydown podmínka event.key === "Enter" && event.shiftKey rozpozná Enter s aktivním Shiftem. Nevylučuje přitom jiné modifikační klávesy. KeyboardEvent je webové API, nikoli součást ECMAScriptu 2024; jeho dostupnost závisí na běhovém prostředí.
Pří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ýsledek
Enter | shiftKey=false | match=false Enter | shiftKey=true | match=true
Spusť kód ve vývojářské konzoli prohlížeče nebo jako skript v Node.js. V prohlížeči vytvoří dvě syntetické události `KeyboardEvent`, ale neodešle je. Pokud konstruktor není dostupný, použije obyčejné objekty, které napodobují pouze vlastnosti `key` a `shiftKey`. V obou objektech má `key` hodnotu `"Enter"`. U prvního je `shiftKey` v možnostech vynecháno, a má tedy hodnotu `false`; u druhého je nastaveno na `true`. Podmínku splní pouze druhý objekt.
Související lekce
- JavaScript · Lekce 40 · Středně pokročilá · Verze: 3