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.