CKTIS / JavaScript
KeyboardEvent: vrednost tipke in stanje sestavljanja besedila
Z `key` prepoznaj vrednost tipke, z `isComposing` pa prepreči sprožitev tipkovne bližnjice, medtem ko način vnosa še sestavlja besedilo.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
event.key // string, read-only
event.isComposing // boolean, read-only
// event is a KeyboardEvent instance.
// To construct a synthetic event:
new KeyboardEvent("keydown", { key: "Enter", isComposing: true })event.key in event.isComposing sta lastnosti primerka KeyboardEvent, ki sta na voljo samo za branje. Spadata med spletne API-je, ne v ECMAScript 2024. Podpora je odvisna od izvajalnega okolja.
key je niz, ki upošteva razporeditev tipkovnice in modifikacijske tipke, na primer "a" ali "A" s tipko Shift pri običajni razporeditvi. Posebne tipke imajo poimenovane vrednosti, kot sta "Enter" in "Escape". Če brskalnik tipke ne prepozna, vrne "Unidentified". Za razliko od code vrednost key ne opisuje fizičnega položaja tipke. Za spremljanje sprememb besedila poslušaj dogodek input, namesto da besedilo sestavljaš iz pritiskov tipk.
isComposing je logična vrednost posameznega dogodka. Pri dogodku, ki ga ustvari brskalnik, je true, če se dogodek zgodi po compositionstart in pred compositionend. Urejevalnik načina vnosa (IME) lahko s tipko Enter potrdi predlog besedila. Zato v obdelovalniku keydown ne sproži bližnjice, če je isComposing enak true.
Na začetku ali koncu sestavljanja lahko vrstni red dogodkov povzroči, da je isComposing enak false, čeprav tipko obdeluje IME. Preizkusi kombinacije brskalnika in IME, ki jih podpiraš. Po potrebi uporabi event.keyCode === 229 kot zastarelo rezervno možnost za združljivost, ne kot splošno zagotovilo.
Primeri
{
const shouldRunShortcut = (event) =>
event.key === "Enter" && !event.isComposing;
for (const options of [
{ key: "Enter", isComposing: true },
{ key: "Enter", isComposing: false },
{ key: "Escape", isComposing: false },
]) {
// Without KeyboardEvent, test the predicate with a plain object.
const event = typeof KeyboardEvent === "function"
? new KeyboardEvent("keydown", options)
: options;
console.log(shouldRunShortcut(event) ? "run" : "skip");
}
}Rezultat
skip run skip
Zaženi primer v okolju Node.js ali v konzoli podprtega brskalnika. Če `KeyboardEvent` ni na voljo, primer uporabi navadne objekte z enakimi preizkusnimi vrednostmi. Samo Enter zunaj sestavljanja izpiše `run`. Primer ne razpošilja dogodkov in ne aktivira dejanskega IME.
Povezane lekcije
- JavaScript · Lekcija 41 · Srednja · Različica: 3