CKTIS / JavaScript
Polja KeyboardEvent: pomen tipke, položaj in stanje
Razlikujte vrednost tipke od njenega fizičnega položaja ter preverite ponavljanje, stanje tipke Shift in sestavljanje besedila. Ta polja KeyboardEvent pomagajo obravnavati bližnjice, ne da bi zamenjali razporeditev tipkovnice z vnesenim besedilom.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
event.key; event.code; event.repeat; event.shiftKey; event.isComposingKeyboardEvent opisuje dogodke tipkovnice, kot sta keydown in keyup. Pet tukaj opisanih lastnosti (key, code, repeat, shiftKey in isComposing) je samo za branje, nekatere lastnosti, podedovane iz Event, na primer cancelBubble, pa omogočajo tudi pisanje. KeyboardEvent.key je niz, ki označuje pomen tipke ob upoštevanju razporeditve in modifikatorjev, na primer "z", "Z" ali "Enter". KeyboardEvent.code je niz, ki ne glede na razporeditev prepozna fizični položaj tipke: na tipkovnici QWERTZ se lahko "KeyY" pojavi skupaj z key: "Z". Za pomen tipke uporabite key, za upravljanje glede na položaj pa code.
KeyboardEvent.repeat je logična vrednost: true pomeni samodejno ponavljanje pritisnjene tipke, ne pa števila ponovitev. V obravnavalniku keydown lahko if (event.repeat) return; preskoči ponovljena dejanja. KeyboardEvent.shiftKey pove, ali je bil Shift aktiven ob dogodku; to ne pomeni, da se dogodek nanaša na Shift. Ob pritisku tipke Shift (keydown) je vrednost true; ob sprostitvi te tipke (keyup) lahko ostane true, če je druga tipka Shift še vedno pritisnjena.
KeyboardEvent.isComposing je logična vrednost, ki označuje dogodek med compositionstart in compositionend, na primer med sestavljanjem besedila z IME. Če pri vrednosti true preskočite bližnjice, zmanjšate motnje med sestavljanjem, vendar s tem ne zaznate vseh mejnih primerov IME: na začetku ali koncu sestavljanja je lahko vrednost false. Dogodki tipkovnice ne nadomestijo dogodka input za spremljanje sprememb besedila.
To so spletni API-ji brskalnika, ne funkcije določene izdaje ECMAScripta; Node 24 v repozitoriju ne dokazuje njihove razpoložljivosti. Preverite združljivost vsake lastnosti v ciljnih brskalnikih; MDN označuje repeat kot Baseline 2025, kar ne zagotavlja podpore v starejših različicah. Primer ustvari sintetični dogodek z izrecno določenimi vrednostmi: preveri dostop do polj, ne pa dejanskih pritiskov tipk ali delovanja IME.
Primeri
(() => {
const event = new KeyboardEvent("keydown", {
key: "Z",
code: "KeyY",
repeat: true,
shiftKey: true,
isComposing: false
});
const { key, code, repeat, shiftKey, isComposing } = event;
console.log(JSON.stringify({ key, code, repeat, shiftKey, isComposing }));
})();Rezultat
{"key":"Z","code":"KeyY","repeat":true,"shiftKey":true,"isComposing":false}Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.