CKTIS / HTML
termín nebo hodnota HTML: autofocus
Atribut `autofocus` žádá prohlížeč o zaměření prvku po jeho zpřístupnění v dokumentu, dialogu či popoveru; není zárukou ani příkazem k posunu.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<input name="query" autofocus>autofocus je booleovský atribut: rozhoduje přítomnost, takže jej zapíná i autofocus="false". Kandidát musí projít kroky zaměření a patřit do příslušného rozsahu fokusu.
U dialogu se požadavek zpracuje při otevření pomocí showModal(). V jednom rozsahu fokusu smí být deklarován jediný kandidát; po úspěšných krocích zaměření jej označí document.activeElement.
Automatický fokus může uživatele bez varování přesunout, změnit pozici čtení čtečky a otevřít virtuální klávesnici. Použij jej jen při jednoznačném dalším kroku, když jsou nadpis i pokyny již dostupné.
Příklad umístí autofocus jen na první pole: jeho vlastnost je true, vlastnost druhého false a document.activeElement má identifikátor first. Jde o jediného platného kandidáta.
Příklady
<!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>Výsledek
first=true; second=false; active=first
Spuštěný příklad ověřuje fokus jediného deklarovaného kandidáta při otevření modálního dialogu.