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

CKTIS / JavaScript

Element.innerHTML a Element.className

Pomocí `innerHTML` přečteš nebo nahradíš obsah prvku a pomocí `className` přečteš nebo nastavíš jeho třídy CSS.

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

Syntaxe

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

innerHTML a className jsou dvě samostatné vlastnosti instancí DOM, nikoli metody. Patří k webové platformě, ne k ECMAScriptu 2024: prostředí JavaScriptu bez DOM je neposkytuje.

Při čtení element.innerHTML vznikne řetězec serializací aktuálního obsahu, bez značek samotného prvku a bez kořenů stínového DOM. Při přiřazení se podle typu dokumentu zpracuje fragment HTML nebo XML a nahradí se podřízené uzly, nikoli samotný prvek. I totožný zdrojový kód vytvoří nové uzly: staré reference dál odkazují na odebrané uzly a jejich posluchače událostí se nepřenášejí. U prvku template se přiřazením nahradí podřízené uzly objektu DocumentFragment, na který odkazuje content, nikoli samotný fragment. Přiřazení null funguje jako přiřazení "". V dokumentu XML způsobí nesprávně utvořený fragment SyntaxError a neúspěšná serializace může způsobit InvalidStateError; obojí jsou názvy výjimky DOMException.

U prvku HTML element.className odráží atribut class jako jeden řetězec s názvy oddělenými bílými znaky. Přiřazení nahradí celou hodnotu atributu, ale nezmění podřízené uzly. Ke změně jediné třídy se zachováním ostatních použij classList.add(), classList.remove() nebo classList.toggle(). U prvků SVG může být className objektem SVGAnimatedString; pro čtení a zápis celého atributu použij raději getAttribute("class") nebo setAttribute("class", value). getAttribute() vrací null, pokud atribut chybí, a "", pokud je přítomný, ale prázdný.

innerHTML ve výchozím nastavení vstup nečistí. Nedůvěryhodná data do něj nikdy nepřiřazuj přímo, protože mohou vést k útoku XSS. K vložení prostého textu do běžného prvku použij textContent, aby se text nezpracoval jako HTML. Pokud potřebuješ značky z nedůvěryhodného zdroje, nejprve je bezpečně očisti. Je-li podporováno Trusted Types, může příslušná politika vrátit očištěný obsah jako TrustedHTML; samotný typ nic nečistí. Pokud CSP vynucuje Trusted Types a neexistuje výchozí politika, přiřazení řetězce vyvolá TypeError.

Pří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ýsledek

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

Ulož celý příklad jako soubor HTML a otevři ho v prohlížeči bez CSP vynucující Trusted Types. Výstup se zobrazí v konzoli prohlížeče. Prvek zůstává mimo dokument. Změna tříd zachová podřízený uzel, přiřazení stejného HTML ho nahradí.

Související lekce

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

Zdroje