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

CKTIS / JavaScript

Element: třídy, obsah a přítomnost atributu

Použijte `className` ke čtení nebo nahrazení seznamu tříd, `innerHTML` ke čtení nebo nahrazení obsahu ve formě značek a `toggleAttribute()` ke změně přítomnosti atributu.

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

Syntaxe

element.className
element.className = classNames
element.innerHTML
element.innerHTML = markup
element.toggleAttribute(name)
element.toggleAttribute(name, force)

Jde o rozhraní DOM, nikoli o funkce ECMAScriptu 2024. Verze ECMAScriptu uvedená v této položce neurčuje jejich dostupnost. Vyžadují prostředí, které příslušná rozhraní DOM poskytuje; podpora závisí na běhovém prostředí.

U prvku HTML vlastnost className odráží atribut class jako řetězec názvů tříd oddělených bílými znaky. Přiřazení nahradí celý řetězec. Chcete-li změnit jedinou třídu a ostatní ponechat, použijte classList. U prvku SVG může být className objektem SVGAnimatedString; k přímému přístupu k atributu použijte getAttribute('class') nebo setAttribute('class', value).

Čtením innerHTML získáte obsah ve formě značek HTML nebo XML, bez samotného prvku a jeho stínového kořene. Při zápisu se značky zpracují v kontextu prvku a nahradí stávající uzly obsahu, místo aby se připojily další. U prvku template se nahradí obsah šablony. Posluchače událostí zůstávají na původních uzlech a nepřenášejí se na nové. V dokumentu XML mohou chybně utvořené značky při zápisu vyvolat SyntaxError a selhání serializace při čtení může vyvolat InvalidStateError.

Nepředávejte nedůvěryhodné značky přímo do innerHTML: ve výchozím nastavení je neočišťuje, a proto hrozí XSS. Pro zobrazení prostého textu v prvcích, jako je span, použijte textContent. Nepřiřazujte však nedůvěryhodný text do textContent prvku script: po vložení prvku do dokumentu se text může spustit jako kód. Pokud značky potřebujete, nedůvěryhodný vstup před vložením očistěte. Pokud CSP vynucuje Trusted Types a není stanovena výchozí politika, přiřazení obyčejného řetězce vyvolá TypeError; použijte TrustedHTML z vhodné politiky.

toggleAttribute(name) odstraní existující atribut nebo přidá chybějící s prázdnou hodnotou. S argumentem force znamená true zajistit přítomnost beze změny stávající hodnoty a false zajistit nepřítomnost. Logický výsledek říká, zda je atribut po volání přítomen, nikoli zda nastala změna. U logického atributu HTML, jako je disabled, účinek nevypne ani hodnota "false": rozhoduje přítomnost. U prvku HTML v dokumentu HTML se písmena ASCII v názvu převedou na malá; neplatný název vyvolá InvalidCharacterError.

Příklady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Element DOM example</title>
</head>
<body>
  <script>
    (() => {
      const button = document.createElement('button');
      button.className = 'action muted';
      button.className = 'action ready';

      button.innerHTML = '<span>Draft</span>';
      const oldLabel = button.firstElementChild;
      button.innerHTML = '<strong>Save</strong>';

      console.log(button.className);
      console.log(button.innerHTML);
      console.log(oldLabel.parentNode === null);
      console.log(button.toggleAttribute('disabled'));
      console.log(button.toggleAttribute('disabled', true));
      console.log(button.toggleAttribute('disabled', false));
    })();
  </script>
</body>
</html>

Výsledek

action ready
<strong>Save</strong>
true
true
true
false

Uložte příklad jako soubor HTML, otevřete jej v prohlížeči bez vynucování Trusted Types a podívejte se do vývojářské konzole. Tlačítko se do dokumentu nepřidává. První `true` potvrzuje odpojení původního uzlu popisku; poslední tři výsledky ukazují stav atributu `disabled` po přidání, zajištění přítomnosti a odstranění.

Související lekce

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

Zdroje