CKTIS / JavaScript
KeyboardEvent: vrednost tipke in stanje tipke Shift
`key` poda vrednost tipke, `shiftKey` pa pove, ali je bila ob dogodku aktivna tipka Shift. Z obema lastnostma lahko ločiš Enter od Shift+Enter.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
event.key // string, read-only
event.shiftKey // boolean, read-onlykey in shiftKey sta lastnosti primerka KeyboardEvent, ki sta na voljo samo za branje. event.key je niz: vsebuje besedilni zapis tipke, ki ustvari natisljiv znak, ali vnaprej določeno vrednost za posebno tipko, na primer "Enter". Pri dogodkih, ki jih ustvari brskalnik, na key vplivajo razporeditev tipkovnice in aktivne modifikacijske tipke. Če šteje fizični položaj tipke, namesto tega uporabi event.code.
event.shiftKey je logična vrednost: true, če je bila ob dogodku aktivna tipka Shift, sicer false. Opisuje ta dogodek, ne trenutnega stanja tipkovnice. Ne zamenjuj izraza event.key === "Shift", ki prepozna samo tipko Shift, z lastnostjo event.shiftKey, ki je lahko true tudi pri drugi tipki.
V obravnavalniku dogodka keydown pogoj event.key === "Enter" && event.shiftKey prepozna Enter ob aktivni tipki Shift. Pogoj ne izključuje drugih modifikacijskih tipk. KeyboardEvent je spletni API in ni del ECMAScripta 2024; razpoložljivost je odvisna od izvajalnega okolja.
Primeri
{
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}`);
}
}Rezultat
Enter | shiftKey=false | match=false Enter | shiftKey=true | match=true
Zaženi kodo v razvijalski konzoli brskalnika ali kot skript v okolju Node.js. V brskalniku ustvari dva sintetična dogodka `KeyboardEvent`, vendar ju ne odpošlje. Če konstruktor ni na voljo, uporabi navadna objekta, ki posnemata samo lastnosti `key` in `shiftKey`. V obeh objektih je vrednost `key` enaka `"Enter"`. Pri prvem je `shiftKey` v možnostih izpuščen, zato ima vrednost `false`; pri drugem je nastavljen na `true`. Pogoj izpolni samo drugi objekt.
Povezane lekcije
- JavaScript · Lekcija 40 · Srednja · Različica: 3