Abschnitt 11 · Lektion 5
Elemente erstellen und einhängen
Aus einer Handvoll Daten soll eine Liste werden, Eintrag für Eintrag. In manchen Einträgen steht Text, der wie Markup aussieht. innerHTML könnte die Elemente bauen, allerdings mit der Lücke vom Anfang dieses Abschnitts. Sicher ist es, sie einzeln zu bauen.
Erzeugen und einhängen sind zwei Schritte
<ul id="liste"><li>Schon da</li></ul> body {
font-family: system-ui, sans-serif;
max-width: 40rem;
margin: 0;
padding: 1rem;
line-height: 1.6;
color: #1c1917;
}
.neu {
font-weight: 600;
} const liste = document.getElementById("liste");
// createElement erzeugt ein Element, das noch nirgends hängt.
const eintrag = document.createElement("li");
console.log("Elternteil vorher:", eintrag.parentElement);
// Füllen, solange es noch draußen ist.
eintrag.textContent = "Neu dazu";
eintrag.classList.add("neu");
eintrag.dataset.id = "neu";
// Erst jetzt in den Baum.
liste.append(eintrag);
console.log("Elternteil nachher:", eintrag.parentElement.tagName);
console.log("Einträge:", liste.children.length);
// append nimmt auch reinen Text und mehrere Sachen auf einmal.
const zweiter = document.createElement("li");
zweiter.append("Text ohne Umweg");
liste.append(zweiter, document.createElement("li"));
console.log("jetzt:", liste.children.length); document.createElement("li") erzeugt ein Element. Das gibt es danach als Objekt, aber es hat noch keinen Platz auf der Seite. Sein parentElement ist null. Zu sehen ist nichts. Sichtbar wird es erst im Baum, und liste.append(eintrag) hängt es als letztes Kind an.
Dass „kein Platz“ wörtlich gemeint ist, kannst du messen. In der Eingabezeile der Console antwortet document.createElement("li").getBoundingClientRect().width mit 0. Kein Platz, keine Breite. eintrag.getBoundingClientRect().width fragt das Element aus dem Beispiel nach dem Einhängen, und die Antwort ist eine echte Breite, in der schmalen Spalte 308. Dazwischen liegt nur das append. Kürzer geht es mit isConnected, eintrag.isConnected antwortet mit true, ein frisch erzeugtes Element mit false.
Ich fülle ein Element, solange es noch draußen ist, also Text, Klassen und Attribute, und hänge es erst danach ein. Schneller ist das kaum, denn der Browser zeichnet sowieso erst, wenn das Skript fertig ist. Aber so steht an einer Stelle, wie das Element aussieht, und an einer anderen, wo es hinkommt. Wer erst einhängt und dann füllt, kommt zum selben Ergebnis.
append nimmt außerdem mehrere Argumente auf einmal und auch reinen Text, ohne Umweg über einen Textknoten.
Ein Element hängt immer an genau einer Stelle. Rufst du append ein zweites Mal mit demselben Element auf, entsteht keine Kopie, sondern das Element wird umgehängt, und der Browser sagt dir dabei nichts.
Wohin genau
<ul id="liste">
<li id="mitte">Mitte</li>
</ul> body {
font-family: system-ui, sans-serif;
max-width: 40rem;
margin: 0;
padding: 1rem;
line-height: 1.6;
color: #1c1917;
} const liste = document.getElementById("liste");
const mitte = document.getElementById("mitte");
function neu(text) {
const el = document.createElement("li");
el.textContent = text;
return el;
}
// append und prepend hängen INNEN an, ans Ende oder an den Anfang.
liste.append(neu("ganz unten"));
liste.prepend(neu("ganz oben"));
// before und after hängen DANEBEN, als Geschwister.
mitte.before(neu("direkt davor"));
mitte.after(neu("direkt danach"));
for (const el of liste.children) {
console.log(el.textContent);
} Mit vier Methoden erreichst du jede Richtung. append hängt innen ans Ende, prepend innen an den Anfang. Beide arbeiten mit den Kindern des Elements, an dem du sie aufrufst. before und after hängen daneben, als Geschwister, und du rufst sie am Nachbarn auf und nicht am Elternteil. Das eine legt etwas in die Schachtel, das andere stellt es neben die Schachtel.
appendChild kommt in diesem Kurs nicht vor. Das ist der ältere Weg. Er kann nur ein einziges Element und keinen Text, und append kann alles, was er kann. In fremdem Code wirst du ihn trotzdem oft sehen, und mit einem Argument macht er dasselbe wie append.
Ein Muster im Markup statt im Code
<h1>Kurse</h1>
<template id="muster">
<article class="karte">
<h2 class="titel"></h2>
<p class="stunden"></p>
</article>
</template>
<div id="ziel"></div> body {
font-family: system-ui, sans-serif;
max-width: 40rem;
margin: 0;
padding: 1rem;
line-height: 1.6;
color: #1c1917;
}
h2 {
font-size: 1rem;
margin: 1rem 0 0.25rem;
}
p {
margin: 0 0 0.75rem;
} const muster = document.getElementById("muster");
const ziel = document.getElementById("ziel");
// Was in einem template steht, zeigt der Browser nicht an.
// Es liegt bereit, bis jemand es kopiert.
const daten = [
{ titel: "HTML", stunden: 13 },
{ titel: "JavaScript", stunden: 47 },
];
for (const eintrag of daten) {
// true heißt: mit allem, was darin steckt.
const karte = muster.content.firstElementChild.cloneNode(true);
karte.querySelector(".titel").textContent = eintrag.titel;
karte.querySelector(".stunden").textContent = `${eintrag.stunden} Stunden`;
ziel.append(karte);
}
console.log("Karten:", ziel.children.length);
// Ohne true bekommst du die leere Hülle ohne Inhalt.
const flach = muster.content.firstElementChild.cloneNode();
console.log("flach kopiert:", flach.outerHTML); Sobald ein neues Element mehr als zwei Zeilen hat, wird das Zusammenbauen im JavaScript unübersichtlich. Dafür gibt es <template>.
Was in einem template steht, zeigt der Browser nicht an. Es liegt nur bereit, und an den Inhalt kommst du über template.content. cloneNode(true) macht eine Kopie, die dann gefüllt wird. Ohne das true bekommst du nur das äußere Element ohne seinen Inhalt, mit true den ganzen Teilbaum.
Die Struktur steht damit im Markup. JavaScript setzt nur noch die Werte ein. Willst du das Aussehen der Karte ändern, musst du dafür kein JavaScript anfassen.
Text bleibt Text
innerHTML klebt Text zusammen, statt Elemente zu bauen. Kommt ein Wert aus einer Eingabe oder aus dem Netz, ist das die Lücke vom Anfang dieses Abschnitts. Und sie steckt ausgerechnet dort, wo man sie am leichtesten übersieht, mitten in einer Schleife über fremde Daten.
Mit createElement und textContent kann das nicht passieren. Ein Text, der wie Markup aussieht, bleibt Text. Deshalb baut dieser Kurs Listen so, und in Lektion 11.7 wird daraus ein festes Muster.
In der Aufgabe machst du aus drei Werten drei Einträge, und einer davon sieht aus wie Markup.
Zum Mitnehmen
createElement baut ein Element, das noch nirgends hängt, append, prepend, before und after hängen es ein. Text darin setzt textContent, damit wird daraus nie Markup.
Jetzt du
Basis Konto, kostenlosZu dieser Lektion gehört eine Aufgabe. Du schreibst den Code selbst, und nach jedem Lauf sagt dir eine Prüfliste, was schon stimmt.
Dafür brauchst du das Basis Konto. Es kostet nichts, und ein Passwort gibt es auch nicht.
Was in dieser Lektion steckt
-
Artikel mit 3 Beispielen zum Ausprobieren
Steht hier, ohne Konto lesbar.
-
Aufgabe im Editor, direkt im Browser geprüft
Öffnet sich mit dem Basis Konto.