mitmario.dev

Inhalte und Attribute lesen

JavaScript Im Browser 3 Min Lesezeit 4 BeispieleLektion 5 von 7

Eine Karte trägt ihren Titel in einer Überschrift, ihre Stundenzahl in einem data--Attribut und ihr Ziel in einem Link. Gefunden hast du sie schnell. Aber jede Angabe liegt an einer anderen Stelle, und der Weg dorthin liefert manchmal etwas anderes, als du erwartest.

Drei Wege zum Inhalt

textContent, innerHTML und innerText
const box = document.getElementById("box");

// textContent ist der reine Text aller Nachfahren, auch der
// versteckten, mit dem Leerraum aus dem Markup. JSON.stringify
// macht den Leerraum sichtbar, wie in Lektion 10.3.
console.log("textContent:", JSON.stringify(box.textContent));

// innerHTML ist das Markup darin, als Text.
console.log("innerHTML:", JSON.stringify(box.innerHTML));

// innerText ist, was sichtbar ist. Das Versteckte fehlt, und
// der Leerraum ist zusammengefasst.
console.log("innerText:", JSON.stringify(box.innerText));

// Beim Lesen ist textContent die Wahl: es ist berechenbar
// und braucht kein Layout.
const betonung = document.querySelector("strong");
console.log("nur die Betonung:", betonung.textContent);

textContent liefert den reinen Text aller Nachfahren, ohne Tags. Versteckte Elemente zählen mit, und der Leerraum kommt genau so, wie er im Markup steht.

innerHTML liefert das Markup darin, als Text. Aus <strong>Betonung</strong> wird also genau dieser Text und nicht nur das Wort.

innerText liefert das, was sichtbar ist. Versteckte Elemente fehlen, und der Leerraum ist zusammengefasst. Dafür muss der Browser wissen, wie die Seite aussieht, also muss er erst das Layout berechnen.

Zum Lesen nehme ich textContent. Es ist berechenbar, braucht kein Layout und liefert das, wonach du fragst. innerText passt nur, wenn wirklich das Sichtbare gemeint ist, und das ist selten.

In der Eingabezeile der Console antwortet document.getElementById("box").textContent mit dem Zeilenumbruch und dem Einzug aus dem Markup, als \n geschrieben, und mit dem versteckten Span. Dasselbe mit .innerHTML bringt noch die Tags dazu. .innerText antwortet mit "Ein Satz mit Betonung darin.", ohne Umbruch, ohne Einzug und ohne das Versteckte. Das klappt hier, weil die Seite hinter dem Reiter Console ihr Layout behält, und für jede Antwort muss der Browser dieses Layout erst ausrechnen.

innerHTML beim Lesen ist harmlos. Beim Schreiben ist es das nicht, und warum, steht in Abschnitt 11 und noch einmal in Abschnitt 20.

Attribut oder Eigenschaft

Attribut oder Eigenschaft
const link = document.getElementById("link");

// getAttribute liefert, was wörtlich im Markup steht.
console.log("Attribut:", link.getAttribute("href"));

// Die Eigenschaft liefert die aufgelöste Adresse. Wie sie
// aussieht, hängt davon ab, unter welcher Adresse die Seite
// läuft, deshalb steht sie in keiner Prüfung dieses Kurses.
console.log("Eigenschaft:", link.href);

// Bei class heißt die Eigenschaft anders als das Attribut,
// weil class in JavaScript ein reserviertes Wort ist.
console.log("Attribut class:", link.getAttribute("class"));
console.log("Eigenschaft className:", link.className);

// Und bei einem Eingabefeld laufen die beiden auseinander,
// sobald jemand tippt. Das Attribut bleibt der Anfangswert,
// die Eigenschaft ist der aktuelle. Abschnitt 13 baut darauf auf.
const feld = document.getElementById("feld");
console.log("Attribut value:", feld.getAttribute("value"));
console.log("Eigenschaft value:", feld.value);

Für viele Attribute gibt es zwei Zugänge, und die liefern nicht immer dasselbe.

getAttribute("href") liefert, was wörtlich im Markup steht. Die Eigenschaft link.href liefert dagegen die aufgelöste Adresse, also den vollständigen Pfad samt Origin. Origin heißt die Kombination aus Protokoll, Domain und Port, etwa https://mitmario.dev. Wie der aussieht, hängt davon ab, unter welcher Adresse die Seite läuft, und deshalb kommt er in keiner Prüfung dieses Kurses vor.

