Knoten: previousSibling-Eigenschaft
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
Die schreibgeschützte previousSibling-Eigenschaft des Node-Interfaces
gibt den Knoten zurück, der unmittelbar vor dem angegebenen in der childNodes-Liste des übergeordneten Elements liegt,
oder null, wenn der angegebene Knoten der erste in dieser Liste ist.
Hinweis:
Browser fügen Textknoten in ein Dokument ein, um Leerzeichen im Quelltext darzustellen.
Daher kann ein Knoten, der z.B. mit Node.firstChild
oder Node.previousSibling erhalten wurde,
auf einen Leerzeichentextknoten verweisen, anstatt auf das tatsächlich beabsichtigte Element.
Weitere Informationen finden Sie unter Arbeiten mit Leerzeichen im DOM.
Sie können previousElementSibling verwenden,
um den vorherigen Elementknoten zu erhalten (ohne Textknoten und andere Nicht-Element-Knoten).
Um in der entgegengesetzten Richtung durch die Liste der Kindknoten zu navigieren, verwenden Sie Node.nextSibling.
Wert
Ein Node, der das vorherige Geschwister des aktuellen Knotens darstellt,
oder null, wenn es keines gibt.
Beispiele
Die folgenden Beispiele demonstrieren, wie previousSibling mit und ohne vermischte Textknoten mit Elementen funktioniert.
Erstes Beispiel
In diesem Beispiel haben wir eine Reihe von <span>-Elementen, die direkt nebeneinander liegen, ohne Leerzeichen dazwischen.
<span id="b0"></span><span id="b1"></span><span id="b2"></span>
document.getElementById("b1").previousSibling; // <span id="b0">
document.getElementById("b2").previousSibling.id; // "b1"
Zweites Beispiel
In diesem Beispiel gibt es Leerzeichentextknoten (Zeilenumbrüche) zwischen den <span>-Elementen.
<span id="b0"></span>
<span id="b1"></span>
<span id="b2"></span>
document.getElementById("b1").previousSibling; // #text
document.getElementById("b1").previousSibling.previousSibling; // <span id="b0">
document.getElementById("b2").previousSibling.previousSibling; // <span id="b1">
document.getElementById("b2").previousSibling; // #text
document.getElementById("b2").previousSibling.id; // undefined
Spezifikationen
| Specification |
|---|
| DOM # ref-for-dom-node-previoussibling① |