CKTIS / JavaScript
KeyboardEvent: vrijednost tipke i stanje tipke Shift
`key` daje vrijednost tipke, a `shiftKey` govori je li Shift bio aktivan u trenutku događaja. Pomoću oba svojstva možeš razlikovati Enter od Shift+Enter.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
event.key // string, read-only
event.shiftKey // boolean, read-onlykey i shiftKey dva su svojstva instance KeyboardEvent dostupna samo za čitanje. event.key je niz znakova: sadrži tekstualni prikaz tipke koja proizvodi ispisivi znak ili unaprijed definiranu vrijednost za posebnu tipku, primjerice "Enter". Kod događaja koje generira preglednik na key utječu raspored tipkovnice i aktivne modifikacijske tipke. Ako je važan fizički položaj tipke, umjesto toga koristi event.code.
event.shiftKey je logička vrijednost: true ako je Shift bio aktivan u trenutku događaja, inače false. Opisuje taj događaj, a ne trenutačno stanje tipkovnice. Nemoj brkati event.key === "Shift", koji prepoznaje samu tipku Shift, sa svojstvom event.shiftKey, koje može biti true i za drugu tipku.
U funkciji za obradu događaja keydown, uvjet event.key === "Enter" && event.shiftKey prepoznaje Enter dok je Shift aktivan. Uvjet ne isključuje druge modifikacijske tipke. KeyboardEvent je web API, a ne dio ECMAScripta 2024; dostupnost ovisi o izvršnom okruženju.
Primjeri
{
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
Pokreni kôd u razvojnoj konzoli preglednika ili kao skriptu u okruženju Node.js. U pregledniku kôd stvara dva sintetička događaja `KeyboardEvent`, ali ih ne šalje. Ako konstruktor nije dostupan, kôd upotrebljava obične objekte koji oponašaju samo svojstva `key` i `shiftKey`. U oba objekta `key` ima vrijednost `"Enter"`. Za prvi je `shiftKey` izostavljen iz opcija pa ima vrijednost `false`; za drugi je postavljen na `true`. Samo drugi objekt zadovoljava uvjet.
Povezane lekcije
- JavaScript · Lekcija 40 · Srednje · Verzija: 3