CKTIS / JavaScript
HTMLElement.innerHTML: čitanje i zamjena sadržaja elementa
Čitanje svojstva `innerHTML` vraća sadržaj elementa kao označni zapis. Dodjela stvara nove čvorove koji zamjenjuju postojeći sadržaj, čak i pri uporabi `+=`.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
const markup = element.innerHTML;
element.innerHTML = value; // string or TrustedHTML; null is treated as ""HTMLElement.innerHTML svojstvo je instance naslijeđeno od Element, a ne statička metoda. Pri čitanju vraća trenutačni sadržaj DOM-a kao znakovni niz, bez oznaka samog elementa i bez korijena Shadow DOM-a. To je serijalizacija stabla, a ne kopija izvornog teksta.
Dodjela raščlanjuje označni zapis u kontekstu elementa i zamjenjuje njegove čvorove djecu, ne i sam element. Za template zamjenjuje sadržaj template.content. Setter prihvaća znakovni niz ili TrustedHTML. Web IDL pretvara null u prazan niz ("") prije provjere Trusted Types. Ako niz do raščlanjivača stigne nepromijenjen, sadržaj se briše. No kada se zahtijeva Trusted Types, zadana politika može pretvoriti prazan niz u neprazan označni zapis, pa uspješna dodjela ne mora izbrisati sadržaj. Setter ne stvara deklarativne korijene Shadow DOM-a.
element.innerHTML += markup čita serijalizirani zapis, dodaje novi tekst i ponovno raščlanjuje cijeli rezultat. Stari se čvorovi odvajaju, a slušači događaja registrirani izravno na njima ne prenose se na nove čvorove. Da bi postojeći čvorovi ostali na mjestu, dodaj nove pomoću append().
Ne prosljeđuj nepouzdan unos izravno svojstvu innerHTML: ono ga prema zadanim postavkama ne pročišćava, a atributi za obradu događaja mogu dovesti do XSS-a iako se umetnuti elementi script ne izvršavaju. Za običan tekst upotrijebi textContent, a ako trebaš HTML, upotrijebi provjeren alat za pročišćavanje. Sama politika Trusted Types ne jamči pročišćavanje.
To je API web-platforme, a ne dio ECMAScripta 2024. Podrška za Trusted Types ovisi o okruženju. Ako CSP zahtijeva Trusted Types i nema zadane politike, dodjela znakovnog niza izaziva TypeError. Raščlanjivač HTML-a oporavlja se od sintaktičkih pogrešaka, ali u dokumentu XML neispravno oblikovan fragment pri dodjeli može izazvati SyntaxError. Ako se sadržaj ne može serijalizirati kao pravilno oblikovan XML, čitanje može izazvati InvalidStateError.
Primjeri
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>innerHTML example</title>
</head>
<body>
<script>
const box = document.createElement("div");
box.innerHTML = "<strong>Hello</strong>";
const original = box.firstElementChild;
box.innerHTML += "<em> again</em>";
console.log(box.innerHTML);
console.log(box.textContent);
console.log(original === box.firstElementChild);
console.log(original.parentNode === null);
</script>
</body>
</html>Rezultat
<strong>Hello</strong><em> again</em> Hello again false true
Spremi primjer kao HTML datoteku, otvori je u pregledniku bez zahtjeva za Trusted Types i pogledaj konzolu za razvojne programere. Prva dva retka uspoređuju označni zapis s tekstom, a posljednja dva pokazuju da je prvi čvor zamijenjen i da više nema roditeljski čvor.
Povezane lekcije
- JavaScript · Lekcija 31 · Napredno · Verzija: 4