CKTIS / JavaScript
Element.previousElementSibling — předchozí sourozenecký element
Vlastnost previousElementSibling vrací nejbližší předchozí element se stejným rodičem, nebo null. Textové uzly a komentáře přeskakuje.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
element.previousElementSiblingElement.previousElementSibling je vlastnost pouze pro čtení, nikoli metoda. Vrací nejbližší předchozí element, který má stejného rodiče, nebo null, pokud žádný takový element neexistuje. Platí to i tehdy, když dotazovaný element rodiče nemá.
Na rozdíl od previousSibling přeskakuje textové uzly a komentáře. Nehledá mezi předky ani potomky. Než výsledek použijete jako element, ověřte, že není null.
Jde o API standardu DOM, nikoli samotného ECMAScriptu. Definuje ho mixin NonDocumentTypeChildNode, který je zahrnut v Element a CharacterData, ale nikoli v DocumentType. Příklad vyžaduje DOM prostředí prohlížeče; verze Node.js v repozitáři nedokládá dostupnost tohoto API.
Příklady
const parent = document.createElement('div');
const first = document.createElement('span');
const second = document.createElement('button');
parent.append(first, document.createTextNode(' '), document.createComment('gap'), second);
console.log(second.previousElementSibling === first);
console.log(second.previousSibling.nodeType === Node.COMMENT_NODE);
console.log(first.previousElementSibling === null);Výsledek
true true true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.