Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Element.replaceChildren() in Element.className

Zamenjajte ali odstranite vsa podrejena vozlišča elementa ter preberite ali nastavite celotno vrednost atributa `class`, ne da bi jih spremenili.

Različica: Current web platform; runtime support varies

Sintaksa

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) zamenja vsa neposredna podrejena vozlišča, tudi besedilna, in vrne undefined. V istem klicu lahko podate poljubno število objektov Node in nizov. Nizi postanejo besedilna vozlišča in se ne razčlenijo kot HTML. Klic brez argumentov izprazni element, ne da bi odstranil sam element ali spremenil njegove atribute.

Obstoječa vozlišča se premaknejo in se ne klonirajo. Vozlišče, odklopljeno iz drevesa, lahko znova uporabite, če obdržite referenco nanj. Kršitev pravil drevesa DOM, na primer poskus vstavljanja prednika kot otroka elementa, sproži izjemo DOMException z imenom HierarchyRequestError.

Pri elementu HTML lastnost element.className odraža atribut class kot niz imen razredov, ločenih z belimi znaki. Prireditev zamenja celotno vrednost, ne da bi spremenila podrejena vozlišča. Če želite spremeniti posamezne razrede, ne da bi zamenjali druge, uporabite classList.add(), classList.remove() ali classList.toggle(). Pri elementih SVG je className lahko objekt SVGAnimatedString; za branje ali nastavitev samega atributa uporabite getAttribute('class') ali setAttribute('class', value).

V oznaki različice ECMAScript 2024 označuje le izhodiščno različico jezika JavaScript. To so vmesniki DOM spletne platforme in niso del ECMAScripta 2024. Razpoložljivost je odvisna od izvajalnega okolja; okolje brez DOM jih samo ne zagotavlja.

Primeri

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

Rezultat

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

Primer shranite kot datoteko HTML, jo odprite v brskalniku in preverite njegovo konzolo. Prva vrstica pokaže dve podrejeni vozlišči: element `span` in dobesedno besedilo ` <pending>`. Druga pokaže, da po izpraznitvi elementa atribut `class` še vedno vsebuje `panel ready`.

Povezane lekcije

  • JavaScript · Lekcija 43 · Srednja · Različica: 3

Viri