CKTIS / HTML
termo ou valor HTML: autofocus
O atributo `autofocus` pede ao navegador que foque um elemento quando fica disponível no documento, num diálogo ou num popover; não é uma garantia nem um comando de deslocamento.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<input name="query" autofocus>autofocus é um atributo booleano: conta a presença, portanto autofocus="false" continua a ativá-lo. O candidato tem de cumprir os passos de foco e pertencer ao âmbito de foco relevante.
Num diálogo, o pedido é processado quando showModal() o abre. Só pode ser declarado um candidato em cada âmbito de foco; document.activeElement identifica-o após os passos de foco terem êxito.
O foco automático pode deslocar o utilizador sem aviso, alterar a posição de leitura do leitor de ecrã e abrir o teclado virtual. Usa-o apenas quando a ação seguinte é inequívoca e o título e as instruções já estão disponíveis.
O exemplo coloca autofocus apenas no primeiro campo: a sua propriedade é true, a do segundo é false e document.activeElement tem o identificador first. É um único candidato conforme.
Exemplos
<!doctype html><meta charset="utf-8"><dialog id="d"><input id="first" autofocus><input id="second"></dialog><output id="result"></output><script>d.showModal();result.textContent=`first=${first.autofocus}; second=${second.autofocus}; active=${document.activeElement.id}`;</script>Resultado
first=true; second=false; active=first
O exemplo executado verifica o foco do único candidato declarado ao abrir um diálogo modal.