HTML DOM querySelector()Methode

HTML 元素对象参考手册Element-Objekt

Beispiele

Ändern Sie den Textinhalt des ersten untergeordneten Elements des <div>-Elements mit class="demo":

var x = document.getElementById("myDIV"); x.querySelector(".demo").innerHTML = "Hello World!";

Selbst ausprobieren »

Definition und Verwendung

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

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

Für weitere CSS-Selektoren können Sie unserCSS-Selektoren-Tutorialund unsereCSS-Selektoren-Referenz besuchen。


Browser-Unterstützung

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

Methode
querySelector() 4.0 8.0 3.5 3.1 10.0


Syntax

element.querySelector(CSS-Selektor)

Parameterwerte

Parameter Type Beschreibung
CSS-Selektor String Erforderlich. Gibt einen oder mehrere CSS-Selektoren an, die mit dem Element übereinstimmen sollen. Sie können Elemente anhand ihrer ID, Klasse, Typ, Attribut, Attributwert usw. auswählen.

Bei mehreren Selektoren trennen Sie diese durch Kommas, und ein passendes Element wird zurückgegeben.

Tipp:Für weitere CSS-Selektoren lesen Sie bitte unsereCSS-Selektoren-Referenz。

Technische Details

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


Weitere Beispiele

Beispiele

Ändern Sie den Inhalt des ersten <p>-Elements innerhalb eines <div>-Elements:

var x = document.getElementById("myDIV");
x.querySelector("p").innerHTML = "Hello World!";

Selbst ausprobieren »

Beispiele

Ändern Sie den Inhalt des ersten untergeordneten Elements mit class="example" innerhalb eines <div>-Elements:

var x = document.getElementById("myDIV");
x.querySelector(".example").innerHTML = "Hello World!";

Selbst ausprobieren »

Beispiele

Ändere das erste <p>-Element mit class="example" in einem <div>-Element:

var x = document.getElementById("myDIV");
x.querySelector("p.example").innerHTML = "Hello World!";

Selbst ausprobieren »

Beispiele

Füge einen roten Rahmen zum ersten <a>-Element innerhalb eines <div>-Elements hinzu, das ein target-Attribut besitzt:

var x = document.getElementById("myDIV");
x.querySelector("a[target]").style.border = "10px solid red";

Selbst ausprobieren »

Beispiele

Die folgenden Beispiele demonstrieren die Verwendung mehrerer Selektoren.

Angenommen, Sie haben zwei Selektoren ausgewählt: die <h2>- und <h3>-Elemente.

Der folgende Code fügt dem ersten <h2>-Element in einem <div>-Element eine Hintergrundfarbe hinzu:

<div id="myDIV">
  <h2>Ein h2-Element</h2>
  <h3>Ein h3-Element</h3>
</div>

var x = document.getElementById("myDIV");
x.querySelector("h2, h3").style.backgroundColor = "red";

Selbst ausprobieren »

Wenn jedoch das <h3>-Element vor dem <h2>-Element innerhalb des <div>-Elements platziert wird, wird die angegebene Hintergrundfarbe auf das <h3>-Element gesetzt.

<div id="myDIV">
  <h3>Ein h3-Element</h3>
  <h2>Ein h2-Element</h2>
</div>

var x = document.getElementById("myDIV");
x.querySelector("h2, h3").style.backgroundColor = "red";

Selbst ausprobieren »


Verwandte

JavaScript-Referenz:document.querySelector()


HTML 元素对象参考手册Element-Objekt

Andere Erweiterungen