Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła