CKTIS / JavaScript
Element: zamjena podređenih čvorova i provjera prisutnosti atributa
Metodom `replaceChildren()` zamijeni ili ukloni podređene čvorove elementa, a metodom `hasAttribute()` provjeri ima li sam element određeni atribut, bez obzira na njegovu vrijednost.
Verzija: Current web platform; runtime support varies
Sintaksa
element.replaceChildren();
element.replaceChildren(firstNodeOrString, secondNodeOrString, ...moreNodesOrStrings);
element.hasAttribute(qualifiedName);replaceChildren() i hasAttribute() metode su instanci sučelja Element u DOM-u. Prva mijenja čvorove neposredno ispod elementa, a druga provjerava atribut samog elementa bez promjene DOM-a. Pripadaju web-platformi, a ne ECMAScriptu 2024. Provjeri pruža li ciljno okruženje DOM i podržava li obje metode.
element.replaceChildren(...) zamjenjuje sve neposredno podređene čvorove, uključujući tekstualne čvorove i komentare. Prima proizvoljan broj čvorova i znakovnih nizova. Bez argumenata isprazni element, ali ga ne uklanja niti mijenja njegove atribute. Znakovni nizovi postaju tekstualni čvorovi pa se, za razliku od dodjele svojstvu innerHTML, ne tumače kao HTML. Metoda vraća undefined.
Postojeći čvorovi se premještaju, ne kloniraju. Uklonjeni čvor odvojen je od roditeljskog čvora, ali ga i dalje možeš koristiti ako zadržiš referencu na njega. Umetanje koje bi stvorilo ciklus, primjerice kad bi element postao vlastiti podređeni čvor, izaziva iznimku DOMException naziva HierarchyRequestError.
element.hasAttribute(name) traži atribut prema kvalificiranom nazivu i vraća true čak i kad je njegova vrijednost prazna ili je znakovni niz "false". Rezultat false znači da atribut nedostaje, a ne da ima neistinitu vrijednost. Za čitanje vrijednosti upotrijebi getAttribute(name), koja vraća null ako atribut nedostaje. Za pretraživanje prema prostoru imena i lokalnom nazivu upotrijebi hasAttributeNS(namespace, localName). Kod logičkog HTML atributa kao što je disabled bitna je prisutnost: postavljanje vrijednosti na "false" ne isključuje ga.
Primjeri
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Replacing child nodes and checking attribute presence</title>
</head>
<body>
<script>
(() => {
const panel = document.createElement("div");
const label = document.createElement("strong");
label.textContent = "Updated";
panel.append("Old: ", label);
console.log(`before: ${panel.hasAttribute("data-ready")}`);
panel.setAttribute("data-ready", "");
panel.replaceChildren("<b>literal</b> ", label);
console.log(`text: ${panel.textContent}`);
console.log(`same node: ${panel.lastChild === label}`);
panel.replaceChildren();
console.log(`child nodes: ${panel.childNodes.length}`);
console.log(`after: ${panel.hasAttribute("data-ready")}`);
console.log(`value: ${JSON.stringify(panel.getAttribute("data-ready"))}`);
})();
</script>
</body>
</html>Rezultat
before: false text: <b>literal</b> Updated same node: true child nodes: 0 after: true value: ""
Spremi primjer kao datoteku `.html`, otvori je u pregledniku i provjeri ispis u konzoli. Znakovni niz nalik HTML-u ostaje tekst, a `same node: true` potvrđuje da je `label` i dalje isti čvor. Nakon pražnjenja element i dalje ima atribut `data-ready` s praznom vrijednošću.
Povezane lekcije
- JavaScript · Lekcija 38 · Napredno · Verzija: 4