CKTIS / JavaScript
Element: замяна на дъщерни възли и проверка за наличие на атрибут
Използвай `replaceChildren()`, за да замениш или премахнеш дъщерните възли на елемент, и `hasAttribute()`, за да провериш дали самият елемент има даден атрибут, независимо от стойността му.
Версия: Current web platform; runtime support varies
Синтаксис
element.replaceChildren();
element.replaceChildren(firstNodeOrString, secondNodeOrString, ...moreNodesOrStrings);
element.hasAttribute(qualifiedName);replaceChildren() и hasAttribute() са методи на екземпляри на интерфейса Element в DOM. Първият променя възлите непосредствено под елемента, а вторият проверява атрибут на самия елемент, без да променя DOM. Това са интерфейси на уеб платформата, а не възможности на ECMAScript 2024. Провери дали целевата среда предоставя DOM и поддържа и двата метода.
element.replaceChildren(...) заменя всички преки дъщерни възли, включително текстовите възли и коментарите. Приема произволен брой възли и низове. Без аргументи изпразва елемента, без да го премахва или да променя атрибутите му. Низовете стават текстови възли и за разлика от присвояване на innerHTML не се интерпретират като HTML. Методът връща undefined.
Съществуващите възли се преместват, а не се клонират. Премахнатият възел се отделя от родителя си, но можеш да го използваш, ако запазиш препратка към него. Вмъкване, което би създало цикъл, например ако елемент стане дъщерен на самия себе си, предизвиква изключение DOMException с име HierarchyRequestError.
element.hasAttribute(name) търси атрибут по квалифицирано име и връща true дори при празна стойност или низ "false". Резултатът false означава, че атрибутът липсва, а не че стойността му е невярна. За да прочетеш стойността, използвай getAttribute(name), който връща null, ако атрибутът липсва. За търсене по пространство от имена и локално име използвай hasAttributeNS(namespace, localName). При булев HTML атрибут като disabled е важно наличието му: задаването на стойност "false" не го изключва.
Примери
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Replacing child nodes and checking attribute presence</title>
</head>
<body>
<script>
(() => {
const panel = document.createElement("div");
const label = document.createElement("strong");
label.textContent = "Updated";
panel.append("Old: ", label);
console.log(`before: ${panel.hasAttribute("data-ready")}`);
panel.setAttribute("data-ready", "");
panel.replaceChildren("<b>literal</b> ", label);
console.log(`text: ${panel.textContent}`);
console.log(`same node: ${panel.lastChild === label}`);
panel.replaceChildren();
console.log(`child nodes: ${panel.childNodes.length}`);
console.log(`after: ${panel.hasAttribute("data-ready")}`);
console.log(`value: ${JSON.stringify(panel.getAttribute("data-ready"))}`);
})();
</script>
</body>
</html>Резултат
before: false text: <b>literal</b> Updated same node: true child nodes: 0 after: true value: ""
Запази примера като файл `.html`, отвори го в браузър и провери изхода в конзолата. Низът, който прилича на HTML, остава текст, а `same node: true` потвърждава, че `label` е същият възел. След изпразването елементът все още има атрибут `data-ready` с празна стойност.
Свързани уроци
- JavaScript · Урок 38 · Напреднало · Версия: 4