CKTIS / HTML
termin lub wartość HTML: autofocus
Atrybut `autofocus` prosi przeglądarkę o ustawienie fokusu po udostępnieniu elementu w dokumencie, dialogu albo popoverze; nie jest gwarancją ani poleceniem przewijania.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<input name="query" autofocus>autofocus jest atrybutem logicznym: liczy się sama obecność, więc zapis autofocus="false" nadal oznacza stan włączony. Kandydat musi przejść algorytm ustawiania fokusu i należeć do właściwego zakresu fokusu.
W otwieranym oknie dialogowym żądanie jest rozpatrywane przy showModal(). W jednym zakresie fokusu wolno zadeklarować tylko jednego kandydata; document.activeElement wskazuje go po pomyślnym wykonaniu kroków ustawiania fokusu.
Automatyczny fokus może przenieść użytkownika bez zapowiedzi, zmienić punkt odczytu czytnika ekranu i otworzyć klawiaturę ekranową. Stosuj go tylko wtedy, gdy dalsze działanie jest jednoznaczne, a komunikaty i nagłówek kontekstu są już dostępne.
Przykład umieszcza autofocus tylko na pierwszym polu: jego właściwość ma wartość true, właściwość drugiego pola false, a document.activeElement ma identyfikator first. Jest to zgodny pojedynczy kandydat.
Przykłady
<!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>Wynik
first=true; second=false; active=first
Wykonany przykład potwierdza fokus jedynego zadeklarowanego kandydata po otwarciu modalnego dialogu.