Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

key 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

Zdroje