CKTIS / JavaScript
HTMLElement.innerHTML: branje in zamenjava vsebine elementa
Branje `innerHTML` vrne označevalni zapis vsebine elementa. Prireditev jo zamenja z novimi vozlišči, ki jih ustvari razčlenjevalnik, tudi pri uporabi `+=`.
Različica: 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 je lastnost primerka, podedovana od Element, in ne statična metoda. Pri branju vrne trenutno vsebino DOM kot niz brez oznak samega elementa in brez korenov Shadow DOM. To je serializacija drevesa, ne kopija izvornega besedila.
Prireditev razčleni označevalni zapis v kontekstu elementa in zamenja njegova otroška vozlišča, ne pa elementa samega. Pri template zamenja vsebino template.content. Nastavljalnik sprejme niz ali TrustedHTML. Web IDL pretvori null v prazen niz ("") pred preverjanjem Trusted Types. Če niz nespremenjen pride do razčlenjevalnika, se vsebina izprazni. Kadar so Trusted Types zahtevani, pa lahko privzeti pravilnik prazen niz pretvori v neprazen označevalni zapis, zato uspešna prireditev vsebine ne izprazni nujno. Nastavljalnik ne ustvari deklarativnih korenov Shadow DOM.
element.innerHTML += markup prebere serializirani zapis, mu doda novo besedilo in ponovno razčleni celoten rezultat. Stara vozlišča se odklopijo od drevesa, poslušalci dogodkov, registrirani neposredno na njih, pa se ne prenesejo na nova vozlišča. Če želiš obstoječa vozlišča ohraniti, dodaj nova z append().
Nezaupanja vrednega vnosa ne podajaj neposredno v innerHTML: privzeto ga ne očisti, atributi za obravnavo dogodkov pa lahko povzročijo XSS, čeprav se vstavljeni elementi script ne izvedejo. Za golo besedilo uporabi textContent; če potrebuješ HTML, uporabi preverjeno orodje za čiščenje. Pravilnik Trusted Types sam po sebi ne zagotavlja čiščenja.
To je API spletne platforme, ne del ECMAScript 2024. Podpora za Trusted Types je odvisna od okolja. Če CSP zahteva Trusted Types in privzeti pravilnik ne obstaja, prireditev niza sproži TypeError. Razčlenjevalnik HTML se zna odzvati na skladenjske napake, v dokumentu XML pa lahko nepravilno oblikovan fragment pri prireditvi sproži SyntaxError. Če vsebine ni mogoče serializirati kot pravilno oblikovan XML, lahko branje sproži InvalidStateError.
Primeri
<!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
Shrani primer kot datoteko HTML, odpri jo v brskalniku brez zahteve po Trusted Types in preveri razvijalsko konzolo. Prvi dve vrstici primerjata označevalni zapis z besedilom; zadnji dve pokažeta, da je bilo prvo vozlišče zamenjano in nima več nadrejenega vozlišča.
Povezane lekcije
- JavaScript · Lekcija 31 · Napredna · Različica: 4