CKTIS / JavaScript
Búsqueda por ID y foco: getElementById() y activeElement
`document.getElementById(id)` busca un elemento por su identificador, mientras que `document.activeElement` indica dónde está el foco del teclado desde la perspectiva del documento.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
document.getElementById(id) // call: Element or null
document.activeElement // read-only property: Element or nulldocument.getElementById(id) es un método que busca un valor id en el árbol del documento en cuestión. Pasa el identificador tal cual, sin el prefijo # de los selectores CSS. La búsqueda distingue mayúsculas de minúsculas. El método devuelve un Element o null si no hay coincidencias. Los identificadores deben ser únicos dentro de un árbol; si hay duplicados, se devuelve la primera coincidencia en el orden del árbol.
La búsqueda excluye los nodos desconectados del documento y no entra en árboles del Shadow DOM ni en los documentos de elementos iframe. DocumentFragment, y por tanto ShadowRoot, tiene su propio método getElementById(); un Element normal no lo tiene. Comprueba si el resultado es null antes de usarlo o utiliza ?. si el elemento puede faltar.
document.activeElement es una propiedad de solo lectura, no un método. Devuelve el Element que representa el foco actual del teclado desde la perspectiva de ese documento. Si el foco está dentro de un árbol del Shadow DOM o de un documento incrustado, el documento exterior ve el anfitrión del Shadow DOM o el elemento iframe, respectivamente. Para ver qué hay dentro, lee activeElement en un ShadowRoot accesible o en el documento del marco si es del mismo origen. Si el foco se resuelve al propio documento, la propiedad devuelve su body o, en su defecto, documentElement si existe. Devuelve null cuando no hay elemento ni valor alternativo aplicable en el árbol consultado.
El foco no es la selección de texto, y buscar un elemento no le da el foco. Si target no es null, document.activeElement === target comprueba si se trata del mismo nodo. Vuelve a leer la propiedad después de un cambio de foco: un valor guardado no se actualiza por sí solo. Son API de la plataforma web, no funciones de ECMAScript 2024; un entorno sin DOM de navegador no tiene por qué ofrecer document.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>ID lookup and focus</title>
</head>
<body>
<script>
{
const other = document.createElement('input');
const target = document.createElement('input');
target.id = 'cktis-target';
document.body.append(other, target);
try {
const found = document.getElementById('cktis-target');
other.focus();
console.log(found === target);
console.log(found === document.activeElement);
found?.focus();
console.log(found === document.activeElement);
console.log(document.getElementById('CKTIS-target') === null);
} finally {
other.remove();
target.remove();
}
}
</script>
</body>
</html>Resultado
true false true true
Guarda el ejemplo como archivo HTML, ábrelo en una pestaña del navegador en primer plano y después consulta la consola del navegador. Si el navegador permite asignar el foco por código, las tres primeras líneas muestran que se encuentra el elemento, que al principio no tiene el foco y que después lo recibe. La última confirma que cambiar las mayúsculas impide la coincidencia.
Lecciones relacionadas
- JavaScript · Lección 18 · Avanzado · Versión: 4