Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Element.replaceChildren() a Element.className

Nahraďte nebo odstraňte všechny podřízené uzly prvku a čtěte či nastavujte celou hodnotu jeho atributu `class` nezávisle na těchto uzlech.

Verze: Current web platform; runtime support varies

Syntaxe

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) nahradí všechny přímé podřízené uzly včetně textových a vrátí undefined. V jednom volání lze předat libovolný počet objektů Node a řetězců. Z řetězců vzniknou textové uzly; nevyhodnocují se jako HTML. Volání bez argumentů prvek vyprázdní, ale neodstraní samotný prvek ani nezmění jeho atributy.

Existující uzly se přesouvají, nikoli klonují. Odpojený uzel můžete znovu použít, pokud si na něj ponecháte referenci. Porušení pravidel stromu DOM, například pokus vložit předka jako potomka prvku, vyvolá výjimku DOMException s názvem HierarchyRequestError.

U prvku HTML vlastnost element.className odráží atribut class jako řetězec s názvy tříd oddělenými bílými znaky. Přiřazením nahradíte celou hodnotu, aniž byste změnili podřízené uzly. Chcete-li měnit jednotlivé třídy a ponechat ostatní beze změny, použijte classList.add(), classList.remove() nebo classList.toggle(). U prvků SVG může být className objektem SVGAnimatedString; samotný atribut přečtete pomocí getAttribute('class') a nastavíte pomocí setAttribute('class', value).

V označení verze uvádí ECMAScript 2024 pouze výchozí verzi jazyka JavaScript. Jde o rozhraní DOM webové platformy, nikoli o součást ECMAScriptu 2024. Dostupnost závisí na běhovém prostředí; prostředí bez DOM je samo neposkytuje.

Příklady

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

Výsledek

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

Uložte příklad jako soubor HTML, otevřete ho v prohlížeči a podívejte se do jeho konzole. První řádek ukazuje dva podřízené uzly: prvek `span` a doslovný text ` <pending>`. Druhý ukazuje, že po vyprázdnění prvku zůstává hodnota atributu `class` rovna `panel ready`.

Související lekce

  • JavaScript · Lekce 43 · Středně pokročilá · Verze: 3

Zdroje