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-onlykey 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