KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

MouseEvent: muisknoppen en modificatietoetsen

Lees welke muisknop bij een gebeurtenis hoort en of Ctrl, Meta, Shift of Alt actief was. Verwar de code `button` niet met het bitmasker `buttons`.

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

Syntax

event.button
event.ctrlKey
event.metaKey
event.shiftKey
event.altKey

button, ctrlKey, metaKey, shiftKey en altKey zijn alleen-lezen instantie-eigenschappen van MouseEvent. Lees ze uit op het gebeurtenisobject, bijvoorbeeld met event.button. Ze horen bij de web-API, niet bij ECMAScript 2024, dus hun beschikbaarheid hangt af van de uitvoeromgeving.

Bij gebeurtenissen voor het indrukken of loslaten van een knop, zoals mousedown en mouseup, geeft button de code van één knop: 0 primair (meestal links), 1 hulpknop (meestal midden), 2 secundair (meestal rechts), 3 vierde (doorgaans Terug), 4 vijfde (doorgaans Vooruit). Dit zijn rollen, geen fysieke posities. Bij mousemove kun je aan button niet betrouwbaar zien of een knop wordt ingedrukt gehouden. buttons is het bitmasker van ingedrukte knoppen: 0 betekent geen, en 1, 2, 4, 8, 16 staan respectievelijk voor de primaire, secundaire, hulp-, vierde en vijfde knop. (event.buttons & 1) !== 0 test het bit van de primaire knop.

ctrlKey staat voor Ctrl, metaKey voor Meta (Command op macOS, de Windows-toets op Windows), shiftKey voor Shift en altKey voor Alt (Option op macOS). Elke waarde is true als de gebeurtenis de toets als ingedrukt meldt, anders false. Dat is de toestand die in de gebeurtenis is vastgelegd, geen live uitlezing van het toetsenbord. Het besturingssysteem kan een handeling onderscheppen: op macOS kan Ctrl-klikken een contextmenu openen in plaats van een gewone click op te leveren. Een click bewijst op zichzelf niet dat er een muis is gebruikt: de gebeurtenis kan ook van het toetsenbord of van aanraking komen.

In new MouseEvent(type, options) krijgen weggelaten opties voor button en buttons standaard de waarde 0, en weggelaten modificatoropties false. Een synthetische gebeurtenis heeft isTrusted === false en levert niet de gebruikersactivering die sommige API’s vereisen.

Voorbeelden

// 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 }));
}

Resultaat

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

Voer de code uit in de browserconsole. Op de eerste regel staat `button: 1` voor de hulpknop en combineert `buttons: 6` de bits voor de secundaire knop (`2`) en de hulpknop (`4`). Op de tweede regel is `button: 0` de standaardwaarde, terwijl het masker alleen de secundaire knop aangeeft. Geen van beide gebeurtenissen wordt verzonden.

Gerelateerde lessen

  • JavaScript · Les 37 · Gevorderd · Versie: 4
  • JavaScript · Les 38 · Gevorderd · Versie: 4
  • JavaScript · Les 36 · Gemiddeld · Versie: 3
  • JavaScript · Les 37 · Gemiddeld · Versie: 3

Bronnen