CKTIS / JavaScript
KeyboardEvent: valor da tecla e repetição automática
Usa `key` para identificar o valor da tecla e `repeat` para distinguir o primeiro toque das repetições automáticas quando manténs a tecla premida.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
event.key // string, read-only
event.repeat // boolean, read-only
new KeyboardEvent("keydown", { key: "Enter", repeat: true })KeyboardEvent.key é uma propriedade só de leitura que devolve uma cadeia de caracteres como "Enter", "a" ou "A". O valor depende do esquema do teclado e dos modificadores ativos, como Shift. Ao contrário de code, que identifica a posição física da tecla, key pode mudar entre eventos se o estado de um modificador mudar.
KeyboardEvent.repeat é uma propriedade booleana só de leitura. Nos eventos keydown reais, vale false no primeiro toque e true nos eventos seguintes gerados pela repetição automática. Não indica se uma tecla está premida naquele momento. Nem todas as teclas se repetem e a frequência de repetição depende do ambiente.
Para executar uma ação uma só vez sempre que primes Enter, verifica event.key === "Enter" && !event.repeat no processador de keydown. Se a ação se deve repetir enquanto a tecla estiver premida, não filtres os eventos com base em repeat.
KeyboardEvent é uma API da plataforma Web, não faz parte do ECMAScript 2024. Não assumas que existe em todos os ambientes de execução de JavaScript; confirma o suporte no ambiente de destino.
Exemplos
{
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 });
}Resultado
activate
Executa o código em Node.js ou na consola do navegador. O processador recebe diretamente três objetos simples com as propriedades `key` e `repeat`, em vez de eventos de teclado. Só escreve `activate` para o primeiro objeto; o teste verifica a condição, não a frequência de repetição.
Lições relacionadas
- JavaScript · Lição 34 · Intermédio · Versão: 3
- JavaScript · Lição 35 · Intermédio · Versão: 3
- JavaScript · Lição 38 · Intermédio · Versão: 3