CKTIS / JavaScript
MouseEvent: przycisk myszy i klawisze modyfikujące
Odczytaj przycisk związany ze zdarzeniem oraz stan klawiszy Ctrl, Meta, Shift i Alt. Odróżniaj kod `button` od maski bitowej `buttons`.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
event.button
event.ctrlKey
event.metaKey
event.shiftKey
event.altKeybutton, ctrlKey, metaKey, shiftKey i altKey to właściwości instancji MouseEvent dostępne tylko do odczytu. Odczytuj je z obiektu zdarzenia, np. event.button. Należą do API platformy webowej, nie do ECMAScript 2024, więc ich dostępność zależy od środowiska uruchomieniowego.
W zdarzeniach naciśnięcia lub zwolnienia przycisku, takich jak mousedown i mouseup, button jest kodem jednego przycisku: 0 — główny (zwykle lewy), 1 — pomocniczy (zwykle środkowy), 2 — dodatkowy (zwykle prawy), 3 — czwarty (zwykle Wstecz), 4 — piąty (zwykle Dalej). Są to role, nie położenia fizyczne. W zdarzeniu mousemove wartość button nie jest wiarygodnym wskaźnikiem wciśniętego przycisku. buttons to maska wciśniętych przycisków: 0 oznacza brak, a 1, 2, 4, 8, 16 odpowiadają kolejno przyciskowi głównemu, dodatkowemu, pomocniczemu, czwartemu i piątemu. Wyrażenie (event.buttons & 1) !== 0 sprawdza bit przycisku głównego.
ctrlKey oznacza Ctrl, metaKey — Meta (Command na macOS, klawisz Windows w Windows), shiftKey — Shift, a altKey — Alt (Option na macOS). Każda właściwość ma wartość true, jeśli zdarzenie zgłasza dany klawisz jako wciśnięty, w przeciwnym razie false. To stan zapisany w zdarzeniu, nie bieżący odczyt klawiatury. System może przejąć gest: na macOS Ctrl+kliknięcie może otworzyć menu kontekstowe zamiast dostarczyć zwykłe zdarzenie click. Samo click nie dowodzi użycia myszy: może pochodzić również z klawiatury lub ekranu dotykowego.
W new MouseEvent(type, options) pominięte opcje button i buttons mają wartość 0, a pominięte modyfikatory — false. Zdarzenie syntetyczne ma isTrusted === false i nie zapewnia aktywacji użytkownika wymaganej przez niektóre API.
Przykłady
// Use native MouseEvent in browsers. In Node.js, model only the fields read below.
const DemoMouseEvent = globalThis.MouseEvent ?? class extends Event {
constructor(type, {
button = 0, buttons = 0,
ctrlKey = false, metaKey = false, shiftKey = false, altKey = false,
} = {}) {
super(type);
const fields = { button, buttons, ctrlKey, metaKey, shiftKey, altKey };
for (const [key, value] of Object.entries(fields)) {
Object.defineProperty(this, key, { value });
}
}
};
for (const event of [
new DemoMouseEvent("mousedown", { button: 1, buttons: 6, ctrlKey: true, shiftKey: true }),
new DemoMouseEvent("mousemove", { buttons: 2, metaKey: true, altKey: true }),
]) {
const { type, button, buttons, ctrlKey, metaKey, shiftKey, altKey } = event;
console.log(JSON.stringify({ type, button, buttons, ctrlKey, metaKey, shiftKey, altKey }));
}Wynik
{"type":"mousedown","button":1,"buttons":6,"ctrlKey":true,"metaKey":false,"shiftKey":true,"altKey":false}
{"type":"mousemove","button":0,"buttons":2,"ctrlKey":false,"metaKey":true,"shiftKey":false,"altKey":true}Uruchom kod w konsoli przeglądarki. W pierwszym wierszu `button: 1` oznacza przycisk pomocniczy, a `buttons: 6` łączy bity przycisków dodatkowego (`2`) i pomocniczego (`4`). W drugim wierszu `button: 0` to wartość domyślna, a maska wskazuje tylko przycisk dodatkowy. Kod nie wysyła żadnego zdarzenia.
Powiązane lekcje
- JavaScript · Lekcja 37 · Zaawansowany · Wersja: 4
- JavaScript · Lekcja 38 · Zaawansowany · Wersja: 4
- JavaScript · Lekcja 36 · Średniozaawansowany · Wersja: 3
- JavaScript · Lekcja 37 · Średniozaawansowany · Wersja: 3
Źródła
- MouseEvent: button property
- MouseEvent: ctrlKey property
- MouseEvent: metaKey property
- MouseEvent: shiftKey property
- MouseEvent: altKey property
- MouseEvent: buttons property
- MouseEvent: MouseEvent() constructor
- Element: click event
- Event: isTrusted property
- HTML Standard: Tracking user activation
- ECMAScript 2024 Language Specification: Hosts and Implementations