CKTIS / JavaScript
Výber potomka pomocou querySelector() a zmena jeho obsahu pomocou innerHTML
Nájdite prvého potomka zodpovedajúceho selektoru CSS, ošetrite chýbajúci výsledok a prečítajte alebo nahraďte značkovaný obsah vybraného prvku.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const target = root.querySelector(selectors);
if (target !== null) {
const previousMarkup = target.innerHTML;
target.innerHTML = markup;
}Element.querySelector/innerHTML spája dve operácie: vyhľadanie prvku a prácu s jeho obsahom. root.querySelector(selectors) prijíma reťazec so selektorom CSS alebo so zoznamom selektorov oddelených čiarkami. Vráti prvý vyhovujúci prvok medzi potomkami v poradí stromu DOM, bez ohľadu na poradie selektorov v zozname. Nikdy nevráti samotný root. Ak nič nevyhovuje, vráti null; neplatná syntax selektora vyvolá výnimku DOMException s názvom SyntaxError. Pred čítaním alebo nastavením vlastnosti výsledok skontrolujte.
Nájdený prvok musí byť potomkom root, ale pri vyhodnocovaní selektora môžu zohrávať úlohu aj predkovia mimo tohto podstromu. Použite :scope > .message, ak chcete nájsť iba priamych potomkov root s triedou message. Nejde o vyhľadávanie v celom dokumente ako pri document.querySelector().
Čítanie target.innerHTML vráti reťazec so serializovaným obsahom bez značiek samotného prvku a bez koreňov Shadow DOM. Pri priradení sa fragment spracuje v kontexte prvku a nahradí jeho priame potomky, nie samotný prvok. Pri prvku template sa namiesto toho nahradí obsah šablóny. Uložené referencie a poslucháče udalostí ostávajú spojené so starými odpojenými uzlami, nie s novými. V dokumente XML priradenie nesprávne utvoreného fragmentu vyvolá SyntaxError; čítanie môže vyvolať InvalidStateError, ak serializácia do XML zlyhá. Obe sú výnimky typu DOMException.
Nedôveryhodný vstup nepriraďujte priamo do innerHTML: vlastnosť v predvolenom nastavení značky nečistí a môže viesť k XSS. Na obyčajný text použite textContent. Ak potrebujete značkovaný obsah z nedôveryhodného zdroja, najprv ho vyčistite. Trusted Types vstup samy nečistia. Ak ich prostredie podporuje a CSP ich vynucuje, priradenie obyčajného reťazca bez vhodnej predvolenej politiky vyvolá TypeError. Namiesto neho odovzdajte TrustedHTML z politiky, ktorá vstup čistí.
Tieto API patria do webovej platformy, nie do ECMAScript 2024. Overte, či prostredie poskytuje DOM a podporuje potrebné bezpečnostné funkcie.
Príklady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>querySelector() and innerHTML</title>
</head>
<body>
<script>
{
const panel = document.createElement("div");
panel.innerHTML = '<p class="message"><em>Before</em></p><p class="message">Unchanged</p>';
const target = panel.querySelector(".message");
if (target !== null) {
const oldChild = target.firstElementChild;
console.log(target.innerHTML);
target.innerHTML = "<strong>After</strong>";
console.log(target.innerHTML);
console.log(oldChild.parentNode === null);
console.log(target.nextElementSibling.textContent);
}
console.log(panel.querySelector(".missing") === null);
}
</script>
</body>
</html>Výsledok
<em>Before</em> <strong>After</strong> true Unchanged true
Uložte príklad ako súbor `.html` a otvorte ho v prehliadači bez CSP vynucujúcej Trusted Types. Výstup nájdete v konzole prehliadača. Zmení sa iba prvý nájdený prvok. Jeho pôvodný potomok už nemá rodičovský uzol, druhý prvok si ponechá text `Unchanged` a vyhľadávanie bez výsledku vráti `null`.
Súvisiace lekcie
- JavaScript · Lekcia 18 · Pokročilá · Verzia: 4