CKTIS / JavaScript
Element.innerHTML i Element.className
Svojstvom `innerHTML` čitaš ili zamjenjuješ sadržaj elementa, a svojstvom `className` čitaš ili postavljaš njegove CSS klase.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
element.innerHTML;
element.innerHTML = markup;
element.className;
element.className = classNames;innerHTML i className dva su zasebna svojstva instanci DOM-a, a ne metode. Dio su web-platforme, a ne standarda ECMAScript 2024: izvršno okruženje za JavaScript bez DOM-a ne pruža ih.
Čitanjem element.innerHTML trenutni se sadržaj serijalizira u niz znakova, bez oznaka samog elementa i bez korijena sjenovitog DOM-a. Pri dodjeli se, ovisno o dokumentu, raščlanjuje fragment HTML-a ili XML-a i zamjenjuju se čvorovi djeca, a ne sam element. Čak i iste oznake stvaraju nove čvorove: stare reference i dalje pokazuju na uklonjene čvorove, a njihovi se slušatelji događaja ne prenose. Kod elementa template dodjelom se zamjenjuju čvorovi djeca objekta DocumentFragment na koji upućuje content, a ne sam fragment. Dodjela null djeluje kao dodjela "". U dokumentu XML neispravno oblikovan fragment izaziva SyntaxError, a neuspjela serijalizacija može izazvati InvalidStateError; oba su nazivi iznimke DOMException.
Na HTML elementu element.className odražava atribut class kao niz znakova s nazivima odvojenima prazninama. Dodjelom se zamjenjuje cijela vrijednost atributa bez promjene čvorova djece. Za promjenu jedne klase uz zadržavanje ostalih upotrijebi classList.add(), classList.remove() ili classList.toggle(). Na SVG elementu className može biti objekt SVGAnimatedString; upotrijebi getAttribute("class") ili setAttribute("class", value) za čitanje ili pisanje cijelog atributa. getAttribute() vraća null ako atribut nedostaje, a "" ako postoji, ali je prazan.
innerHTML prema zadanim postavkama ne pročišćava ulazne podatke. Nemoj mu izravno dodijeliti nepouzdane podatke jer to može omogućiti napad XSS. Za unos običnog teksta u uobičajeni element upotrijebi textContent kako se tekst ne bi raščlanio kao HTML. Ako trebaš oznake iz nepouzdanog izvora, prvo ih pročisti. Gdje je podržan Trusted Types, pravilo može vratiti pročišćeni sadržaj kao TrustedHTML; sam tip ne pročišćava podatke. Ako CSP zahtijeva Trusted Types, a nema zadanog pravila, dodjela niza znakova izaziva TypeError.
Primjeri
<!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>Rezultat
card active highlight true false <strong>Ready</strong>
Spremi cijeli primjer kao HTML datoteku i otvori je u pregledniku bez CSP-a koji zahtijeva Trusted Types. Rezultat se prikazuje u konzoli preglednika. Element ostaje izvan dokumenta. Promjena klasa zadržava čvor dijete, a dodjela istog HTML-a zamjenjuje ga.
Povezane lekcije
- JavaScript · Lekcija 42 · Srednje · Verzija: 3