mitmario.dev

Elemente finden

JavaScript Im Browser 4 Min Lesezeit 4 BeispieleLektion 2 von 7

Um mit einem Element zu arbeiten, musst du es erst mal haben. Auf einer Seite mit drei gleichen Karten ist „das zweite div“ aber keine Adresse. Die Adresse ist ein Selektor, derselbe wie im Stylesheet.

Zwei Methoden reichen

querySelector und querySelectorAll
// querySelector nimmt einen CSS-Selektor und liefert
// das erste passende Element.
console.log("erste Karte:", document.querySelector(".karte").className);
console.log("mit zwei Klassen:", document.querySelector(".karte.hervor").className);
console.log("mit id:", document.querySelector("#kopf").textContent);

// querySelectorAll liefert alle als NodeList.
const karten = document.querySelectorAll(".karte");
console.log("Anzahl:", karten.length);
console.log("zweite:", karten[1].className);
console.log("alle h2:", document.querySelectorAll("h2").length);

// Zusammengesetzte Selektoren gehen genauso.
console.log("Nachfahr:", document.querySelector(".karte h2").textContent);
console.log("Kind:", document.querySelectorAll(".karte > button").length);
console.log("Nicht:", document.querySelectorAll(".karte:not(.hervor)").length);

querySelector nimmt einen CSS-Selektor und liefert das erste passende Element. querySelectorAll liefert alle als NodeList.

Ein Selektor beschreibt, welche Elemente gemeint sind. Für diesen Abschnitt reichen fast immer fünf Formen.

  • h2 meint jedes Element dieses Typs, hier jede Überschrift zweiter Ordnung.
  • .karte mit Punkt meint jedes Element mit der Klasse karte, .karte.hervor eines mit beiden Klassen.
  • #kopf mit Raute meint das Element mit der id kopf.
  • .karte h2 mit Leerzeichen meint jedes h2 irgendwo in einer Karte, auch tief verschachtelt.
  • .karte > button mit spitzer Klammer meint nur einen Button, der direkt in der Karte steht.

Dazu kommt :not(...) für „alle außer diesen“. .karte:not(.hervor) sind also die Karten ohne die Klasse hervor. Kennst du den CSS-Kurs, kannst du hier alles benutzen, was dort zum Ansprechen vorkam. Für Sonderfälle gibt es ältere Methoden, aber keinen Fall, den diese beiden nicht abdecken.

Der Text in der Klammer ist in Selektor-Schreibweise. In querySelector(".karte") steht der Punkt für „Klasse“, wie im Stylesheet, und ohne ihn sucht der Browser nach einem Element namens karte, das es gar nicht gibt.

Zeigen und fragen

Welchen Tag, welche id und welche Klassen ein Element hat, zeigt der Inspector. Steht der Zeiger rechts neben dem Button der zweiten Karte, steht im Auskunftsstreifen div.karte.hervor. Vorn steht der Tag, dahinter die id mit Raute und alle Klassen mit Punkt, also genau die Schreibweise, die querySelector erwartet. Über der Kopfzeile steht entsprechend header#kopf, über der Überschrift einer Karte nur h2. Ein Klick friert die Auswahl ein, und dann läuft sie dir beim Bewegen des Zeigers nicht mehr weg.

Nach dem Klick steht im Streifen ein kleiner Chip mit $0, denn so heißt das festgehaltene Element in der Eingabezeile der Console. Dort antwortet $0 mit <div class="karte hervor">, $0.className mit "karte hervor" und document.querySelector(".karte.hervor") === $0 mit true. Der Selektor aus dem Streifen findet also das Element, auf das du gezeigt hast. In den Entwicklerwerkzeugen jedes Browsers heißt dasselbe Element ebenfalls $0, und ohne festgeklickte Auswahl ist es undefined.

Der ältere Weg

getElementById, der Sonderfall
// Diese beiden finden dasselbe Element.
console.log("mit Raute:", document.querySelector("#kopf").textContent);
console.log("ohne Raute:", document.getElementById("kopf").textContent);

// Der Unterschied ist genau ein Zeichen, und zwar an der
// Stelle, an der man es vergisst.
console.log("falsch herum:", document.getElementById("#kopf"));

// Es gibt auch getElementsByClassName und getElementsByTagName,
// beide mit einer Eigenheit. Sie liefern eine lebende
// HTMLCollection, die sich mitändert.
const alt = document.getElementsByTagName("p");
console.log("vorher:", alt.length);
document.body.append(document.createElement("p"));
console.log("nachher:", alt.length);

// querySelectorAll liefert dagegen eine Momentaufnahme.
const neu = document.querySelectorAll("p");
document.body.append(document.createElement("p"));
console.log("querySelectorAll bleibt:", neu.length);

