CKTIS / JavaScript
HTMLElement.focus — programové nastavení fokusu
Metoda focus() přesune fokus na prvek, který jej může přijmout. Zjistěte, jak se fokus liší od kliknutí, jak fungují možnosti posouvání a indikátoru fokusu a jak výsledek ověřit.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
element.focus();
element.focus({ preventScroll: true });
element.focus({ preventScroll: true, focusVisible: true });HTMLElement.focus nastaví fokus na prvek, pokud jej může přijmout; neprovede kliknutí. Vrací undefined, nikoli údaj o úspěchu. V jednoduchém dokumentu ověříte výsledek pomocí document.activeElement === element.
Prvek musí být možné zaměřit. tabindex="-1" umožňuje programově zaměřit běžný prvek, aniž by se přidal do sekvenční navigace klávesou Tab. focus() neobchází omezení pro zakázané prvky, prvky deaktivované pomocí inert ani prvky nevykreslené kvůli display: none.
Ve výchozím nastavení metoda posune stránku tak, aby byl prvek viditelný; preventScroll: true tomuto posouvání zabrání. O zobrazení indikátoru fokusu obvykle rozhoduje prohlížeč. focusVisible: true požaduje jeho zobrazení. Viditelný indikátor neodstraňujte, aniž byste zajistili alternativu.
Jde o API standardu HTML, nikoli ECMAScriptu. Základní focus() podporují současné prohlížečové enginy; podporu možností ověřte zvlášť v cílových prohlížečích. Node 24 nepotvrzuje podporu prohlížečového API. Příklad záměrně volá metodu po akci uživatele.
Příklady
<!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>Výsledek
true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.