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

CKTIS / JavaScript

Element.innerHTML a Element.className

Pomocou `innerHTML` prečítaš alebo nahradíš obsah prvku a pomocou `className` prečítaš alebo nastavíš jeho triedy CSS.

Verzia: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

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

innerHTML a className sú dve samostatné vlastnosti inštancií DOM, nie metódy. Patria k webovej platforme, nie k ECMAScriptu 2024: prostredie JavaScriptu bez DOM ich neposkytuje.

Pri čítaní element.innerHTML sa aktuálny obsah serializuje do reťazca, bez značiek samotného prvku a bez koreňov tieňového DOM. Pri priradení sa podľa typu dokumentu spracuje fragment HTML alebo XML a nahradia sa uzly potomkov, nie samotný prvok. Aj rovnaký značkovací kód vytvorí nové uzly: staré referencie stále odkazujú na odstránené uzly a ich poslucháče udalostí sa neprenesú. V prvku template sa priradením nahradia uzly potomkov objektu DocumentFragment, na ktorý odkazuje content, nie samotný fragment. Priradenie null funguje ako priradenie "". V dokumente XML spôsobí nesprávne utvorený fragment SyntaxError a zlyhanie serializácie môže spôsobiť InvalidStateError; oba sú názvy výnimky DOMException.

V prvku HTML element.className odráža atribút class ako jeden reťazec s názvami oddelenými bielymi znakmi. Priradením sa nahradí celá hodnota atribútu bez zmeny uzlov potomkov. Ak chceš zmeniť jednu triedu a ostatné zachovať, použi classList.add(), classList.remove() alebo classList.toggle(). V SVG môže byť className objektom SVGAnimatedString; na čítanie alebo zápis celého atribútu použi radšej getAttribute("class") alebo setAttribute("class", value). getAttribute() vráti null, ak atribút chýba, a "", ak je prítomný, ale prázdny.

innerHTML vstup predvolene nečistí. Nedôveryhodné údaje doň nikdy nepriraďuj priamo, pretože môžu viesť k útoku XSS. Na vloženie obyčajného textu do bežného prvku použi textContent, aby sa text nespracoval ako HTML. Ak potrebuješ značky z nedôveryhodného zdroja, najprv ich bezpečne očisti. Ak je podporované Trusted Types, príslušná politika môže vrátiť očistený obsah ako TrustedHTML; samotný typ nič nečistí. Ak CSP vynucuje Trusted Types a neexistuje predvolená politika, priradenie reťazca vyvolá TypeError.

Príklady

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

Výsledok

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

Ulož celý príklad ako súbor HTML a otvor ho v prehliadači bez CSP vynucujúcej Trusted Types. Výstup sa zobrazí v konzole prehliadača. Prvok zostáva mimo dokumentu. Zmena tried zachová uzol potomka, priradenie rovnakého HTML ho nahradí.

Súvisiace lekcie

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

Zdroje