CKTIS / JavaScript
KeyboardEvent.code — fysieke toets in plaats van teken
KeyboardEvent.code identificeert de fysieke positie van een toets, onafhankelijk van de toetsenbordindeling en modificatietoetsen. Ontdek het verschil tussen code en key en wanneer tekstinvoer en virtuele toetsenborden een andere aanpak vereisen.
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.codeKeyboardEvent.code is een alleen-lezen eigenschap die een fysieke toets identificeert met een tekenreeks. Lees de eigenschap uit via event.code, bijvoorbeeld in een keydown- of keyup-handler. Ze hoort bij de UI Events-web-API, niet bij ECMAScript zelf.
Namen als KeyQ, Digit2 en ShiftLeft beschrijven toetsposities, geen getypte tekens. KeyQ verwijst naar de positie van de Q-toets op een Amerikaanse indeling, ook wanneer een andere indeling aan die positie een andere letter toekent. ShiftLeft en ShiftRight maken onderscheid tussen de zijden van het toetsenbord.
In tegenstelling tot code beschrijft key de betekenis van de toets, rekening houdend met de indeling en modificatietoetsen. Kies code voor bediening op basis van positie en key voor de betekenis van de toets. Gebruik input om tekstbewerking te volgen, in plaats van tekst uit toetscodes na te bootsen.
De standaardwaarde van code is "". Virtuele toetsenborden hebben niet altijd een eenduidig equivalent van een fysieke toetspositie. Test de doelbrowsers en -apparaten; de aanwezigheid van Node 24 bewijst niet dat deze browser-API wordt ondersteund.
Het voorbeeld stelt code en key expliciet in bij synthetische gebeurtenissen. Het toont twee verschillende betekenissen bij dezelfde code; het test geen echte toetsenbordindeling en simuleert geen fysieke toetsaanslag.
Voorbeelden
const events = [
new KeyboardEvent("keydown", { code: "KeyQ", key: "q" }),
new KeyboardEvent("keydown", { code: "KeyQ", key: "Q", shiftKey: true })
];
for (const event of events) {
console.log(`${event.code} | ${event.key} | ${event.shiftKey}`);
}Resultaat
KeyQ | q | false KeyQ | Q | true
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.