getElementById gibt es weiterhin, und es ist der schnellste Weg, ein Element über seine id zu finden. Bei Seiten in der Größe, um die es hier geht, ist der Unterschied aber nicht messbar.

Vergessen wird dabei gern die Raute. getElementById will die id ohne #, querySelector will sie mit. Mischst du beides, bekommst du null und keinen Hinweis darauf, woran es lag.

Daneben gibt es getElementsByClassName und getElementsByTagName. Sie liefern eine HTMLCollection, also eine lebende Sammlung. Kommt später ein passendes Element dazu, taucht es dort von selbst auf. querySelectorAll liefert dagegen eine Momentaufnahme.

Das klingt nach einem Vorteil und ist meistens eine Überraschung, denn eine Sammlung, die sich beim Durchlaufen ändert, führt schnell in eine Endlosschleife. Im Kurs bleibt es deshalb bei den beiden query-Methoden, und bei getElementById, wenn ein Element eine id hat.

Eine NodeList ist kein Array

Eine NodeList ist kein Array
const karten = document.querySelectorAll(".karte");

// Das hier geht, Länge, Index, forEach und for...of.
console.log("length:", karten.length);
console.log("Index:", karten[0].textContent);
karten.forEach((karte) => console.log("forEach:", karte.textContent));

// Und das hier geht nicht, obwohl es so aussehen sollte.
console.log("map:", typeof karten.map);
console.log("filter:", typeof karten.filter);

// Array.from macht daraus ein echtes Array.
const alsListe = Array.from(karten);
console.log("jetzt map:", alsListe.map((k) => k.textContent));

// Die drei Punkte aus Lektion 7.6 tun dasselbe.
console.log("mit Spread:", [...karten].length);

Was querySelectorAll zurückgibt, sieht aus wie ein Array und ist keins. Es hat length, mit eckigen Klammern kommst du an einen Eintrag, und forEach und for...of funktionieren.

map, filter und reduce gibt es dort nicht. Das merkst du erst beim Ausführen. karten.map ist undefined, und der Aufruf scheitert mit TypeError: karten.map is not a function.

Array.from(karten) macht daraus ein echtes Array, und danach gilt der ganze Abschnitt 6. Die drei Punkte aus Abschnitt 7 tun dasselbe, [...karten].

In der Eingabezeile der Console siehst du den Unterschied schon an der Form der Antwort. karten antwortet mit NodeList {0: <div class="karte">, 1: <div class="karte">, 2: <div class="karte">}, also mit geschweiften Klammern und Nummern davor. alsListe antwortet mit (3) [<div class="karte">, <div class="karte">, <div class="karte">], mit eckigen Klammern und der Länge davor, wie jedes Array seit Abschnitt 6. karten.map antwortet mit undefined, alsListe.map mit ƒ map().

Mit dieser einen Zeile kannst du die Seite auswerten wie jede andere Datenquelle, und darauf baut die letzte Lektion dieses Abschnitts.

Einmal suchen, dann merken

Einmal suchen, dann merken
// Dreimal dieselbe Suche.
console.log(document.querySelector(".karte h2").textContent);
console.log(document.querySelector(".karte h2").tagName);
console.log(document.querySelector(".karte h2").className);

// Einmal suchen, in eine Variable, dann benutzen.
const ueberschrift = document.querySelector(".karte h2");
console.log(ueberschrift.textContent);
console.log(ueberschrift.tagName);

// Innerhalb eines Elements sucht man weiter, statt von
// document aus einen langen Selektor zu bauen.
const karte = document.querySelector(".karte");
console.log("in der Karte:", karte.querySelector("p").textContent);

Ich suche ein Element einmal, gebe ihm einen Namen und benutze danach den Namen. Dreimal document.querySelector(".karte h2") untereinander ist dreimal dieselbe Arbeit. Vor allem sind es dann drei Stellen, die du ändern musst, wenn sich der Selektor irgendwann einmal ändert.

In einem Element kannst du weitersuchen, statt von document aus einen immer längeren Selektor zu bauen. karte.querySelector("p") sucht nur in dieser Karte. Das liest sich besser, und so werden in Abschnitt 13 auch die Felder eines Formulars gelesen, mit formular.querySelector(…). Es ist derselbe Gedanke wie der Name für einen Zwischenschritt aus Abschnitt 2.

In der Aufgabe beantworten vier Funktionen Fragen an dieselbe Seite, jede auf einem anderen Weg.

Zum Mitnehmen

querySelector liefert das erste passende Element, querySelectorAll alle als NodeList, und beide nehmen einen CSS-Selektor. Eine NodeList hat kein map, erst Array.from macht daraus ein Array.

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.