English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

HTML DOM querySelector() -Methode

HTML DOM Document-Objekt

querySelector()Gibt den ersten Element zurück, der auf den angegebenen Selektor oder die Gruppe von Selektoren passt.

Falls keine Übereinstimmung gefunden wird, wird null zurückgegeben.

Die querySelector() -Methode gibt nur den ersten Element, der dem angegebenen Selektor entspricht, zurück. Um alle Übereinstimmungen zurückzugeben, verwenden Sie bittequerySelectorAll()Methode.

Syntax:

document.querySelector(selectors)
document.querySelector('h1');
Testen Sie heraus‹/›

Browserkompatibilität

Die Nummer in der Tabelle gibt die erste Browserversion an, die den querySelector() -Methoden vollständig unterstützt:

Methode
querySelector()13.5103.28

Parameterwert

ParameterBeschreibung
selectorsZeichenkette, die einen oder mehrere zu passierende Selektoren enthält. Diese Zeichenkette muss gültig seinCSS SelektorenZeichenkette

Technische Details

Rückgabewert:Stellt den in der Dokumentbeschreibung genanntenCSS SelektorenDas Element-Objekt des ersten Elements, das auf das Muster passt, falls keine Übereinstimmung vorliegt, wird null zurückgegeben.
Ausnahmefälle:SyntaxError-Die Syntax der angegebenen Selektorzeichenkette ist ungültig
DOM-Version:DOM-Stufe1

Mehr Beispiele

Erhalten Sie das erste Element mit id="para":

document.querySelector('#para');
Testen Sie heraus‹/›

Erhalten Sie das erste Element mit class="demo":

document.querySelector(".demo");
Testen Sie heraus‹/›

Erhalten Sie den ersten <p>-Element, der als übergeordneter Element der <div>-Element ist, im Dokument:

document.querySelector("div > p");
Testen Sie heraus‹/›

Zusammenhängende Referenzen

CSS Tutorial:CSS Selektoren

CSS Referenz:CSS#idSelektoren

CSS Referenz:CSS .classSelektoren

DOM Document querySelectorAll()Methoden

DOM Document getElementsByClassName()Methoden

DOM Document getElementsByTagName()Methoden

HTML DOM Document-Objekt