Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

KeyboardEvent: vrijednost tipke i stanje sastavljanja teksta

Svojstvom `key` prepoznaj vrijednost tipke, a svojstvom `isComposing` spriječi pokretanje tipkovnog prečaca dok metoda unosa još sastavlja tekst.

Verzija: 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 i event.isComposing svojstva su instance KeyboardEvent namijenjena samo čitanju. Pripadaju web-platformi, a ne standardu ECMAScript 2024. Podrška ovisi o okruženju za izvršavanje.

key je znakovni niz koji uzima u obzir raspored tipkovnice i modifikacijske tipke, primjerice "a" ili "A" uz Shift na uobičajenom rasporedu. Posebne tipke imaju imenovane vrijednosti, poput "Enter" i "Escape". Ako preglednik ne prepozna tipku, vraća "Unidentified". Za razliku od code, key ne opisuje fizički položaj tipke. Za praćenje promjena teksta slušaj događaj input umjesto da rekonstruiraš tekst iz pritisaka tipki.

isComposing je logička vrijednost pojedinog događaja. Za događaj koji generira preglednik vrijednost je true ako se dogodi nakon compositionstart i prije compositionend. Uređivač metode unosa (IME) može tipkom Enter prihvatiti prijedlog teksta. Zato u obrađivaču događaja keydown nemoj pokrenuti prečac ako je isComposing jednak true.

Na početku ili kraju sastavljanja redoslijed događaja može dovesti do toga da je isComposing jednak false iako IME obrađuje tipku. Testiraj kombinacije preglednika i IME-a koje podržavaš. Po potrebi razmotri event.keyCode === 229 kao zastarjelo rješenje za kompatibilnost, a ne kao univerzalno jamstvo.

Primjeri

{
  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

Pokreni primjer u okruženju Node.js ili u konzoli podržanog preglednika. Ako `KeyboardEvent` nije dostupan, primjer koristi obične objekte s istim testnim vrijednostima. Samo Enter izvan sastavljanja ispisuje `run`. Primjer ne šalje događaje niti aktivira stvarni IME.

Povezane lekcije

  • JavaScript · Lekcija 41 · Srednje · Verzija: 3

Izvori