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-onlykey и 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