HTML-DOM querySelectorAll()Methode

Document 对象参考手册Dokumentobjekt

Beispiele

Holen Sie alle Elemente mit class="example" im Dokument:

var x = document.querySelectorAll(".example");

Selbst ausprobieren »

Definition und Verwendung

Die Methode querySelectorAll() gibt alle Elemente im Dokument zurück, die den angegebenen CSS-Selektor(en) entsprechen, und gibt einNodeListNodeList-Objekt zurück.

Das NodeList-Objekt stellt eine Sammlung von Knoten dar. Es kann über einen Index zugegriffen werden, wobei die Indexwerte bei 0 beginnen.

Tipp:Sie können die length-Eigenschaft, um die Attribute von Elementen abzurufen, die dem Selektor entsprechen, und dann können Sie durch alle Elemente iterieren, um die gewünschten Informationen zu erhalten.

Weitere CSS-Selektoren finden Sie imCSS-Selektoren-Tutorial , CSS-Selektoren-Referenzhandbuch。


Browser-Unterstützung

Die Zahlen in der Tabelle geben die erste Browserversion an, die die Methode vollständig unterstützt.

Methode
querySelectorAll() 4.0 8.0 3.5 3.2 10.0

Hinweis:Internet Explorer 8 unterstützt CSS2-Selektoren. IE9 und spätere Browser unterstützen CSS3-Selektoren.


Syntax

elementList = document.querySelectorAll(selectors);
  • elementList ist ein statisches NodeList-Objekt.
  • selectors ist eine Zeichenfolge, die einen oder mehrere durch Kommas getrennte CSS-Selektoren enthält.

Parameterwerte

Parameter Type Beschreibung
CSS-Selektor String Erforderlich. Gibt ein oder mehrere Elemente an, die mit den CSS-Selektor(en) übereinstimmen. Elemente können mithilfe von id, class, type, attribute, attribute value usw. als Selektoren abgerufen werden.

Mehrere Selektoren werden durch Kommas (,) getrennt.

Tipp:Weitere Inhalte zu CSS-Selektoren finden Sie imCSS-Selektoren-Referenzhandbuch。

Methode

DOM-Version: Dokumentobjekt der Ebene 1
Rückgabewert: Ein NodeList-Objekt, das alle Elemente im Dokument repräsentiert, die mit den angegebenen CSS-Selektor(en) übereinstimmen. NodeList ist ein statisches NodeList-Objekt. Wenn der angegebene Selektor ungültig ist, wird eine SYNTAX_ERR-Ausnahme ausgelöst.

Weitere Beispiele

Beispiel

Alle <p>-Elemente im Dokument abrufen und die Hintergrundfarbe für das erste übereinstimmende <p>-Element (Index 0) festlegen:

//Alle <p>-Elemente im Dokument abrufen var x = document.querySelectorAll("p"); //Die Hintergrundfarbe des ersten <p>-Elements festlegen x[0].style.backgroundColor = "red";

Selbst ausprobieren »

Beispiel

Alle <p>-Elemente mit class="example" im Dokument abrufen und die Hintergrundfarbe für das erste übereinstimmende <p>-Element (Index 0) festlegen:

//Alle <p>-Elemente mit class="example" im Dokument abrufen var x = document.querySelectorAll("p.example"); //Die Hintergrundfarbe des ersten <p>-Elements mit class="example" festlegen x[0].style.backgroundColor = "red";

Selbst ausprobieren »

Beispiel

Zählen Sie die Anzahl der <p>-Elemente mit class="example" im Dokument (unter Verwendung der Eigenschaft length des NodeList-Objekts):

var x = document.querySelectorAll(".example").length;

Selbst ausprobieren »

Beispiel

Legen Sie die Hintergrundfarbe aller Elemente mit class="example" im Dokument fest:

var x = document.querySelectorAll(".example"); var i; for (i = 0; i < x.length; i++) { x[i].style.backgroundColor = "red"; }

Selbst ausprobieren »

Beispiel

Legen Sie die Hintergrundfarbe aller <p>-Elemente im Dokument fest:

var x = document.querySelectorAll("p"); var i; for (i = 0; i < x.length; i++) { x[i].style.backgroundColor = "red"; }

Selbst ausprobieren »

Beispiel

Finden Sie alle <a>-Tags im Dokument, die das Attribut "target" enthalten, und legen Sie einen Rahmen für sie fest:

var x = document.querySelectorAll("a[target]"); var i; for (i = 0; i < x.length; i++) { x[i].style.border = "10px solid red"; }

Selbst ausprobieren »

Beispiel

Finden Sie jedes <p>-Element, dessen übergeordnetes Element <div> ist, und legen Sie die Hintergrundfarbe für diese fest:

var x = document.querySelectorAll("div > p"); var i; for (i = 0; i < x.length; i++) { x[i].style.backgroundColor = "red"; }

Selbst ausprobieren »

Beispiel

Legen Sie die Hintergrundfarbe für alle <h2>-, <div>- und <span>-Elemente im Dokument fest:

var x = document.querySelectorAll("h2, div, span"); var i; for (i = 0; i < x.length; i++) { x[i].style.backgroundColor = "red"; }

Selbst ausprobieren »

Ähnliche Artikel

CSS-Tutorial:CSS-Selektoren

CSS-Referenzhandbuch:CSS-Selektoren-Referenz

JavaScript:JavaScript HTML-DOM-Knotenlisten

HTML-DOM-Referenz:document.querySelector

HTML-DOM-Referenz:element.querySelector()


Document 对象参考手册Dokumentobjekt

Andere Erweiterungen