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.