Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje