CKTIS / JavaScript
Element.previousElementSibling — predchádzajúci súrodenecký element
Vlastnosť previousElementSibling vráti najbližší predchádzajúci element s rovnakým rodičom alebo null. Textové uzly a komentáre preskakuje.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
element.previousElementSiblingElement.previousElementSibling je vlastnosť iba na čítanie, nie metóda. Vráti najbližší predchádzajúci element, ktorý má rovnakého rodiča, alebo null, ak taký element neexistuje. Platí to aj vtedy, keď skúmaný element nemá rodiča.
Na rozdiel od previousSibling preskakuje textové uzly a komentáre. Neprehľadáva predkov ani potomkov. Pred použitím výsledku ako elementu skontrolujte, či nie je null.
Ide o API štandardu DOM, nie samotného ECMAScriptu. Definuje ho mixin NonDocumentTypeChildNode, ktorý je súčasťou Element a CharacterData, ale nie DocumentType. Príklad vyžaduje DOM prostredie prehliadača; verzia Node.js v repozitári nedokazuje dostupnosť tohto API.
Prí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ýsledok
true true true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.