Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

HTMLElement.focus — programowe ustawianie fokusu

Metoda focus() przenosi fokus na element, który może go otrzymać. Poznaj różnicę między fokusem a kliknięciem, opcje przewijania i wskaźnika fokusu oraz sposób sprawdzania wyniku.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

element.focus();
element.focus({ preventScroll: true });
element.focus({ preventScroll: true, focusVisible: true });

HTMLElement.focus ustawia fokus na elemencie, jeśli może on go otrzymać; nie wykonuje kliknięcia. Zwraca undefined, a nie informację o powodzeniu. W prostym dokumencie wynik sprawdzisz przez document.activeElement === element.

Element musi być fokusowalny. tabindex="-1" umożliwia programowe fokusowanie zwykłego elementu bez dodawania go do sekwencyjnej nawigacji klawiszem Tab. focus() nie omija ograniczeń elementów wyłączonych, nieaktywnych przez inert ani nierenderowanych przez display: none.

Domyślnie metoda przewija element do widoku; preventScroll: true zapobiega temu przewijaniu. O pokazaniu wskaźnika fokusu zwykle decyduje przeglądarka. focusVisible: true żąda jego pokazania. Nie usuwaj widocznego wskaźnika bez zapewnienia alternatywy.

To API standardu HTML, nie ECMAScript. Podstawowe focus() jest obsługiwane przez obecne silniki przeglądarek; obsługę opcji sprawdzaj osobno w docelowych przeglądarkach. Node 24 nie potwierdza obsługi przeglądarkowego API. Przykład celowo wywołuje metodę po działaniu użytkownika.

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Focus example</title>
<button id="move" type="button">Focus target</button>
<p id="target" tabindex="-1">Target</p>
<pre id="result"></pre>
<script>
  const move = document.getElementById('move');
  const target = document.getElementById('target');
  const result = document.getElementById('result');

  move.addEventListener('click', () => {
    target.focus({ preventScroll: true });
    result.textContent = String(document.activeElement === target);
  });
</script>
</html>

Wynik

true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła