KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

KeyboardEvent: toetswaarde en Shift-status

`key` geeft de toetswaarde, terwijl `shiftKey` aangeeft of Shift actief was toen de gebeurtenis plaatsvond. Gebruik beide eigenschappen om Enter van Shift+Enter te onderscheiden.

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

Syntax

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

key en shiftKey zijn twee alleen-lezen eigenschappen van een KeyboardEvent-object. event.key is een tekenreeks: de tekstuele weergave van een afdrukbare toets of een vooraf gedefinieerde waarde zoals "Enter" voor een speciale toets. Bij gebeurtenissen die de browser genereert, hebben de toetsenbordindeling en actieve modificatietoetsen invloed op key. Gebruik in plaats daarvan event.code als de fysieke positie van de toets telt.

event.shiftKey is een booleaanse waarde: true als Shift actief was toen de gebeurtenis plaatsvond, anders false. De waarde beschrijft die gebeurtenis, niet de huidige toestand van het toetsenbord. Verwar event.key === "Shift", dat de Shift-toets zelf herkent, niet met event.shiftKey, dat ook voor een andere toets true kan zijn.

In een keydown-handler herkent event.key === "Enter" && event.shiftKey Enter terwijl Shift actief is. De voorwaarde sluit andere modificatietoetsen niet uit. KeyboardEvent is een web-API en maakt geen deel uit van ECMAScript 2024; de beschikbaarheid hangt af van de uitvoeringsomgeving.

Voorbeelden

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

Resultaat

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

Voer de code uit in de ontwikkelaarsconsole van een browser of als script in Node.js. In de browser maakt de code twee synthetische `KeyboardEvent`-objecten aan zonder ze te versturen. Als de constructor niet beschikbaar is, gebruikt de code gewone objecten die alleen `key` en `shiftKey` nabootsen. In beide objecten is `key` gelijk aan `"Enter"`. Voor het eerste object is `shiftKey` weggelaten uit de opties en krijgt het de waarde `false`; voor het tweede wordt de waarde ingesteld op `true`. Alleen het tweede object voldoet aan de voorwaarde.

Gerelateerde lessen

  • JavaScript · Les 40 · Gemiddeld · Versie: 3

Bronnen