База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Element.append — добавяне на възли и текст

`Element.append` добавя възли и текст в края на елемент и връща `undefined`. Ако `a` и `b` са различни елементи, след успешно извикване на `element.append(a, b, a)` в края са `b`, а след него `a`: при последната поява на `a` възелът се премества, а не се копира. Ако обаче `a` е `DocumentFragment` с един текстов възел, а `b` е отделен елемент, при първата поява на `a` текстовият възел се поставя преди `b`, а фрагментът се изпразва. При последната поява не се добавя нищо, а самият фрагмент не се вмъква.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

element.append(...nodes)

Element.append произлиза от миксина ParentNode на стандарта DOM, а не от ECMAScript. Добавя нула или повече аргумента след последния дъщерен възел на елемента.

Низовете се превръщат във възли Text, а не в HTML маркировка. Съществуващ възел се премества, а не се копира. DocumentFragment добавя дъщерните си възли и се изпразва.

За разлика от appendChild, append приема няколко аргумента, включително текст, и връща undefined. Невалидна йерархия, например вмъкване на елемент в самия него, води до HierarchyRequestError.

Примери

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);

Резултат

Status: OK!
3
undefined

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници