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