Abschnitt 11 · Lektion 8
Synthese: die Kartenliste
Von allen Kursen sollen nur die auf die Seite, die schon laufen, sortiert und als Karten. Darunter steht ein Satz, wie viele es sind und wie viele Stunden sie zusammen haben. Dafür brauchst du alles aus diesem Abschnitt. Schwieriger als jede einzelne Zeile ist aber die Frage, wie sich die Arbeit auf Funktionen verteilt.
Drei Funktionen, drei Aufgaben
<h1>Kurse</h1>
<div id="ziel"></div>
<p id="fuss"></p> body {
font-family: system-ui, sans-serif;
max-width: 40rem;
margin: 0;
padding: 1rem;
line-height: 1.6;
color: #1c1917;
}
p {
margin: 0 0 0.75rem;
}
.karte {
padding: 0.75rem;
margin-bottom: 0.5rem;
border: 1px solid #d6d3d1;
border-radius: 6px;
}
.dauer {
display: block;
color: #57534e;
} const daten = [
{ id: "html", titel: "HTML", stunden: 13 },
{ id: "javascript", titel: "JavaScript", stunden: 47 },
];
// 1. Aus einem Datensatz ein Element. Kennt die Seite nicht.
function baueKarte(kurs) {
const karte = document.createElement("article");
karte.classList.add("karte");
karte.dataset.id = kurs.id;
const titel = document.createElement("h2");
titel.textContent = kurs.titel;
const dauer = document.createElement("span");
dauer.classList.add("dauer");
dauer.textContent = `${kurs.stunden} Stunden`;
karte.append(titel, dauer);
return karte;
}
// 2. Aus einer Liste eine Ansicht. Kennt das Ziel nur als Parameter.
function zeichne(liste, ziel) {
ziel.replaceChildren();
const sammler = document.createDocumentFragment();
for (const kurs of liste) {
sammler.append(baueKarte(kurs));
}
ziel.append(sammler);
}
// 3. Aus einer Liste ein Satz. Fasst gar nichts an.
function fasseZusammen(liste) {
const summe = liste.reduce((s, kurs) => s + kurs.stunden, 0);
return `${liste.length} Kurse, ${summe} Stunden zusammen`;
}
zeichne(daten, document.getElementById("ziel"));
document.getElementById("fuss").textContent = fasseZusammen(daten);
console.log(baueKarte(daten[0]).outerHTML);
console.log(fasseZusammen(daten)); Der Schnitt ist immer derselbe, und auf ihn kommt es mehr an als auf jede einzelne Zeile darin.
baueKarte(kurs) macht aus einem Datensatz ein Element und gibt es zurück. Sie sucht nichts auf der Seite und hängt nichts ein. Sie weiß nicht einmal, dass es eine Seite gibt.
zeichne(liste, ziel) kennt das Ziel, aber nur als Parameter. Sie leert, läuft über die Daten, sammelt und hängt einmal ein.
fasseZusammen(liste) rechnet und gibt einen Text zurück. Sie fasst gar nichts an.
Mit der Seite verbunden ist das Ganze nur über zwei Zeilen, den Aufruf von zeichne und die Zeile für #fuss. Alles darüber funktioniert unabhängig davon, wie die Seite aussieht.
Was eine Funktion verliert, die selbst einhängt
<div id="ziel"></div> body {
font-family: system-ui, sans-serif;
max-width: 40rem;
margin: 0;
padding: 1rem;
line-height: 1.6;
color: #1c1917;
} const daten = [{ id: "javascript", titel: "JavaScript" }];
// Diese Funktion baut UND hängt ein, beides in einer.
function baueUndHaenge(kurs) {
const karte = document.createElement("article");
karte.textContent = kurs.titel;
document.getElementById("ziel").append(karte);
}
baueUndHaenge(daten[0]);
// Der Preis dafür zeigt sich sofort: es gibt nichts zurück.
console.log("Rückgabe:", baueUndHaenge(daten[0]));
// Man kann sie nicht anderswo hinzeichnen lassen.
// Man kann sie nicht prüfen, ohne die Seite mitzudenken.
// Und man kann sie nicht in einem Fragment sammeln,
// denn sie hängt sich immer selbst in dasselbe Ziel.
console.log("Karten im Ziel:", document.getElementById("ziel").children.length); Im zweiten Beispiel steht dieselbe Sache falsch herum. Die Funktion baut und hängt ein. Sie funktioniert, verliert dabei aber vier Dinge auf einmal.
Sie gibt nichts zurück. Wer sie aufruft, bekommt undefined und kann mit dem Ergebnis nichts weiter anfangen.
Sie kann nur an eine Stelle zeichnen. Ein zweites Ziel, eine Seitenleiste oder ein Ausdruck gehen nicht, ohne die Funktion zu ändern.
Sie ist nicht prüfbar. baueKarte kannst du einzeln aufrufen und siehst, was zurückkommt. Bei dieser Fassung gäbe es dafür nichts.
Sie kann nicht sammeln. Das DocumentFragment aus Lektion 11.7 funktioniert nur, wenn jemand anders entscheidet, wohin das Element kommt.
In der Eingabezeile der Console siehst du den Unterschied in zwei Zeilen. Im ersten Beispiel antwortet baueKarte({ id: "sql", titel: "SQL", stunden: 6 }) mit <article class="karte">, und auf der Seite ändert sich nichts. Im zweiten antwortet baueUndHaenge({ titel: "PHP" }) mit undefined, und auf der Seite steht eine Karte mehr. Das eine ist eine Antwort, das andere eine Nebenwirkung. Zurück im ersten Beispiel antwortet fasseZusammen([]) mit "0 Kurse, 0 Stunden zusammen", ganz ohne Seite.
Eine Funktion, die etwas herstellt, lasse ich ihr Ergebnis zurückgeben, statt es selbst abzuliefern. In Lektion 20.2 geht es noch einmal darum, wenn Rechnen und Zeichnen getrennt werden.
Erst filtern, dann sortieren
<div id="ziel"></div> body {
font-family: system-ui, sans-serif;
max-width: 40rem;
margin: 0;
padding: 1rem;
line-height: 1.6;
color: #1c1917;
} const kurse = [
{ id: "javascript", titel: "JavaScript", status: "live" },
{ id: "typescript", titel: "TypeScript", status: "geplant" },
{ id: "css", titel: "CSS", status: "live" },
];
function zeichne(liste, ziel) {
ziel.replaceChildren();
// Erst auswählen, dann ordnen, dann bauen. Was wegfällt,
// muss niemand mehr sortieren.
const sichtbar = liste
.filter((kurs) => kurs.status === "live")
.sort((a, b) => a.titel.localeCompare(b.titel));
for (const kurs of sichtbar) {
const el = document.createElement("article");
el.dataset.id = kurs.id;
el.textContent = kurs.titel;
ziel.append(el);
}
}
zeichne(kurse, document.getElementById("ziel"));
console.log(document.getElementById("ziel").innerHTML);
// filter hat eine neue Liste gemacht, das Original ist unberührt.
console.log("Original:", kurse.map((k) => k.titel).join(", ")); Die Reihenfolge im dritten Beispiel ist Absicht, auswählen, ordnen, bauen. Zuerst kommt filter, denn was wegfällt, muss keiner mehr sortieren.
Dann kommt sort, und das verändert das Array, auf dem es aufgerufen wird. Hier ist das ungefährlich, weil filter schon eine neue Liste gemacht hat. Ohne Filter brauchst du vorher eine Kopie mit [...liste], sonst steht das Original hinterher anders da als vorher, und irgendwo im Programm verlässt sich jemand darauf, dass es noch die alte Reihenfolge hat.
Zuletzt wird gebaut und eingehängt.
Der Ausblick
Was hier steht, ist schon die halbe Anwendung. Bisher entscheidet der Code beim Laden, was gezeichnet wird, und danach passiert nichts mehr.
Im Abschlussprojekt am Ende des Kurses kommen die Klicks dazu. Die drei Funktionen sind sauber geschnitten, deshalb wird das kein Umbau. Es kommt eine Stelle dazu, die den Zustand ändert. Danach wird zeichne einfach noch einmal aufgerufen, und das data-id an jeder Karte ist dafür schon vorbereitet.
In der Aufgabe schreibst du die drei Funktionen für eine gefilterte Kartenliste mit einem Satz darunter.
Zum Mitnehmen
Drei Funktionen teilen sich die Arbeit. Eine baut aus einem Datensatz ein Element und gibt es zurück, eine zeichnet die Liste ins Ziel, eine rechnet den Satz darunter, und nur die zweite fasst die Seite an.
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.