Vericode
Entrar

JavaScript Tema 8

El DOM

Funciona en el IDE online de web. Todo lo de esta sección funciona en el IDE online de web: pulsa Pruébalo en cualquier ejemplo y verás la página al lado del código, con la consola debajo. Sin instalar nada.

Cuando el navegador lee el HTML, construye con él un árbol de objetos, uno por cada elemento: es el DOM (Document Object Model). JavaScript no cambia el fichero HTML: cambia ese árbol, y el navegador pinta al momento lo que haya en él.

flowchart TD
    D["document"] --> H["html"]
    H --> HE["head"]
    H --> B["body"]
    HE --> T["title"]
    B --> H1["h1"]
    B --> UL["ul"]
    UL --> L1["li"]
    UL --> L2["li"]

Todo empieza en document, que es la página.

Seleccionar elementos#

Los ejemplos de este tema usan esta página:

HTML
<h1 id="titulo">Lista de la compra</h1>
<p class="nota">Pulsa Pruébalo en los ejemplos de abajo.</p>
<ul id="lista">
    <li>Pan</li>
    <li class="urgente">Leche</li>
    <li>Huevos</li>
</ul>

Para cambiar algo, primero hay que cogerlo. Se usan los mismos selectores que en CSS:

JavaScript
const titulo = document.querySelector("#titulo");           // el primero que cumpla el selector
const urgente = document.querySelector(".urgente");
const elementos = document.querySelectorAll("#lista li");   // todos los que lo cumplen
console.log(titulo.textContent);
console.log(`Hay ${elementos.length} cosas en la lista`);
for (const li of elementos) {
    console.log(li.textContent);
}
MétodoDevuelve
document.querySelector(selector)El primer elemento que cumple el selector, o null si no hay ninguno
document.querySelectorAll(selector)Todos, en una lista que se recorre con for … of
document.getElementById("titulo")El del id (sin #). La forma antigua, que se sigue viendo mucho

Cambiar el contenido#

JavaScript
const titulo = document.querySelector("#titulo");
titulo.textContent = "Mi lista de la compra";

const nota = document.querySelector(".nota");
nota.innerHTML = "Tienes <strong>3 cosas</strong> que comprar.";
PropiedadQué cambia
textContentEl texto de dentro. Lo que se le da es texto, aunque tenga < y >
innerHTMLEl HTML de dentro. Lo que se le da se lee como HTML

Atención

No pongas en innerHTML nada que haya escrito el usuario: si escribe <img src=x onerror="…">, ese código se ejecutaría en tu página. Para texto, siempre textContent.

Cambiar atributos, clases y estilos#

JavaScript
const urgente = document.querySelector(".urgente");
urgente.style.color = "crimson";           // un estilo, como en el atributo style
urgente.style.fontWeight = "bold";         // en camelCase: font-weight es fontWeight

const lista = document.querySelector("#lista");
lista.classList.add("marcada");            // añade una clase
lista.setAttribute("title", "Lo que falta en casa");
console.log(lista.getAttribute("id"));
console.log(urgente.classList.contains("urgente"));   // true
ParaCon
Un atributogetAttribute(nombre), setAttribute(nombre, valor), o directamente: imagen.src, enlace.href
Las clasesclassList.add(), .remove(), .toggle() (la pone si no está y la quita si está), .contains()
Un estilo sueltoelemento.style.propiedad

Mejor clases que style: el aspecto se queda en el CSS, y JavaScript solo dice qué clase toca.

Crear y borrar elementos#

JavaScript
const lista = document.querySelector("#lista");

const nuevo = document.createElement("li");   // un <li> nuevo, que aún no está en la página
nuevo.textContent = "Tomates";
lista.append(nuevo);                          // al final de la lista

const primero = document.createElement("li");
primero.textContent = "Café";
lista.prepend(primero);                       // al principio

document.querySelector(".urgente").remove();  // fuera la leche
MétodoHace
document.createElement("li")Crea un elemento, fuera de la página
padre.append(hijo)Lo mete al final del padre
padre.prepend(hijo)Lo mete al principio
elemento.remove()Lo quita de la página

Pintar una lista de datos#

Lo más habitual: tener los datos en un array y pintarlos en la página. Se vacía el contenedor y se crea un elemento por cada dato:

JavaScript
const productos = [
    { nombre: "Pan", precio: 1.2 },
    { nombre: "Leche", precio: 0.9 },
    { nombre: "Huevos", precio: 2.5 },
];

const lista = document.querySelector("#lista");
lista.textContent = "";   // vaciar
for (const p of productos) {
    const li = document.createElement("li");
    li.textContent = `${p.nombre}: ${p.precio.toFixed(2)} €`;
    lista.append(li);
}

Moverse por el árbol#

Desde un elemento se llega a sus vecinos:

JavaScript
const urgente = document.querySelector(".urgente");
console.log(urgente.parentElement.id);               // "lista": su padre
console.log(urgente.previousElementSibling.textContent);  // "Pan": el de antes
console.log(urgente.nextElementSibling.textContent);      // "Huevos": el de después
console.log(document.querySelector("#lista").children.length);  // 3: sus hijos

Errores frecuentes#

Mensaje o síntomaQué significaCómo se arregla
Uncaught TypeError: Cannot set properties of null (setting 'textContent')querySelector no ha encontrado nada: el selector está mal, o el script va antes del elementoRevisa el selector (con # o .) y pon el <script> al final del <body>
Uncaught TypeError: elementos.style is undefinedquerySelectorAll devuelve una lista, no un elementoRecórrela con for … of, o usa querySelector
getElementById("#titulo") da nullCon getElementById el id va sin #getElementById("titulo")
Se ve el HTML como texto (<strong>)Se ha usado textContent para meter HTMLinnerHTML, solo con texto que no venga del usuario
style.font-size da errorLas propiedades con guion se escriben en camelCasestyle.fontSize