KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

KeyboardEvent: toetswaarde en automatische herhaling

Gebruik `key` voor de toetswaarde en `repeat` om de eerste toetsaanslag te onderscheiden van automatische herhalingen bij het ingedrukt houden.

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

Syntax

event.key     // string, read-only
 event.repeat  // boolean, read-only
new KeyboardEvent("keydown", { key: "Enter", repeat: true })

KeyboardEvent.key is een alleen-lezen eigenschap met een tekenreeks als "Enter", "a" of "A". De waarde hangt af van de toetsenbordindeling en actieve modificatietoetsen zoals Shift. Anders dan code, dat de fysieke toetspositie aangeeft, kan key tussen gebeurtenissen veranderen als de toestand van een modificatietoets verandert.

KeyboardEvent.repeat is een alleen-lezen booleaanse eigenschap. Bij echte keydown-gebeurtenissen is de waarde false bij de eerste aanslag en true bij latere gebeurtenissen door automatische herhaling. De waarde geeft niet aan of een toets op dit moment is ingedrukt. Niet alle toetsen worden herhaald en de herhaalsnelheid hangt af van de omgeving.

Controleer in de keydown-handler event.key === "Enter" && !event.repeat om een actie één keer per druk op Enter uit te voeren. Moet de actie zich herhalen zolang de toets ingedrukt blijft, filter dan niet op repeat.

KeyboardEvent is een API van het webplatform en geen onderdeel van ECMAScript 2024. Ga er niet van uit dat deze in elke JavaScript-runtime bestaat; controleer de ondersteuning in je doelomgeving.

Voorbeelden

{
  function handleKeydown(event) {
    if (event.key !== "Enter" || event.repeat) return;
    console.log("activate");
  }

  handleKeydown({ key: "Enter", repeat: false });
  handleKeydown({ key: "Enter", repeat: true });
  handleKeydown({ key: "Escape", repeat: false });
}

Resultaat

activate

Voer de code uit in Node.js of in de browserconsole. De handler krijgt rechtstreeks drie eenvoudige objecten met `key` en `repeat` in plaats van toetsenbordgebeurtenissen. De handler logt alleen bij het eerste object `activate`; dit test de voorwaarde, niet de herhaalsnelheid.

Gerelateerde lessen

  • JavaScript · Les 34 · Gemiddeld · Versie: 3
  • JavaScript · Les 35 · Gemiddeld · Versie: 3
  • JavaScript · Les 38 · Gemiddeld · Versie: 3

Bronnen