CKTIS / JavaScript
Ein Element per ID finden und seinen `hidden`-Zustand ändern
Ein HTML-Element anhand seiner exakten ID finden, einen fehlenden Treffer behandeln und mit `hidden` das Attribut ändern, ohne das Element aus dem DOM zu entfernen.
Version: Current web platform; runtime support varies
Syntax
// These are web platform APIs, not ECMAScript 2024 features.
const element = document.getElementById(id);
if (element instanceof HTMLElement) {
element.hidden = true; // Set the hidden attribute.
element.hidden = false; // Remove the hidden attribute.
}
// Hidden Until Found depends on the browser's HTML implementation:
// element.hidden = "until-found";document.getElementById(id) sucht im Dokumentbaum. Übergib den ID-Wert selbst, ohne das CSS-Selektorpräfix #; Groß- und Kleinschreibung werden unterschieden. Die Methode liefert das erste passende Element in Baumreihenfolge oder null. IDs sollten eindeutig sein. Ein noch nicht eingefügtes Element wird nicht gefunden, ein verborgenes Element dagegen schon.
Prüfe das Ergebnis vor dem Zugriff auf .hidden: Das Lesen oder Setzen einer Eigenschaft auf null löst einen TypeError aus. Der Treffer kann auch ein Nicht-HTML-Element sein, etwa ein SVG-Element; instanceof HTMLElement prüft den Typ innerhalb derselben globalen Umgebung. Das sind APIs der Webplattform, keine Funktionen von ECMAScript 2024. Die separate, schreibgeschützte Eigenschaft document.hidden beschreibt die Sichtbarkeit des Dokuments, nicht die eines Elements.
HTMLElement.hidden spiegelt das HTML-Attribut hidden des Elements wider. Die Zuweisung von true setzt das Attribut auf einen leeren Wert, false entfernt es. Beim Lesen erhältst du false, wenn das Attribut fehlt, und true im normalen verborgenen Zustand; auch setAttribute("hidden", "false") verbirgt das Element. Wo "until-found" unterstützt wird, lässt sich diese Zeichenfolge setzen und lesen. Die Seitensuche oder die Navigation zu einem Fragment kann den Inhalt dann einblenden.
hidden entfernt den Knoten nicht und schützt keine vertraulichen Daten. Das Entfernen des Attributs garantiert keine Sichtbarkeit: CSS oder ein verborgener Vorfahr können das Element weiterhin verbergen. CSS-display kann außerdem das normale Ausblenden überschreiben.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>getElementById and hidden</title>
</head>
<body>
<script>
(() => {
const doc = document.implementation.createHTMLDocument();
const panel = doc.createElement("section");
panel.id = "notice";
console.log(doc.getElementById("notice") === null);
doc.body.appendChild(panel);
const match = doc.getElementById("notice");
if (!(match instanceof HTMLElement)) {
throw new Error("Expected an HTML element with id notice");
}
match.hidden = true;
console.log(`${match.hidden} ${match.hasAttribute("hidden")} ${doc.getElementById("notice") === match}`);
match.hidden = false;
console.log(`${match.hidden} ${match.hasAttribute("hidden")}`);
})();
</script>
</body>
</html>Ergebnis
true true true true false false
Speichere das Beispiel als HTML-Datei, öffne es im Browser und sieh in der Entwicklerkonsole nach. Das separate Dokument hält das Beispiel von der aktuellen Seite getrennt. Die drei Zeilen zeigen: vor dem Einfügen kein Treffer, nach dem Ausblenden weiterhin dasselbe Element und nach der Zuweisung von `false` kein Attribut mehr.
Zugehörige Lektionen
- JavaScript · Lektion 35 · Fortgeschritten · Version: 4