Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Element.replaceChildren() i Element.className

Zastępuj lub usuwaj wszystkie węzły potomne elementu oraz niezależnie od nich odczytuj i ustawiaj pełną wartość atrybutu `class`.

Wersja: Current web platform; runtime support varies

Składnia

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) zastępuje wszystkie bezpośrednie węzły potomne, w tym węzły tekstowe, zwracając undefined. Jedno wywołanie może przyjąć dowolną liczbę węzłów Node i napisów. Napisy stają się węzłami tekstowymi i nie są interpretowane jako HTML. Wywołanie bez argumentów opróżnia element, ale nie usuwa go ani nie zmienia jego atrybutów.

Istniejące węzły są przenoszone, a nie kopiowane. Odłączony węzeł można wykorzystać ponownie, jeśli zachowano do niego referencję. Naruszenie reguł drzewa DOM, na przykład próba wstawienia przodka jako dziecka elementu, powoduje wyjątek DOMException o nazwie HierarchyRequestError.

W elemencie HTML właściwość element.className odzwierciedla atrybut class jako napis z nazwami klas oddzielonymi białymi znakami. Przypisanie zastępuje całą wartość, nie zmieniając węzłów potomnych. Aby modyfikować pojedyncze klasy bez zastępowania pozostałych, użyj classList.add(), classList.remove() lub classList.toggle(). W SVG className może być obiektem SVGAnimatedString; aby odczytać lub ustawić sam atrybut, użyj getAttribute('class') lub setAttribute('class', value).

ECMAScript 2024 w oznaczeniu wersji określa jedynie wersję odniesienia języka JavaScript. Są to interfejsy DOM platformy webowej, a nie funkcje ECMAScript 2024. Ich dostępność zależy od środowiska wykonawczego; środowisko bez DOM nie udostępnia ich samo z siebie.

Przykłady

<!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>

Wynik

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

Zapisz przykład jako plik HTML, otwórz go w przeglądarce i sprawdź jej konsolę. Pierwszy wiersz pokazuje dwa węzły potomne: element `span` i dosłowny tekst ` <pending>`. Drugi pokazuje, że usunięcie węzłów potomnych nie zmienia wartości `panel ready` w atrybucie `class`.

Powiązane lekcje

  • JavaScript · Lekcja 43 · Średniozaawansowany · Wersja: 3

Źródła