CKTIS / JavaScript
HTMLElement.focus — establecer el foco mediante programación
El método focus() mueve el foco a un elemento que puede recibirlo. Aprende en qué se diferencia el foco de hacer clic, cómo funcionan las opciones de desplazamiento e indicación del foco y cómo comprobar el resultado.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
element.focus();
element.focus({ preventScroll: true });
element.focus({ preventScroll: true, focusVisible: true });HTMLElement.focus establece el foco en un elemento si puede recibirlo; no realiza un clic. Devuelve undefined, no un indicador de éxito. En un documento sencillo, comprueba el resultado con document.activeElement === element.
El elemento debe poder recibir el foco. tabindex="-1" permite enfocar programáticamente un elemento normal sin añadirlo a la navegación secuencial con Tab. focus() no elude las restricciones de los elementos deshabilitados, los que están inactivos por inert ni los que no se muestran debido a display: none.
De forma predeterminada, el método desplaza la página para que el elemento quede a la vista; preventScroll: true evita ese desplazamiento. Normalmente, el navegador decide si muestra un indicador de foco. focusVisible: true solicita que se muestre. No elimines el indicador visible sin ofrecer una alternativa.
Esta es una API del estándar HTML, no de ECMAScript. Los motores de navegador actuales admiten focus() en su forma básica; comprueba por separado la compatibilidad de las opciones en los navegadores de destino. Node 24 no demuestra la compatibilidad con la API del navegador. El ejemplo invoca el método deliberadamente después de una acción del usuario.
Ejemplos
<!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>Resultado
true
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.