Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.previousElementSibling

Element.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.

Zdroje