CKTIS / JavaScript
Element: klasy, zawartość i obecność atrybutu
Użyj `className`, aby odczytać lub zastąpić zestaw klas, `innerHTML`, aby odczytać lub zastąpić zawartość jako znaczniki, a `toggleAttribute()`, aby zmienić obecność atrybutu.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
element.className
element.className = classNames
element.innerHTML
element.innerHTML = markup
element.toggleAttribute(name)
element.toggleAttribute(name, force)To interfejsy API DOM, a nie funkcje ECMAScript 2024. Wersja ECMAScript podana w tym wpisie nie określa ich dostępności. Wymagają środowiska udostępniającego odpowiedni DOM; dostępność zależy od środowiska wykonawczego.
Na elemencie HTML className odzwierciedla atrybut class jako ciąg nazw klas oddzielonych białymi znakami. Przypisanie zastępuje cały ciąg. Aby zmienić jedną klasę bez naruszania pozostałych, użyj classList. W SVG className może być obiektem SVGAnimatedString; do bezpośredniego odczytu lub zapisu atrybutu użyj getAttribute('class') lub setAttribute('class', value).
Odczyt innerHTML zwraca znaczniki HTML lub XML zawartości, bez samego elementu i jego korzenia cienia. Przypisanie parsuje znaczniki w kontekście elementu i zastępuje istniejące węzły zawartości zamiast dopisywać nowe. W template zastępuje zawartość szablonu. Nasłuchiwacze pozostają na starych węzłach i nie przechodzą na nowe. W dokumencie XML niepoprawnie uformowane znaczniki mogą spowodować SyntaxError, a niemożliwa serializacja przy odczycie — InvalidStateError.
Nie przekazuj niezaufanych znaczników bezpośrednio do innerHTML: ta właściwość ich domyślnie nie oczyszcza, co grozi XSS. Do wyświetlania zwykłego tekstu w elementach takich jak span użyj textContent. Nie przypisuj jednak niezaufanego tekstu do textContent elementu script: może on zostać wykonany jako kod po wstawieniu tego elementu do dokumentu. Gdy potrzebujesz znaczników, oczyść niezaufane dane przed wstawieniem. Jeśli CSP wymusza Trusted Types i nie ma polityki domyślnej, przypisanie zwykłego ciągu powoduje TypeError; użyj TrustedHTML z odpowiedniej polityki.
toggleAttribute(name) usuwa obecny atrybut lub dodaje brakujący z pustą wartością. Z argumentem force wartość true zapewnia obecność bez zmiany istniejącej wartości, a false zapewnia brak. Wynik typu boolean oznacza obecność po wywołaniu, a nie to, czy zaszła zmiana. Dla atrybutu logicznego HTML, takiego jak disabled, nawet wartość "false" nie wyłącza działania: liczy się obecność. Na elemencie HTML w dokumencie HTML litery ASCII w nazwie są zamieniane na małe; niedozwolona nazwa powoduje InvalidCharacterError.
Przykłady
<!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>Wynik
action ready <strong>Save</strong> true true true false
Zapisz przykład jako plik HTML, otwórz go w przeglądarce bez wymuszania Trusted Types i sprawdź wyniki w konsoli. Przycisk nie jest dołączony do dokumentu. Pierwsze `true` potwierdza odłączenie starego węzła etykiety; ostatnie trzy wyniki pokazują stan `disabled` po dodaniu, wymuszeniu obecności i usunięciu.
Powiązane lekcje
- JavaScript · Lekcja 39 · Średniozaawansowany · Wersja: 3