Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

HTMLElement.focus — programska nastavitev fokusa

Metoda focus() premakne fokus na element, ki ga lahko prejme. Spoznaj, kako se fokus razlikuje od klika, kako delujejo možnosti za pomikanje in prikaz fokusa ter kako preveriti rezultat.

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

Sintaksa

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

HTMLElement.focus nastavi fokus na element, če ga ta lahko prejme; ne izvede klika. Vrne undefined, ne pa kazalnika uspeha. V preprostem dokumentu rezultat preveriš z document.activeElement === element.

Element mora biti mogoče fokusirati. tabindex="-1" omogoča programsko fokusiranje običajnega elementa, ne da bi ga dodali v zaporedno navigacijo s tipko Tab. focus() ne zaobide omejitev za onemogočene elemente, elemente, ki so zaradi inert nedejavni, ali elemente, ki niso prikazani zaradi display: none.

Metoda privzeto pomakne stran tako, da je element viden; preventScroll: true to pomikanje prepreči. O prikazu indikatorja fokusa običajno odloča brskalnik. focusVisible: true zahteva njegov prikaz. Vidnega indikatorja ne odstrani, ne da bi zagotovil alternativo.

To je API standarda HTML, ne ECMAScript. Osnovni focus() podpirajo sodobni brskalniški pogoni; podporo možnosti posebej preveri v ciljnih brskalnikih. Node 24 ne potrjuje podpore brskalniškega API-ja. Primer metodo namenoma pokliče po dejanju uporabnika.

Primeri

<!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>

Rezultat

true

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri