CKTIS / JavaScript
KeyboardEvent-velden: betekenis, positie en toetsstatus
Maak onderscheid tussen de waarde van een toets en de fysieke positie ervan, en bekijk herhaling, de Shift-status en tekstcompositie. Deze KeyboardEvent-velden helpen sneltoetsen afhandelen zonder de toetsenbordindeling met ingevoerde tekst te verwarren.
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; event.code; event.repeat; event.shiftKey; event.isComposingKeyboardEvent beschrijft toetsenbordgebeurtenissen zoals keydown en keyup. De vijf eigenschappen die hier aan bod komen (key, code, repeat, shiftKey en isComposing) zijn alleen-lezen, maar sommige eigenschappen die van Event worden geërfd, zoals cancelBubble, zijn beschrijfbaar. KeyboardEvent.key is een tekenreeks die de betekenis van de toets aangeeft, rekening houdend met de indeling en modificatietoetsen, zoals "z", "Z" of "Enter". KeyboardEvent.code is een tekenreeks die de fysieke positie van de toets identificeert, ongeacht de indeling: op een QWERTZ-toetsenbord kan "KeyY" samengaan met key: "Z". Gebruik key voor de betekenis van de toets en code voor besturing op basis van de positie.
KeyboardEvent.repeat is een booleaanse waarde: true geeft aan dat een ingedrukte toets automatisch wordt herhaald, niet hoeveel herhalingen er zijn. In een keydown-handler kan if (event.repeat) return; herhaalde acties overslaan. KeyboardEvent.shiftKey geeft aan of Shift actief was toen de gebeurtenis plaatsvond; het betekent niet dat de gebeurtenis zelf over Shift gaat. Bij het indrukken van een Shift-toets (keydown) is de waarde true; bij het loslaten (keyup) kan de waarde true blijven als de andere Shift-toets nog ingedrukt is.
KeyboardEvent.isComposing is een booleaanse waarde die aangeeft dat een gebeurtenis plaatsvindt tussen compositionstart en compositionend, bijvoorbeeld tijdens tekstcompositie via een IME. Sneltoetsen overslaan wanneer de waarde true is, vermindert verstoring van de compositie, maar vangt niet elk grensgeval met een IME op: aan het begin of einde van de compositie kan de waarde false zijn. Toetsenbordgebeurtenissen vervangen de input-gebeurtenis niet voor het bijhouden van tekstwijzigingen.
Dit zijn browser-Web-API's, geen functies van een bepaalde ECMAScript-editie; Node 24 in de repository toont niet aan dat ze beschikbaar zijn. Controleer de compatibiliteit van elke eigenschap met de doelbrowsers; MDN markeert repeat als Baseline 2025, wat ondersteuning in oudere versies niet garandeert. Het voorbeeld maakt een synthetische gebeurtenis met expliciete waarden: het controleert de toegang tot velden, niet echte toetsaanslagen of IME-gedrag.
Voorbeelden
(() => {
const event = new KeyboardEvent("keydown", {
key: "Z",
code: "KeyY",
repeat: true,
shiftKey: true,
isComposing: false
});
const { key, code, repeat, shiftKey, isComposing } = event;
console.log(JSON.stringify({ key, code, repeat, shiftKey, isComposing }));
})();Resultaat
{"key":"Z","code":"KeyY","repeat":true,"shiftKey":true,"isComposing":false}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.