Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

KeyboardEvent: wartość klawisza i stan kompozycji tekstu

Użyj `key`, aby rozpoznać wartość klawisza, i `isComposing`, aby nie uruchamiać skrótu, gdy metoda wprowadzania tekstu nadal tworzy tekst.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

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 to właściwości tylko do odczytu obiektu KeyboardEvent. Należą do API platformy webowej, a nie do ECMAScript 2024; ich obsługa zależy od środowiska wykonawczego.

key to ciąg znaków uwzględniający układ klawiatury i modyfikatory, np. "a" lub "A" z Shift w typowym układzie. Klawisze specjalne mają ustalone wartości, np. "Enter" i "Escape". Jeśli przeglądarka nie rozpozna klawisza, zwraca "Unidentified". W przeciwieństwie do code, key nie opisuje fizycznej pozycji klawisza. Do obserwowania zmian tekstu nasłuchuj zdarzenia input, zamiast odtwarzać tekst z naciśnięć klawiszy.

isComposing to wartość logiczna przypisana do zdarzenia. W zdarzeniu wygenerowanym przez przeglądarkę ma wartość true, jeśli zdarzenie wystąpiło po compositionstart i przed compositionend. Edytor metod wprowadzania (IME) może użyć Enter do zatwierdzenia proponowanego tekstu, dlatego w obsłudze keydown nie uruchamiaj skrótu, gdy isComposing jest true.

Na początku lub końcu kompozycji kolejność zdarzeń może sprawić, że isComposing będzie false, mimo że klawisz obsługuje IME. Przetestuj docelowe kombinacje przeglądarki i IME. W razie potrzeby rozważ event.keyCode === 229 jako wycofywane obejście zgodności, a nie uniwersalną gwarancję.

Przykłady

{
  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");
  }
}

Wynik

skip
run
skip

Uruchom przykład w Node.js lub w konsoli obsługiwanej przeglądarki. Jeśli konstruktor `KeyboardEvent` jest niedostępny, kod używa zwykłych obiektów z tymi samymi danymi. Tylko Enter poza kompozycją daje `run`. Kod nie wysyła zdarzeń ani nie uruchamia rzeczywistego IME.

Powiązane lekcje

  • JavaScript · Lekcja 41 · Średniozaawansowany · Wersja: 3

Źródła