CKTIS / JavaScript
Element.innerHTML и Element.className
Използвай `innerHTML`, за да прочетеш или замениш съдържанието на елемент, а `className` — за да прочетеш или зададеш CSS класовете му.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
element.innerHTML;
element.innerHTML = markup;
element.className;
element.className = classNames;innerHTML и className са две отделни свойства на екземпляри на DOM, а не методи. Те са част от уеб платформата, а не от ECMAScript 2024: среда за изпълнение на JavaScript без DOM не ги предоставя.
При четене element.innerHTML сериализира текущото съдържание като низ, без таговете на самия елемент и без корените на shadow DOM. При присвояване фрагментът се анализира като HTML или XML според документа и заменя дъщерните възли, а не самия елемент. Дори същият маркиращ код създава нови възли: старите препратки продължават да сочат към премахнатите възли, а слушателите им за събития не се прехвърлят. При template присвояването заменя дъщерните възли на обекта DocumentFragment, към който сочи content, а не самия фрагмент. Присвояването на null действа като присвояване на "". В XML документ неправилно оформен фрагмент предизвиква SyntaxError, а неуспешна сериализация може да предизвика InvalidStateError; и двете са имена на DOMException.
При HTML елемент element.className отразява атрибута class като един низ с имена, разделени от празни знаци. Присвояването заменя цялата стойност на атрибута, без да променя дъщерните възли. За да промениш един клас и да запазиш останалите, използвай classList.add(), classList.remove() или classList.toggle(). При SVG className може да е обект SVGAnimatedString; за да прочетеш или зададеш целия атрибут, използвай getAttribute("class") или setAttribute("class", value). getAttribute() връща null, ако атрибутът липсва, и "", ако е наличен, но празен.
По подразбиране innerHTML не пречиства входните данни. Не му присвоявай директно ненадеждни данни, тъй като това може да доведе до атака XSS. За обикновен текст в стандартен елемент използвай textContent, за да не се интерпретира текстът като HTML. Ако ти е нужен маркиращ код от ненадежден източник, първо го пречисти. Когато се поддържа Trusted Types, политика може да върне пречистено съдържание като TrustedHTML; самият тип не извършва пречистване. Ако CSP налага Trusted Types и няма политика по подразбиране, присвояването на низ предизвиква TypeError.
Примери
<!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>Резултат
card active highlight true false <strong>Ready</strong>
Запази целия пример като HTML файл и го отвори в браузъра без CSP, която налага Trusted Types. Резултатът се показва в конзолата на браузъра. Елементът остава извън документа. Промяната на класовете запазва дъщерния възел, а присвояването на същия HTML го заменя.
Свързани уроци
- JavaScript · Урок 42 · Средно · Версия: 3