Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Element.replaceChildren() a Element.className

Nahraďte alebo odstráňte všetky podriadené uzly prvku a čítajte či nastavujte celú hodnotu jeho atribútu `class` nezávisle od týchto uzlov.

Verzia: Current web platform; runtime support varies

Syntax

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šetky priame podriadené uzly vrátane textových a vráti undefined. V jednom volaní možno odovzdať ľubovoľný počet objektov Node a reťazcov. Z reťazcov vzniknú textové uzly; neinterpretujú sa ako HTML. Volanie bez argumentov prvok vyprázdni, ale neodstráni samotný prvok ani nezmení jeho atribúty.

Existujúce uzly sa presúvajú, nie klonujú. Odpojený uzol môžete znova použiť, ak si naň ponecháte referenciu. Porušenie pravidiel stromu DOM, napríklad pokus vložiť predka ako potomka prvku, vyvolá výnimku DOMException s názvom HierarchyRequestError.

Pri prvku HTML vlastnosť element.className odráža atribút class ako reťazec, v ktorom sú názvy tried oddelené bielymi znakmi. Priradenie nahradí celú hodnotu bez zmeny podriadených uzlov. Ak chcete meniť jednotlivé triedy bez nahradenia ostatných, použite classList.add(), classList.remove() alebo classList.toggle(). Pri prvkoch SVG môže byť className objektom SVGAnimatedString; samotný atribút prečítate pomocou getAttribute('class') alebo nastavíte pomocou setAttribute('class', value).

V označení verzie znamená ECMAScript 2024 iba východiskovú verziu jazyka JavaScript. Ide o rozhrania DOM webovej platformy, nie o súčasť ECMAScriptu 2024. Dostupnosť závisí od prostredia vykonávania; prostredie bez DOM ich samo neposkytuje.

Prí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ýsledok

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

Uložte príklad ako súbor HTML, otvorte ho v prehliadači a pozrite sa do jeho konzoly. Prvý riadok ukazuje dva podriadené uzly: prvok `span` a doslovný text ` <pending>`. Druhý ukazuje, že po vyprázdnení prvku má atribút `class` stále hodnotu `panel ready`.

Súvisiace lekcie

  • JavaScript · Lekcia 43 · Stredne pokročilá · Verzia: 3

Zdroje