KeyboardEvent key eigenschap

definitie en gebruik

de waarde van de key-eigenschap retourneert het kenmerk van de ingedrukte toets bij het gebeuren van een toetsenevenement.

het kenmerk van de toets is een string die de toetsenbordknop identificeert. De waarde die deze eigenschap kan retourneren, kan de volgende strings zijn:

  • enkele tekens (bijvoorbeeld "a", "W", "4", "+" of "$")
  • meerdere tekens (bijvoorbeeld "F1", "Enter", "HOME" of "CAPS LOCK")

opmerking:deze eigenschap is alleen leesbaar.

tip:Als je wilt weten of de "ALT", "CTRL", "META" of "SHIFT" toets is ingedrukt bij het gebeuren van een toetsenevenement, gebruik dan altKeyenctrlKeyenmetaKey of shiftKey eigenschappen.

voorbeeld

voorbeeld 1

verkrijg de ingedrukte toets bij het gebeuren van een toetsenevenement:

var x = event.key;

probeer het zelf

voorbeeld 2

Als de gebruiker de "A" toets indrukt, wordt er een tekst weergegeven:

var x = event.key;
// Als de ingedrukte toets "a" of "A" is (gebruik CapsLock of Shift), wordt er een tekst weergegeven.
if (x == "a" || x == "A") { 
  alert ("Je hebt de 'A' toets ingedrukt!");
}

probeer het zelf

syntaxis

event.key

technische details

teruggegeven waarde:

een string die de ingedrukte knop op de toetsenbord vertegenwoordigt.

mogelijke waarden:

  • enkele tekens (bijvoorbeeld "a", "W", "4", "+" of "$")
  • meerdere tekens (bijvoorbeeld "F1", "Enter", "HOME" of "CAPS LOCK")

opmerking:Wordt ongedefinieerd geretourneerd in Safari.

DOM versie: DOM Level 3

browserondersteuning

De cijfers in de tabel vermelden de eerste browserversie die de eigenschap volledig ondersteunt.

eigenschappen Chrome IE Firefox Safari Opera
toets 51.0 9.0 23.0 niet ondersteund 38.0

gerelateerde pagina's

HTML DOM referentiehandleiding:KeyboardEvent keyCode property

HTML DOM referentiehandleiding:KeyboardEvent which property

HTML DOM referentiehandleiding:KeyboardEvent charCode property