Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

HTMLElement.focus — programové nastavenie fokusu

Metóda focus() presunie fokus na prvok, ktorý ho môže prijať. Zistite, ako sa fokus líši od kliknutia, ako fungujú možnosti posúvania a indikátora fokusu a ako skontrolovať výsledok.

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

Syntax

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

HTMLElement.focus nastaví fokus na prvok, ak ho môže prijať; nevykoná kliknutie. Vráti undefined, nie údaj o úspechu. V jednoduchom dokumente skontrolujete výsledok pomocou document.activeElement === element.

Prvok musí byť možné zamerať. tabindex="-1" umožňuje programovo zamerať bežný prvok bez jeho pridania do sekvenčnej navigácie klávesom Tab. focus() neobchádza obmedzenia pre zakázané prvky, prvky deaktivované pomocou inert ani prvky, ktoré sa nevykresľujú pre display: none.

Predvolene metóda posunie stránku tak, aby bol prvok viditeľný; preventScroll: true tomuto posúvaniu zabráni. O zobrazení indikátora fokusu zvyčajne rozhoduje prehliadač. focusVisible: true požaduje jeho zobrazenie. Viditeľný indikátor neodstraňujte bez poskytnutia alternatívy.

Ide o API štandardu HTML, nie ECMAScriptu. Základné focus() podporujú súčasné prehliadačové enginy; podporu možností overte osobitne v cieľových prehliadačoch. Node 24 nepotvrdzuje podporu prehliadačového API. Príklad zámerne volá metódu po akcii používateľa.

Prí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ýsledok

true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje