CKTIS / JavaScript
Element.previousElementSibling — prejšnji sorodni element
Lastnost previousElementSibling vrne najbližji prejšnji element z istim nadrejenim elementom ali null. Besedilne vozlišča in komentarje preskoči.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
element.previousElementSiblingElement.previousElementSibling je lastnost samo za branje, ne metoda. Vrne najbližji prejšnji element, ki ima istega nadrejenega, ali null, če takega elementa ni. To velja tudi, kadar poizvedovani element nima nadrejenega elementa.
Za razliko od previousSibling preskoči besedilna vozlišča in komentarje. Ne išče med predniki ali potomci. Preden rezultat uporabite kot element, preverite, da ni null.
To je API standarda DOM, ne pa del samega ECMAScripta. Določa ga mixin NonDocumentTypeChildNode, ki je vključen v Element in CharacterData, ne pa v DocumentType. Primer zahteva okolje brskalnika z DOM-om; različica Node.js v repozitoriju ne dokazuje, da je ta API na voljo.
Primeri
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);Rezultat
true true true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.