Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

termine o valore HTML: autofocus

L’attributo `autofocus` chiede al browser di focalizzare un elemento quando diventa disponibile nel documento, in un dialogo o in un popover; non è né una garanzia né un comando di scorrimento.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

<input name="query" autofocus>

autofocus è un attributo booleano: conta la presenza, quindi anche autofocus="false" lo attiva. Un candidato deve superare i passi di messa a fuoco e appartenere al relativo ambito di focus.

Per un dialogo la richiesta viene elaborata quando showModal() lo apre. In ogni ambito di focus può essere dichiarato un solo candidato; document.activeElement lo indica dopo il buon esito dei passi di messa a fuoco.

Il focus automatico può spostare l’utente senza preavviso, cambiare la posizione di lettura dello screen reader e aprire la tastiera virtuale. Usalo solo con un passo successivo inequivocabile e contesto e istruzioni già disponibili.

L’esempio mette autofocus solo sul primo campo: la sua proprietà è true, quella del secondo è false e document.activeElement ha identificatore first. È un unico candidato conforme.

Esempi

<!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>

Risultato

first=true; second=false; active=first

L’esempio eseguito verifica il focus dell’unico candidato dichiarato quando si apre il dialogo modale.

Fonti