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

CKTIS / JavaScript

Element.innerHTML in Element.className

Z `innerHTML` prebereš ali zamenjaš vsebino elementa, s `className` pa prebereš ali nastaviš njegove razrede CSS.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

element.innerHTML;
element.innerHTML = markup;
element.className;
element.className = classNames;

innerHTML in className sta ločeni lastnosti primerkov DOM, ne metodi. Spadata v spletno platformo, ne v ECMAScript 2024: izvajalno okolje JavaScript brez DOM ju ne ponuja.

Ob branju element.innerHTML se trenutna vsebina serializira v niz, brez oznak samega elementa in brez korenov senčnega DOM. Ob prirejanju se glede na dokument razčleni fragment HTML ali XML in zamenjajo se podrejena vozlišča, ne sam element. Tudi enake oznake ustvarijo nova vozlišča: stare reference še vedno kažejo na odstranjena vozlišča, njihovi poslušalci dogodkov pa se ne prenesejo. Pri elementu template prirejanje zamenja podrejena vozlišča objekta DocumentFragment, na katerega kaže content, ne pa samega fragmenta. Prirejanje null učinkuje enako kot prirejanje "". V dokumentu XML nepravilno oblikovan fragment sproži SyntaxError, neuspešna serializacija pa lahko sproži InvalidStateError; obe sta imeni izjeme DOMException.

Pri elementih HTML element.className odraža atribut class kot en niz imen, ločenih z belimi znaki. Prirejanje zamenja celotno vrednost atributa, ne da bi spremenilo podrejena vozlišča. Za spremembo enega razreda brez izgube preostalih uporabi classList.add(), classList.remove() ali classList.toggle(). Pri SVG je lahko className objekt SVGAnimatedString; za branje oziroma zapis celotnega atributa raje uporabi getAttribute("class") ali setAttribute("class", value). getAttribute() vrne null, če atribut manjka, in "", če je prisoten, vendar prazen.

innerHTML privzeto ne prečisti vhodnih podatkov. Nezaupanja vrednih podatkov mu nikoli ne priredi neposredno, saj to lahko povzroči napad XSS. Za vstavljanje navadnega besedila v običajen element uporabi textContent, da se besedilo ne razčleni kot HTML. Če potrebuješ oznake iz nezaupanja vrednega vira, jih najprej varno prečisti. Kjer je Trusted Types podprt, lahko pravilnik vrne prečiščeno vsebino kot TrustedHTML; sam tip podatkov ne prečisti. Če CSP zahteva uporabo Trusted Types in ni privzetega pravilnika, prirejanje niza sproži TypeError.

Primeri

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>innerHTML and className</title>
</head>
<body>
  <script>
    {
      const card = document.createElement("div");
      card.className = "card muted";
      card.innerHTML = "<strong>Ready</strong>";
      const original = card.firstElementChild;

      card.className = "card active";
      card.classList.add("highlight");
      console.log(card.className);
      console.log(card.firstElementChild === original);

      card.innerHTML = "<strong>Ready</strong>";
      console.log(card.firstElementChild === original);
      console.log(card.innerHTML);
    }
  </script>
</body>
</html>

Rezultat

card active highlight
true
false
<strong>Ready</strong>

Celoten primer shrani kot datoteko HTML in jo odpri v brskalniku, ne da bi CSP zahteval uporabo Trusted Types. Izpis se prikaže v konzoli brskalnika. Element ostane zunaj dokumenta. Sprememba razredov ohrani podrejeno vozlišče, prirejanje enakega HTML pa ga zamenja.

Povezane lekcije

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

Viri