CKTIS / JavaScript
Documento DOM: búsqueda por ID, elemento raíz y título
Busca un elemento por su ID exacto, accede al elemento raíz y lee o modifica el título del documento. Distingue un nodo ausente de una cadena vacía.
Versión: Current web platform; runtime support varies
Sintaxis
document.getElementById(id)
document.documentElement
document.title
document.title = valuedocument.getElementById(id) busca en el árbol de ese documento un elemento cuyo id coincida exactamente, distinguiendo entre mayúsculas y minúsculas. Pasa el ID tal cual, sin añadir #: el argumento no es un selector CSS. El método devuelve un Element o null; comprueba el resultado antes de acceder a las propiedades del elemento. Los ID deben ser únicos dentro del árbol. Si hay duplicados, el método devuelve la primera coincidencia en el orden del árbol.
La búsqueda usa el árbol tal como está en el momento de la llamada. No encuentra elementos que aún no se hayan insertado en el documento ni elementos de un árbol shadow separado. document.documentElement es de solo lectura: devuelve el elemento raíz, normalmente html en un documento HTML, o null si no hay raíz. No es document.body.
document.title es una propiedad de tipo cadena que se puede leer y escribir. No es el nodo title, el atributo title de un elemento ni un encabezado visible. En un documento HTML típico, la lectura elimina los caracteres de espacio en blanco ASCII de los extremos y reduce cada secuencia interna a un solo espacio. Si no hay un elemento title, devuelve "". La asignación reemplaza el contenido del título con texto, no con marcado HTML. Si falta title, lo crea en head si existe; de lo contrario, no hace nada. Si la raíz es un svg del espacio de nombres SVG, la asignación actualiza o crea un hijo directo title de SVG, del que se lee el título.
Los estándares DOM y HTML definen estas API de la plataforma web. Usarlas no requiere ECMAScript 2024. En un documento mostrado en una pestaña del navegador, el título suele aparecer en la etiqueta de la pestaña. Un entorno sin DOM no tiene por qué proporcionar document.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>DOM document example</title>
</head>
<body>
<script>
{
const doc = document.implementation.createHTMLDocument("Draft");
const item = doc.createElement("p");
item.id = "status";
console.log(doc.title);
console.log(doc.getElementById("status") === null);
doc.body.append(item);
console.log(doc.getElementById("status") === item);
console.log(doc.getElementById("Status") === null);
console.log(doc.documentElement.localName);
doc.title = " Ready to publish ";
console.log(doc.title);
}
</script>
</body>
</html>Resultado
Draft true true true html Ready to publish
Guarda el ejemplo completo como archivo HTML, ábrelo en un navegador y revisa la consola de las herramientas de desarrollo. Crea un documento HTML separado, por lo que no cambia la página actual ni el título de la pestaña. Los tres valores `true` muestran, en orden, que no hay coincidencia antes de insertar el elemento, que se obtiene el mismo objeto después y que se distinguen mayúsculas y minúsculas.
Lecciones relacionadas
- JavaScript · Lección 38 · Avanzado · Versión: 4