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

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.

Fontes