WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Element: Nachfahren auswählen, Attribute prüfen und Rechtecke messen

Mit `querySelectorAll()` findest du passende Nachfahren, mit `hasAttribute()` prüfst du, ob ein Attribut vorhanden ist, und mit `getClientRects()` liest du die Layoutgeometrie aus. Keines dieser Ergebnisse zeigt für sich allein, ob das Element sichtbar ist.

Version: Current web platform; runtime support varies

Syntax

element.querySelectorAll(selectors) → NodeList
element.hasAttribute(name) → boolean
element.getClientRects() → DOMRectList

Die drei Methoden von Element beantworten unterschiedliche Fragen: Was passt im DOM, welches Attribut ist vorhanden und welche Rechtecke erzeugt das Layout? Sie gehören zur Webplattform, nicht zu ECMAScript 2024. Das Beispiel benötigt einen Browser mit DOM und Layout-Engine.

element.querySelectorAll(selectors) erwartet eine Zeichenkette mit einem CSS-Selektor oder einer Selektorliste. Die Methode liefert eine statische NodeList mit passenden Nachfahren in Dokumentreihenfolge, ohne das Element selbst. Ohne Treffer ist die Liste leer; ungültige Selektorsyntax löst eine DOMException namens SyntaxError aus. Änderungen am DOM ändern nicht, welche Knoten in der gespeicherten Liste stehen. Die Einträge verweisen weiterhin auf die ursprünglichen Knoten. Auch Vorfahren außerhalb des Elements können beim Selektorabgleich eine Rolle spielen; :scope > .card wählt nur seine direkten Kinder mit der Klasse .card. Übergib einen dynamischen Bezeichner an CSS.escape(), nicht den gesamten Selektor.

element.hasAttribute(name) prüft, ob dieses Element das benannte Attribut hat: Bei einem leeren Wert liefert die Methode ebenfalls true, bei einem fehlenden Attribut false. Sie liest weder den Wert noch prüft sie Nachfahren. Den Wert liest du mit getAttribute(name). Für die Prüfung nach Namensraum und lokalem Namen ohne Präfix verwendest du hasAttributeNS(namespace, localName).

element.getClientRects() benötigt keine Argumente. Für ein HTML-Element liefert die Methode normalerweise eine Sammlung von DOMRect-Objekten, je eines pro Fragment der CSS-Box bis zur Rahmenkante. Ein Inline-Element über mehrere Zeilen kann mehrere Rechtecke haben. Die Koordinaten sind in CSS-Pixeln relativ zum Viewport angegeben und berücksichtigen Scrollen. Miss nach Layoutänderungen erneut. Ein einziges umschließendes Rechteck erhältst du mit getBoundingClientRect().

display: none ergibt eine leere Rechtecksammlung, entfernt das Element aber nicht aus dem DOM und verhindert keinen Selektortreffer. Eine nicht leere Sammlung beweist keine Sichtbarkeit: Das Element kann außerhalb des Viewports liegen oder visibility: hidden haben. hasAttribute("hidden") prüft nur das HTML-Attribut, nicht den Darstellungszustand.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Element layout example</title>
</head>
<body>
<script>
(() => {
  const root = document.createElement("section");
  const shown = document.createElement("div");
  const hidden = document.createElement("div");
  shown.className = hidden.className = "card";
  shown.setAttribute("data-flag", "");
  shown.style.cssText = "display: block; width: 10px; height: 10px";
  hidden.style.display = "none";
  root.append(shown, hidden);
  document.body.append(root);

  try {
    const selector = ":scope > .card";
    const cards = root.querySelectorAll(selector);
    for (const card of cards) {
      console.log(`flag=${card.hasAttribute("data-flag")} boxes=${card.getClientRects().length}`);
    }
    hidden.remove();
    console.log(`saved=${cards.length} fresh=${root.querySelectorAll(selector).length}`);
  } finally {
    root.remove();
  }
})();
</script>
</body>
</html>

Ergebnis

flag=true boxes=1
flag=false boxes=0
saved=2 fresh=1

Speichere das Beispiel als HTML-Datei, öffne sie im Browser und prüfe die Ausgabe in der Browserkonsole. Beide Kinder passen: Das erste hat ein leeres `data-flag`-Attribut und ein Rechteck; dem zweiten fehlt das Attribut, und wegen `display: none` hat es keine Rechtecke. Nach dem Entfernen enthält die gespeicherte Liste weiterhin zwei Einträge, eine neue Abfrage aber nur einen.

Zugehörige Lektionen

  • JavaScript · Lektion 40 · Mittlere Stufe · Version: 3

Quellen