Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

KeyboardEvent: wartość klawisza i stan Shift

`key` podaje wartość klawisza, a `shiftKey` informuje, czy Shift był aktywny w chwili zdarzenia. Użyj obu właściwości, aby odróżnić Enter od Shift+Enter.

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

Składnia

event.key      // string, read-only
 event.shiftKey // boolean, read-only

key i shiftKey to dwie właściwości tylko do odczytu obiektu KeyboardEvent. event.key jest napisem: dla klawisza drukowalnego zawiera jego reprezentację tekstową, a dla klawisza specjalnego przyjmuje ustaloną wartość, np. "Enter". W zdarzeniach generowanych przez przeglądarkę na key wpływają układ klawiatury i aktywne modyfikatory. Gdy liczy się fizyczne położenie klawisza, użyj event.code zamiast event.key.

event.shiftKey ma wartość logiczną: true, jeśli Shift był aktywny w chwili zdarzenia, w przeciwnym razie false. Opisuje to konkretne zdarzenie, a nie aktualny stan klawiatury. Nie myl event.key === "Shift", które wskazuje sam klawisz Shift, z event.shiftKey, które może mieć wartość true także dla innego klawisza.

W obsłudze keydown warunek event.key === "Enter" && event.shiftKey wykrywa Enter z aktywnym Shiftem. Nie wyklucza innych modyfikatorów. KeyboardEvent należy do API platformy webowej, a nie do ECMAScript 2024; dostępność zależy od środowiska uruchomieniowego.

Przykłady

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

Wynik

Enter | shiftKey=false | match=false
Enter | shiftKey=true | match=true

Uruchom kod w konsoli deweloperskiej przeglądarki lub jako skrypt w Node.js. W przeglądarce kod tworzy dwa syntetyczne zdarzenia `KeyboardEvent`, ale ich nie wysyła. Jeśli konstruktor jest niedostępny, kod używa zwykłych obiektów, które odwzorowują tylko `key` i `shiftKey`. W obu przypadkach `key` ma wartość `"Enter"` w obu obiektach. W pierwszym `shiftKey` ma wartość `false`, ponieważ pominięto je w opcjach, a w drugim ma wartość `true`. Tylko drugi obiekt spełnia warunek.

Powiązane lekcje

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

Źródła