CKTIS / JavaScript
Element.append — připojování uzlů a textu
`Element.append` přidává uzly a text na konec elementu a vrací `undefined`. Jsou-li `a` a `b` dva různé elementy, po úspěšném volání `element.append(a, b, a)` je na konci nejprve `b` a za ním `a`: poslední výskyt `a` uzel přesune, místo aby ho zkopíroval. Pokud je však `a` fragment `DocumentFragment` s jediným textovým uzlem a `b` je samostatný element, první výskyt `a` umístí textový uzel před `b` a fragment vyprázdní. Poslední výskyt nic nepřidá a samotný fragment se nevloží.
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.append(...nodes)Element.append pochází z mixinu ParentNode standardu DOM, nikoli z ECMAScriptu. Přidává nula nebo více argumentů za posledního potomka elementu.
Řetězce se mění na uzly Text, nikoli na HTML značky. Existující uzel se přesune, nezkopíruje. DocumentFragment přidá své potomky a vyprázdní se.
Na rozdíl od appendChild přijímá append více argumentů, včetně textu, a vrací undefined. Neplatná hierarchie, například vložení elementu do sebe sama, způsobí HierarchyRequestError.
Příklady
const box = document.createElement('div');
const label = document.createElement('span');
label.textContent = 'OK';
const result = box.append('Status: ', label, '!');
console.log(box.textContent);
console.log(box.childNodes.length);
console.log(result);Výsledek
Status: OK! 3 undefined
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.