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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.