CKTIS / JavaScript
Element.innerHTML, tagName in namespaceURI
Preberite ali zamenjajte označeno vsebino elementa DOM ter ločite elemente po lokalnem imenu in imenskem prostoru, kadar sta HTML in SVG v istem drevesu.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
element.innerHTML
element.innerHTML = markup
element.tagName
element.namespaceURIinnerHTML vrne trenutno vsebino elementa kot serializiran niz, brez oznak samega elementa in brez korenov senčnega DOM-a. Ob prireditvi niza ali vrednosti TrustedHTML se fragment razčleni v kontekstu elementa in zamenja njegova podrejena vozlišča, ne elementa samega. Sklici na stara vozlišča še vedno kažejo na iste objekte, ne na nova vozlišča. Pri elementu HTML template se branje in pisanje nanašata na njegov content. Prireditev null je enakovredna prireditvi praznega niza.
Dokument HTML uporablja razčlenjevalnik HTML, ki se lahko opomore po napakah v označevanju. Dokument XML, vključno z XHTML, ki je posredovan kot XML, uporablja razčlenjevalnik XML. Nepravilno oblikovan fragment sproži izjemo DOMException z imenom SyntaxError.
tagName je kvalificirano ime, namenjeno samo branju, in vsebuje predpono, če ta obstaja. Črke ASCII v imenu se pretvorijo v velike samo pri elementih v imenskem prostoru HTML, ki pripadajo dokumentu HTML. Tudi namespaceURI je namenjen samo branju: vrne URI imenskega prostora, določenega ob nastanku elementa, ali null, če element nima imenskega prostora. Premik elementa ali sprememba atributa xmlns te vrednosti ne spremeni. V drevesu z več imenskimi prostori primerjajte namespaceURI in localName (ime brez predpone). Z document.createElementNS() lahko pri ustvarjanju elementa izrecno izberete imenski prostor.
Lastnosti innerHTML ne prirejajte nezaupanja vredne označene vsebine: privzeto se ne očisti in lahko omogoči napad XSS, na primer prek atributov za obdelavo dogodkov. Za navadno besedilo uporabite textContent. Če CSP zahteva Trusted Types, prireditev navadnega niza brez privzetega pravilnika sproži TypeError. Vrednost TrustedHTML je varna le toliko, kolikor je varen pravilnik, ki jo je ustvaril. To so API-ji spletne platforme in ne funkcionalnosti ECMAScripta 2024; ne predpostavljajte, da obstajajo v izvajalnih okoljih brez DOM-a.
Primeri
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>HTML and SVG element names</title>
</head>
<body>
<script>
const container = document.createElement('div');
const previous = document.createElement('span');
container.appendChild(previous);
container.innerHTML = '<a>HTML</a><svg><a>SVG</a></svg>';
const htmlLink = container.firstElementChild;
const svgLink = container.lastElementChild.firstElementChild;
console.log(container.innerHTML);
for (const link of [htmlLink, svgLink]) {
console.log(`${link.tagName} | ${link.localName} | ${link.namespaceURI}`);
}
console.log(previous.parentNode === null);
</script>
</body>
</html>Rezultat
<a>HTML</a><svg><a>SVG</a></svg> A | a | http://www.w3.org/1999/xhtml a | a | http://www.w3.org/2000/svg true
Shranite primer kot datoteko `.html` in jo odprite neposredno v brskalniku. Izpis si oglejte v konzoli orodij za razvijalce. Oba elementa imata `a` kot `localName`, vendar se njuna `tagName` in `namespaceURI` razlikujeta. Zadnji `true` pomeni, da prvotno podrejeno vozlišče nima več nadrejenega vozlišča.
Povezane lekcije
- JavaScript · Lekcija 16 · Napredna · Različica: 4