База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

KeyboardEvent: стойност на клавиша и състояние на Shift

`key` дава стойността на клавиша, а `shiftKey` показва дали Shift е бил активен при събитието. Използвай и двете свойства, за да различиш Enter от Shift+Enter.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

event.key      // string, read-only
 event.shiftKey // boolean, read-only

key и shiftKey са две свойства само за четене на екземпляр на KeyboardEvent. event.key е низ: съдържа текстовото представяне на клавиш, който въвежда печатаем знак, или предварително определена стойност за специален клавиш, например "Enter". При събития, генерирани от браузъра, върху key влияят клавиатурната подредба и активните модифициращи клавиши. Ако е важна физическата позиция на клавиша, използвай event.code вместо event.key.

event.shiftKey е булева стойност: true, ако Shift е бил активен при събитието, и false в противен случай. Тя описва конкретното събитие, а не текущото състояние на клавиатурата. Не бъркай event.key === "Shift", което разпознава самия клавиш Shift, с event.shiftKey, което може да е true и за друг клавиш.

В обработчик на keydown условието event.key === "Enter" && event.shiftKey разпознава Enter при активен Shift. То не изключва други модифициращи клавиши. KeyboardEvent е уеб API, а не част от ECMAScript 2024; наличността му зависи от средата за изпълнение.

Примери

{
  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}`);
  }
}

Резултат

Enter | shiftKey=false | match=false
Enter | shiftKey=true | match=true

Изпълни кода в конзолата за разработчици на браузъра или като скрипт в Node.js. В браузъра кодът създава две синтетични събития `KeyboardEvent`, без да ги изпраща. Ако конструкторът не е наличен, кодът използва обикновени обекти, които имитират само свойствата `key` и `shiftKey`. И в двата обекта `key` има стойност `"Enter"`. За първия `shiftKey` е пропуснато в опциите и получава стойност `false`, а за втория е зададено на `true`. Само вторият обект отговаря на условието.

Свързани уроци

  • JavaScript · Урок 40 · Средно · Версия: 3

Източници