KeyboardEvent#
Wstęp#
Interfejs KeyboardEvent stanowi rozszerzenie dla interfejsu UIEvent. Wprowadza dodatkowe polecenia, których zadaniem jest udostępnienie kontekstowych informacji dla zdarzeń, które potocznie nazywa się zdarzeniami klawiatury #. W specyfikacji D3E interfejs ten umieszczany jest w module zdarzeń klawiatury.
Interfejs KeyboardEvent dziedziczy z interfejsu UIEvent, dlatego ma dostęp do wszystkich poleceń z tego interfejsu (oraz z kolejnych interfejsów w łańcuchu dziedziczenia).
Zdarzenie klawiatury można utworzyć za pomocą poleceń:
Właściwości KeyboardEvent#
| Nazwa | Opis |
|---|---|
KeyboardEvent.altKey | Zwraca wartość true jeśli w czasie wysyłania danego zdarzenia klawisz modyfikujący Alt był aktywny, w przeciwnym razie wartość false. |
KeyboardEvent.code | Zwraca łańcuch znakowy reprezentujący wciśnięty klawisz bez modyfikacji, który spowodował wysłanie danego zdarzenia. |
KeyboardEvent.ctrlKey | Zwraca wartość true jeśli w czasie wysyłania danego zdarzenia klawisz modyfikujący Ctrl był aktywny, w przeciwnym razie wartość false. |
KeyboardEvent.isComposing | Zwraca wartość true jeśli dane zdarzenie jest częścią sesji kompozycji, w przeciwnym razie wartość false. |
KeyboardEvent.key | Zwraca łańcuch znakowy reprezentujący wciśnięty klawisz po modyfikacjach, który spowodował wysłanie danego zdarzenia. |
KeyboardEvent.location | Zwraca wartość liczbową reprezentującą lokalizację klawisza na urządzeniu wejściowym, który spowodował wysłanie danego zdarzenia. |
KeyboardEvent.metaKey | Zwraca wartość true jeśli w czasie wysyłania danego zdarzenia klawisz modyfikujący Meta był aktywny, w przeciwnym razie wartość false. |
KeyboardEvent.repeat | Zwraca wartość true jeśli klawisz dla danego zdarzenia był wciśnięty w sposób trwały, w przeciwnym razie wartość false. |
KeyboardEvent.shiftKey | Zwraca wartość true jeśli w czasie wysyłania danego zdarzenia klawisz modyfikujący Shift był aktywny, w przeciwnym razie wartość false. |
Metody KeyboardEvent#
| Nazwa | Opis |
|---|---|
KeyboardEvent.getModifierState() | Zwraca wartość true jeśli przekazany klawisz modyfikujący był aktywny w chwili wysyłania danego zdarzenia, w przeciwnym razie wartość false. |
KeyboardEvent.initKeyboardEvent() | Inicjuje dane zdarzenie. |
Stałe KeyboardEvent#
| Nazwa | Zapis dziesiętny | Zapis szesnastkowy | Znaczenie |
|---|---|---|---|
DOM_KEY_LOCATION_STANDARD # | 0 | 0 | Aktywacja klawisza nie może pochodzić ani od lewej ani od prawej lokalizacji klawisza, oraz (inny klawisz niż Przykład: klawisz |
DOM_KEY_LOCATION_LEFT # | 1 | 1 | Aktywacja klawisza pochodzi od lewej lokalizacji klawisza (jeśli jest możliwa więcej niż jedna lokalizacja dla tego klawisza). Przykład: lewy klawisz |
DOM_KEY_LOCATION_RIGHT # | 2 | 2 | Aktywacja klawisza pochodzi od prawej lokalizacji klawisza (jeśli jest możliwa więcej niż jedna lokalizacja dla tego klawisza). Przykład: prawy klawisz |
DOM_KEY_LOCATION_NUMPAD # | 3 | 3 | Aktywacja klawisza pochodzi z klawiatury numerycznej lub z wirtualnego odpowiednika klawisza dla klawiatury numerycznej (jeśli jest możliwa więcej niż jedna lokalizacja dla tego klawisza). Wyjątkiem będzie klawisz Przykład: klawisz |
Inne KeyboardEvent#
| Nazwa | Opis |
|---|---|
new KeyboardEvent() | Konstruktor tworzący nowe zdarzenie. |
Interfejs Web IDL#
[Constructor(DOMString typeArg, optional KeyboardEventInit keyboardEventInitDict)]
interface KeyboardEvent : UIEvent {
// Constants for location
const unsigned long DOM_KEY_LOCATION_STANDARD = 0x00;
const unsigned long DOM_KEY_LOCATION_LEFT = 0x01;
const unsigned long DOM_KEY_LOCATION_RIGHT = 0x02;
const unsigned long DOM_KEY_LOCATION_NUMPAD = 0x03;
readonly attribute DOMString key;
readonly attribute DOMString code;
readonly attribute unsigned long location;
readonly attribute boolean ctrlKey;
readonly attribute boolean shiftKey;
readonly attribute boolean altKey;
readonly attribute boolean metaKey;
readonly attribute boolean repeat;
readonly attribute boolean isComposing;
boolean getModifierState(DOMString keyArg);
void initKeyboardEvent(DOMString type, boolean bubbles, boolean cancelable,
Window? view, DOMString key, unsigned long location,
DOMString modifiersList, boolean repeat, DOMString locale);
};
dictionary KeyboardEventInit : UIEventInit {
DOMString key = "";
DOMString code = "";
unsigned long location = 0;
boolean ctrlKey = false;
boolean shiftKey = false;
boolean altKey = false;
boolean metaKey = false;
boolean repeat = false;
boolean isComposing = false;
DOMString locale = "";
};