KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

KeyboardEvent.key — de betekenis van een toets

KeyboardEvent.key is een alleen-lezen tekenreekseigenschap die de betekenis van een toets beschrijft. De eigenschap houdt rekening met de toetsenbordindeling en modifiers; anders dan code beschrijft ze niet de fysieke positie van de toets.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

event.key

KeyboardEvent.key, gelezen als event.key, geeft een tekenreeks terug die de betekenis van een toets beschrijft. Voor afdrukbare tekens houdt de eigenschap rekening met de toetsenbordindeling en modifiers, bijvoorbeeld "a" of "A". De eigenschap is alleen-lezen.

UI Events deelt benoemde toetswaarden in categorieën in: "Enter" staat bij de toetsen voor witruimtetekens, "Escape" bij de toetsen voor de gebruikersinterface en "ArrowDown" bij de navigatietoetsen. De spatiebalk heeft de waarde " ", niet "Space". "Dead" duidt een dode toets aan die wordt gebruikt om tekens samen te stellen; "Unidentified" betekent dat de toets niet kon worden geïdentificeerd. Vergelijkingen van tekenreeksen zijn hoofdlettergevoelig.

Gebruik key wanneer de betekenis van de toets ertoe doet, en code wanneer de fysieke positie ertoe doet. Zie toetsenbordgebeurtenissen niet als een volledige registratie van tekstinvoer; overweeg voor tekstbewerking de gebeurtenissen beforeinput en input.

Dit is een browser-Web-API die is gedefinieerd in UI Events, geen functie van een specifieke ECMAScript-editie. De aanwezigheid van Node 24 bewijst geen ondersteuning. Het voorbeeld stelt key en code expliciet in: de constructor berekent key niet op basis van code of shiftKey. Het test het uitlezen van waarden, niet een echt toetsenbord; ondersteuning in de beoogde browsers moet afzonderlijk worden gecontroleerd.

Voorbeelden

const events = [
  new KeyboardEvent("keydown", { key: "a", code: "KeyA" }),
  new KeyboardEvent("keydown", { key: "A", code: "KeyA", shiftKey: true }),
  new KeyboardEvent("keydown", { key: "Enter", code: "Enter" })
];

console.log(events.map(event => `${event.key}:${event.code}`).join("\n"));

Resultaat

a:KeyA
A:KeyA
Enter:Enter

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen