Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes