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

CKTIS / JavaScript

Element: класове, съдържание и наличие на атрибут

Използвай `className` за четене или замяна на низа с класове, `innerHTML` за четене или замяна на съдържанието като маркировка и `toggleAttribute()` за промяна на наличието на атрибут.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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

Това са интерфейси на DOM, а не възможности на ECMAScript 2024. Посочената в този запис версия на ECMAScript не определя дали тези интерфейси са налични. Те изискват среда, която предоставя съответните DOM интерфейси; поддръжката зависи от средата за изпълнение.

При HTML елемент className отразява атрибута class като низ от имена на класове, разделени с празни знаци. Присвояването заменя целия низ. За промяна на един клас, без да засягаш останалите, използвай classList. При SVG елемент className може да е обект SVGAnimatedString; за пряк достъп до атрибута използвай getAttribute('class') или setAttribute('class', value).

Четенето на innerHTML връща HTML или XML маркировката на съдържанието, без самия елемент и неговия сенчест корен. При запис маркировката се анализира в контекста на елемента и замества съществуващите възли на съдържанието, вместо да добавя нови след тях. При елемент template се заменя съдържанието на шаблона. Слушателите за събития остават върху старите възли и не се прехвърлят към новите. В XML документ неправилно оформена маркировка може да предизвика SyntaxError при запис, а неуспешна сериализация при четене — InvalidStateError.

Не подавай ненадеждна маркировка директно към innerHTML: по подразбиране тя не се пречиства и има риск от XSS. Използвай textContent за показване на обикновен текст в елементи като span. Не присвоявай ненадежден текст на textContent на елемент script: текстът може да се изпълни като код при вмъкването на елемента в документа. Ако е нужна маркировка, пречисти ненадеждния вход преди вмъкване. Ако CSP изисква Trusted Types и няма политика по подразбиране, присвояването на обикновен низ предизвиква TypeError; използвай TrustedHTML от подходяща политика.

toggleAttribute(name) премахва наличен атрибут или добавя липсващ с празна стойност. С аргумент force стойността true осигурява наличие, без да променя съществуваща стойност, а false осигурява липса. Булевият резултат показва дали атрибутът е наличен след извикването, а не дали е настъпила промяна. При булев HTML атрибут като disabled дори стойността "false" не изключва действието му: важно е наличието. При HTML елемент в HTML документ ASCII буквите в името се преобразуват в малки; невалидно име предизвиква InvalidCharacterError.

Примери

<!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>

Резултат

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

Запази примера като HTML файл, отвори го в браузър, който не изисква Trusted Types, и провери изхода в конзолата за разработчици. Бутонът не се добавя към документа. Първото `true` потвърждава, че старият възел на надписа е отделен; последните три резултата показват състоянието на `disabled` след добавяне, осигуряване на наличие и премахване.

Свързани уроци

  • JavaScript · Урок 39 · Средно · Версия: 3

Източници