База знанияИзпитен център
BGБългарски
Избери език13

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

Източници