Bei class heißen die beiden verschieden. Das Attribut ist class, die Eigenschaft className. Der Grund ist historisch, denn class ist in JavaScript ein reserviertes Wort.

Bei einem Eingabefeld ist das Attribut value der Anfangswert aus dem Markup und die Eigenschaft value der aktuelle Wert. Sobald jemand tippt, laufen die beiden auseinander, und wer das Attribut liest, bekommt immer noch den alten Stand. In Abschnitt 13 kommt es genau darauf an.

Ich nehme die Eigenschaft, wenn es eine gibt und der aktuelle Zustand gefragt ist. Für alles, was nur im Markup steht, nehme ich getAttribute.

Eigene Daten am Element

Eigene Daten mit data-
const karte = document.querySelector(".karte");

// Alles, was mit data- beginnt, landet in dataset.
console.log("dataset:", JSON.stringify({ ...karte.dataset }));

// Aus data-kurs-id wird kursId, die Bindestriche fallen weg,
// der nächste Buchstabe wird groß.
console.log("kursId:", karte.dataset.kursId);
console.log("kursStunden:", karte.dataset.kursStunden);

// Es ist immer Text. Auch wenn eine Zahl darin steht.
console.log("Typ:", typeof karte.dataset.kursStunden);
console.log("in Minuten:", Number(karte.dataset.kursStunden) * 60);

// Und auch ein false ist nur der Text "false", also
// truthy im Sinn von Lektion 3.3.
console.log("als Text:", karte.dataset.imBrowser);
console.log("richtig geprüft:", karte.dataset.imBrowser === "true");

Für eigene Angaben im Markup ist data- der vorgesehene Weg. Ein data-kurs-id="git" ist gültiges HTML, stört niemanden und ist in JavaScript sofort da.

Alle diese Attribute landen in dataset. Dabei wird der Name umgeschrieben. Die Bindestriche fallen weg, und der Buchstabe danach wird groß. Aus data-kurs-id wird dataset.kursId, dieselbe Umschreibung wie bei den CSS-Eigenschaften in Abschnitt 11.

Der Inhalt ist immer Text, auch wenn eine Zahl drinsteht. Zum Rechnen wandle ich ihn mit Number(...) aus Lektion 2.7 um, sonst hängt ein + die Zahlen aneinander.

Auch ein data-im-browser="false" ist der Text "false" und nicht der Wahrheitswert. Ein nichtleerer Text ist truthy im Sinn von Lektion 3.3, also ist if (karte.dataset.imBrowser) immer wahr. Verglichen wird deshalb ausdrücklich mit === "true".

Nach einer Klasse fragen

Klassen abfragen
const karte = document.querySelector(".karte");

// classList.contains fragt nach genau einer Klasse.
console.log("hervor:", karte.classList.contains("hervor"));
console.log("klein:", karte.classList.contains("klein"));

// classList ist außerdem eine Sammlung.
console.log("Anzahl:", karte.classList.length);
console.log("alle:", [...karte.classList]);

// className ist dagegen der ganze Text am Stück, und
// deshalb der falsche Weg für die Frage nach einer Klasse.
console.log("className:", karte.className);
console.log("naiv geprüft:", karte.className.includes("gross"));

// Das sieht richtig aus und trifft auch bei einer Klasse
// namens grossartig. Deshalb classList.contains.

classList.contains("hervor") fragt nach genau einer Klasse und liefert true oder false.

classList ist außerdem eine Sammlung von Klassen. Sie hat length, und mit den drei Punkten machst du ein Array daraus. In Abschnitt 11 kommen add, remove und toggle dazu.

className liefert dagegen alle Klassen als einen Text am Stück. Damit kann man arbeiten, aber für die Frage nach einer Klasse ist es der falsche Weg, denn className.includes("gross") trifft auch bei einer Klasse namens grossartig. Und so ein Fehler fällt erst auf, wenn jemand später eine Klasse dazunimmt.

In der Aufgabe liest jede von vier Funktionen eine Angabe aus derselben Karte, nämlich den Titel, die Stunden, das Linkziel und eine Klasse.

Zum Mitnehmen

textContent liefert den reinen Text, innerHTML das Markup als Text. getAttribute liest ein Attribut so, wie es im Markup steht, eigene Daten liegen als Text in dataset, und nach einer Klasse fragt classList.contains.

Jetzt du

Basis Konto, kostenlos

Zu 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 4 Beispielen zum Ausprobieren

    Steht hier, ohne Konto lesbar.

  • Aufgabe im Editor, direkt im Browser geprüft

    Öffnet sich mit dem Basis Konto.