Element: querySelector()-Methode
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Die querySelector()-Methode der Element-Schnittstelle gibt das erste Element zurück, das ein Nachfahre des Elements ist, auf welchem sie aufgerufen wird und das mit der angegebenen Gruppe von Selektoren übereinstimmt.
Syntax
querySelector(selectors)
Parameter
selectors-
Ein String, der einen oder mehrere Selektoren enthält, die übereinstimmen sollen. Dieser String muss ein gültiger CSS-Selektor-String sein. Ist er das nicht, wird eine
SyntaxError-Ausnahme geworfen.Beachten Sie, dass die HTML-Spezifikation nicht verlangt, dass Attributwerte gültige CSS-Bezeichner sind. Wenn ein
class- oderid-Attributwert kein gültiger CSS-Bezeichner ist, dann müssen Sie ihn escapen, bevor Sie ihn in einem Selektor verwenden. Entweder durch Aufrufen vonCSS.escape()auf den Wert oder unter Verwendung einer der Techniken, die in Escaping characters beschrieben sind. Siehe Escaping attribute values für ein Beispiel.
Rückgabewert
Das erste Nachfahr-Element von baseElement, das mit der angegebenen Gruppe von selectors übereinstimmt. Die gesamte Hierarchie der Elemente wird berücksichtigt, wenn Übereinstimmungen gesucht werden, einschließlich der Elemente außerhalb des Sets von baseElement und seinen Nachfahren. Mit anderen Worten, selectors wird zuerst auf das gesamte Dokument angewendet, nicht auf das baseElement, um eine anfängliche Liste potenzieller Elemente zu generieren. Die resultierenden Elemente werden dann untersucht, um festzustellen, ob sie Nachfahren von baseElement sind. Das erste übereinstimmende dieser verbleibenden Elemente wird von der querySelector()-Methode zurückgegeben.
Wenn keine Übereinstimmungen gefunden werden, ist der zurückgegebene Wert null.
Ausnahmen
SyntaxErrorDOMException-
Wird geworfen, wenn die angegebenen
selectorsungültig sind.
Beispiele
Sehen wir uns ein paar Beispiele an.