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.