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.