Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

termo ou valor HTML: accesskey

O atributo `accesskey` fornece candidatos a atalho de teclado, mas navegador, sistema e disposição do teclado decidem a combinação real.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

<button accesskey="s">Save</button>

accesskey é um atributo global cujo valor é um conjunto ordenado de tokens de um caráter. A propriedade accessKey reflete o valor escolhido; o atributo por si não acrescenta função, foco ou ativação.

O token s pode ser candidato para Guardar, mas o autor não escolhe o modificador. accessKeyLabel não é uma forma portável de mostrar uma combinação pronta porque a implementação pode não o expor.

Usa atalhos com moderação: podem colidir com comandos do navegador, sistema, leitor de ecrã ou editor, dependem do idioma e teclado físico e são difíceis de descobrir. Um controlo visível deve continuar disponível.

O exemplo accesskey="s" lê accessKey e o limite accessKeyLabel; undefined neste Chromium documenta a ausência de etiqueta portável, não do candidato. O teste não simula um atalho do sistema.

Exemplos

<!doctype html><meta charset="utf-8"><button id="x" accesskey="s">Save</button><output id="result"></output><script>result.textContent=`key=${x.accessKey}; label=${x.accessKeyLabel}`;</script>

Resultado

key=s; label=undefined

O exemplo executado verifica a reflexão do token e o limite do ambiente; não afirma que foi atribuída uma combinação concreta.

Fontes