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

CKTIS / HTML

término o valor HTML: autofocus

El atributo `autofocus` pide al navegador que enfoque un elemento cuando queda disponible en el documento, un diálogo o un popover; no es una garantía ni una orden de desplazamiento.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

<input name="query" autofocus>

autofocus es un atributo booleano: importa su presencia, por lo que autofocus="false" también lo activa. El candidato debe superar los pasos de enfoque y pertenecer al ámbito de foco correspondiente.

En un diálogo, la petición se procesa cuando showModal() lo abre. Solo puede declararse un candidato en cada ámbito de foco; document.activeElement lo identifica tras completar correctamente los pasos de enfoque.

El foco automático puede mover al usuario sin aviso, cambiar el punto de lectura del lector de pantalla y abrir el teclado virtual. Úselo solo cuando la siguiente acción sea inequívoca y el título y las instrucciones ya estén disponibles.

El ejemplo pone autofocus solo en el primer campo: su propiedad vale true, la del segundo false y document.activeElement tiene el identificador first. Es un único candidato conforme.

Ejemplos

<!doctype html><meta charset="utf-8"><dialog id="d"><input id="first" autofocus><input id="second"></dialog><output id="result"></output><script>d.showModal();result.textContent=`first=${first.autofocus}; second=${second.autofocus}; active=${document.activeElement.id}`;</script>

Resultado

first=true; second=false; active=first

El ejemplo ejecutado verifica el foco del único candidato declarado al abrir un diálogo modal.

Fuentes