HTML DOM querySelector()Methode
Beispiel
Ermitteln Sie das Element mit id="demo" im Dokument:
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
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:
Selbst ausprobieren »
Beispiel
Rufen Sie das erste Element mit class="example" im Dokument ab:
Selbst ausprobieren »
Beispiel
Rufen Sie das erste <p>-Element mit class="example" im Dokument ab:
Selbst ausprobieren »
Beispiel
Ermitteln Sie das erste <a>-Element im Dokument, das ein "target"-Attribut hat:
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:
<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.
<h2>Ein h2-Element</h2>
document.querySelector("h2, h3").style.backgroundColor = "red";
Selbst ausprobieren »
Verwandte
JavaScript-Referenzhandbuch:element.querySelector()
Andere Erweiterungen
Dokumentobjekt