HTML DOM querySelector()Methode
Beispiele
Ändern Sie den Textinhalt des ersten untergeordneten Elements des <div>-Elements mit class="demo":
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
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:
x.querySelector("p").innerHTML = "Hello World!";
Selbst ausprobieren »
Beispiele
Ändern Sie den Inhalt des ersten untergeordneten Elements mit class="example" innerhalb eines <div>-Elements:
x.querySelector(".example").innerHTML = "Hello World!";
Selbst ausprobieren »
Beispiele
Ändere das erste <p>-Element mit class="example" in einem <div>-Element:
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:
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:
<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.
<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()
Andere Erweiterungen
Element-Objekt