Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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-only

key 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

Zdroje