Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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

Izvori