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

CKTIS / JavaScript

Element.replaceChildren() и Element.className

Заменяйте или премахвайте всички дъщерни възли на елемент и четете или задавайте цялата стойност на атрибута му `class`, без да променяте тези възли.

Версия: Current web platform; runtime support varies

Синтаксис

element.replaceChildren();
element.replaceChildren(node, "text");
element.replaceChildren(...items); // Spread an iterable of nodes and/or strings.
const classes = element.className; // Read the class attribute of an HTML element.
element.className = "panel ready"; // Replace the entire class attribute value.

element.replaceChildren(...items) заменя всички преки дъщерни възли, включително текстовите, и връща undefined. В едно извикване можете да подадете произволен брой обекти Node и низове. Низовете се превръщат в текстови възли и не се интерпретират като HTML. Извикване без аргументи изпразва елемента, без да премахва самия елемент или да променя атрибутите му.

Съществуващите възли се преместват, а не се клонират. Отделен от дървото възел може да се използва отново, ако запазите препратка към него. Нарушаването на правилата на DOM дървото, например при опит да вмъкнете предшественик като дъщерен възел на елемента, предизвиква изключение DOMException с име HierarchyRequestError.

При HTML елемент свойството element.className отразява атрибута class като низ с имена на класове, разделени от бели знаци. Присвояването заменя цялата стойност, без да променя дъщерните възли. За да променяте отделни класове, без да заменяте останалите, използвайте classList.add(), classList.remove() или classList.toggle(). При SVG елементи className може да е обект SVGAnimatedString; за четене или задаване на самия атрибут използвайте getAttribute('class') или setAttribute('class', value).

В обозначението на версията ECMAScript 2024 посочва само базовата версия на езика JavaScript. Това са DOM интерфейси на уеб платформата, а не част от ECMAScript 2024. Наличността им зависи от средата за изпълнение; среда без DOM не ги предоставя сама по себе си.

Примери

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Element.replaceChildren() and Element.className</title>
</head>
<body>
<script>
{
  const panel = document.createElement("div");
  panel.className = "panel loading";
  panel.textContent = "Loading…";

  const label = document.createElement("span");
  label.textContent = "Ready";
  panel.replaceChildren(label, " <pending>");
  panel.className = "panel ready";
  console.log(`${panel.childNodes.length} | ${panel.textContent} | ${panel.className}`);

  panel.replaceChildren();
  console.log(`${panel.childNodes.length} | ${panel.className}`);
}
</script>
</body>
</html>

Резултат

2 | Ready <pending> | panel ready
0 | panel ready

Запазете примера като HTML файл, отворете го в браузър и проверете конзолата на браузъра. Първият ред показва два дъщерни възела: елемента `span` и буквалния текст ` <pending>`. Вторият показва, че след изпразването на елемента атрибутът `class` запазва стойността `panel ready`.

Свързани уроци

  • JavaScript · Урок 43 · Средно · Версия: 3

Източници