CKTIS / JavaScript
DOM-Dokument: ID-Suche, Wurzelelement und Titel
Suche ein Element anhand seiner exakten ID, greife auf das Wurzelelement zu und lies oder ändere den Dokumenttitel. Ein fehlender Knoten ist kein leerer String.
Version: Current web platform; runtime support varies
Syntax
document.getElementById(id)
document.documentElement
document.title
document.title = valuedocument.getElementById(id) sucht im Baum des jeweiligen Dokuments nach einer exakten Übereinstimmung mit id. Groß- und Kleinschreibung sind relevant. Übergib die ID selbst, ohne ein # voranzustellen: Das Argument ist kein CSS-Selektor. Die Methode liefert ein Element oder null. Prüfe das Ergebnis, bevor du auf Eigenschaften des Elements zugreifst. IDs sollen innerhalb des Baums eindeutig sein. Bei Duplikaten liefert die Methode den ersten Treffer in Baumreihenfolge.
Die Suche berücksichtigt den Baum zum Zeitpunkt des Aufrufs. Sie findet weder Elemente, die noch nicht in das Dokument eingefügt wurden, noch Elemente in einem separaten Shadow-Baum. document.documentElement ist schreibgeschützt und liefert das Wurzelelement, in einem HTML-Dokument normalerweise html, oder null, wenn es kein Wurzelelement gibt. Es ist nicht document.body.
document.title ist eine les- und schreibbare Zeichenfolgeneigenschaft, nicht der title-Knoten, das title-Attribut eines Elements oder eine sichtbare Überschrift. Beim Lesen werden in einem typischen HTML-Dokument ASCII-Leerraumzeichen am Anfang und Ende entfernt und Folgen im Inneren durch je ein Leerzeichen ersetzt. Ohne title-Element ist das Ergebnis "". Eine Zuweisung ersetzt den Titelinhalt durch Text, nicht durch HTML-Markup. Fehlt title, wird es in head angelegt, sofern head existiert; andernfalls bleibt die Zuweisung wirkungslos. Bei einem svg-Wurzelelement im SVG-Namensraum aktualisiert oder erzeugt die Zuweisung ein direktes SVG-title-Kindelement, aus dem der Titel gelesen wird.
Diese APIs der Webplattform sind in den DOM- und HTML-Standards definiert. Ihre Verwendung setzt ECMAScript 2024 nicht voraus. Bei einem Dokument in einem Browser-Tab steht der Titel normalerweise auf dem Tab. Eine Umgebung ohne DOM muss document nicht bereitstellen.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>DOM document example</title>
</head>
<body>
<script>
{
const doc = document.implementation.createHTMLDocument("Draft");
const item = doc.createElement("p");
item.id = "status";
console.log(doc.title);
console.log(doc.getElementById("status") === null);
doc.body.append(item);
console.log(doc.getElementById("status") === item);
console.log(doc.getElementById("Status") === null);
console.log(doc.documentElement.localName);
doc.title = " Ready to publish ";
console.log(doc.title);
}
</script>
</body>
</html>Ergebnis
Draft true true true html Ready to publish
Speichere das gesamte Beispiel als HTML-Datei, öffne sie im Browser und prüfe die Ausgaben in der Entwicklerkonsole. Das Beispiel erstellt ein separates HTML-Dokument und ändert weder die aktuelle Seite noch den Tab-Titel. Die drei `true`-Werte zeigen der Reihe nach: keinen Treffer vor dem Einfügen, dasselbe Objekt nach dem Einfügen und die Unterscheidung von Groß- und Kleinschreibung.
Zugehörige Lektionen
- JavaScript · Lektion 38 · Fortgeschritten · Version: 4