Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

HTMLElement.focus — impostare il focus in modo programmatico

Il metodo focus() sposta il focus su un elemento che può riceverlo. Scopri in cosa differiscono il focus e un clic, come funzionano le opzioni per lo scorrimento e l’indicatore di focus e come verificare il risultato.

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

Sintassi

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

HTMLElement.focus imposta il focus su un elemento se questo può riceverlo; non esegue un clic. Restituisce undefined, non un indicatore di successo. In un documento semplice, verifica il risultato con document.activeElement === element.

L’elemento deve poter ricevere il focus. tabindex="-1" rende un normale elemento focalizzabile in modo programmatico senza aggiungerlo alla navigazione sequenziale con Tab. focus() non aggira le restrizioni relative agli elementi disabilitati, a quelli resi inattivi da inert o a quelli non visualizzati a causa di display: none.

Per impostazione predefinita, il metodo scorre la pagina fino a portare l’elemento in vista; preventScroll: true impedisce questo scorrimento. Di norma è il browser a decidere se mostrare un indicatore di focus. focusVisible: true ne richiede la visualizzazione. Non rimuovere l’indicatore visibile senza fornire un’alternativa.

Questa è un’API dello standard HTML, non di ECMAScript. I motori dei browser attuali supportano focus() nella sua forma base; verifica separatamente il supporto delle opzioni nei browser di destinazione. Node 24 non dimostra il supporto dell’API del browser. L’esempio chiama intenzionalmente il metodo in seguito a un’azione dell’utente.

Esempi

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

Risultato

true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti