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