HTML DOM querySelector()Methode

Document 对象参考手册Dokumentobjekt

Beispiel

Ermitteln Sie das Element mit id="demo" im Dokument:

document.querySelector("#demo");

Selbst ausprobieren »

Definition und Verwendung

Die querySelector()-Methode gibt das erste Element im Dokument zurück, das dem angegebenen CSS-Selektor entspricht.

Hinweis:Die querySelector()-Methode gibt nur das erste Element zurück, das dem angegebenen Selektor entspricht. Wenn Sie alle Elemente zurückgeben möchten, verwenden Sie stattdessen die querySelectorAll()-Methode.

Weitere CSS-Selektoren finden Sie in unseremCSS-Selektor-Tutorialund in unseremCSS-Selektor-Referenzhandbuch。


Browser-Unterstützung

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

Methode
querySelector() 4.0 8.0 3.5 3.1 10.0


Syntax

document.querySelector(CSS-Selektoren)

Parameterwerte

Parameter Type Beschreibung
CSS-Selektor String Erforderlich. Gibt einen CSS-Selektor für ein oder mehrere übereinstimmende Elemente an. Sie können Elemente anhand ihrer ID, Klasse, Typ, Attribut, Attributwert usw. auswählen.

Bei mehreren Selektoren trennen Sie diese durch Kommas; es wird ein übereinstimmendes Element zurückgegeben.

Tipp:Weitere CSS-Selektoren finden Sie in unseremCSS-Selektor-Referenzhandbuch。

Technische Details

DOM-Version: Selectors Level 1 Dokumentobjekt
Rückgabewert: Das erste Element, das dem angegebenen CSS-Selektor entspricht. Wenn keine Übereinstimmungen gefunden werden, wird null zurückgegeben. Wenn ein ungültiger Selektor angegeben wird, wird eine SYNTAX_ERR-Ausnahme ausgelöst.


Weitere Beispiele

Beispiel

Rufen Sie das erste <p>-Element im Dokument ab:

document.querySelector("p");

Selbst ausprobieren »

Beispiel

Rufen Sie das erste Element mit class="example" im Dokument ab:

document.querySelector(".example");

Selbst ausprobieren »

Beispiel

Rufen Sie das erste <p>-Element mit class="example" im Dokument ab:

document.querySelector("p.example");

Selbst ausprobieren »

Beispiel

Ermitteln Sie das erste <a>-Element im Dokument, das ein "target"-Attribut hat:

document.querySelector("a[target]");

Selbst ausprobieren »

Beispiel

Das folgende Beispiel demonstriert die Verwendung mehrerer Selektoren.

Angenommen, Sie wählen zwei Selektoren aus: die <h2>- und <h3>-Elemente.

Der folgende Code fügt dem ersten <h2>-Element im Dokument eine Hintergrundfarbe hinzu:

<h2>Ein h2-Element</h2>
<h3>Ein h3-Element</h3>

document.querySelector("h2, h3").style.backgroundColor = "red";

Selbst ausprobieren »

Wenn sich das <h3>-Element jedoch vor dem <h2>-Element im Dokument befindet, wird das <h3>-Element auf die angegebene Hintergrundfarbe gesetzt.

<h3>Ein h3-Element</h3>
<h2>Ein h2-Element</h2>

document.querySelector("h2, h3").style.backgroundColor = "red";

Selbst ausprobieren »


Verwandte

JavaScript-Referenzhandbuch:element.querySelector()


Document 对象参考手册Dokumentobjekt

Andere Erweiterungen