CKTIS / JavaScript
Element: razredi, vsebina in prisotnost atributa
Uporabi `className` za branje ali zamenjavo niza razredov, `innerHTML` za branje ali zamenjavo vsebine v obliki označevalne kode in `toggleAttribute()` za spreminjanje prisotnosti atributa.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
element.className
element.className = classNames
element.innerHTML
element.innerHTML = markup
element.toggleAttribute(name)
element.toggleAttribute(name, force)To so vmesniki DOM, ne funkcije ECMAScripta 2024. Različica ECMAScripta, navedena v tem vnosu, ne določa njihove razpoložljivosti. Potrebuješ okolje, ki zagotavlja ustrezne vmesnike DOM; podpora je odvisna od izvajalnega okolja.
Na elementu HTML className odraža atribut class kot niz imen razredov, ločenih z belimi znaki. Prirejanje zamenja celoten niz. Če želiš spremeniti le en razred, uporabi classList. Na elementu SVG je className lahko objekt SVGAnimatedString; za neposreden dostop do atributa uporabi getAttribute('class') ali setAttribute('class', value).
Branje innerHTML vrne vsebino v obliki označevalne kode HTML ali XML, brez samega elementa in njegovega senčnega korena. Pri zapisu se označevalna koda razčleni v kontekstu elementa in nadomesti obstoječa vozlišča vsebine, namesto da bi dodala nova na konec. Pri elementu template se zamenja vsebina predloge. Poslušalci dogodkov ostanejo na starih vozliščih in se ne prenesejo na nova. V dokumentu XML lahko nepravilno oblikovana označevalna koda pri zapisu sproži SyntaxError, neuspešna serializacija pri branju pa InvalidStateError.
Nezaupanja vredne označevalne kode ne podajaj neposredno v innerHTML: privzeto je ne očisti, zato obstaja tveganje za XSS. Za prikaz navadnega besedila v elementih, kot je span, uporabi textContent. Vendar lastnosti textContent elementa script ne priredi nezaupanja vrednega besedila: to se lahko izvede kot koda, ko element vstaviš v dokument. Če potrebuješ označevalno kodo, nezaupanja vreden vhod očisti pred vstavljanjem. Če CSP zahteva Trusted Types in ni privzetega pravilnika, prireditev navadnega niza sproži TypeError; uporabi TrustedHTML iz ustreznega pravilnika.
toggleAttribute(name) odstrani prisoten atribut ali doda manjkajočega s prazno vrednostjo. Z argumentom force vrednost true zagotovi prisotnost brez spremembe obstoječe vrednosti, false pa odsotnost. Logični rezultat pove, ali je atribut po klicu prisoten, ne pa, ali se je kaj spremenilo. Pri logičnem atributu HTML, kot je disabled, niti vrednost "false" ne izklopi njegovega učinka: šteje prisotnost. Na elementu HTML v dokumentu HTML se črke ASCII v imenu pretvorijo v male; neveljavno ime sproži InvalidCharacterError.
Primeri
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Element DOM example</title>
</head>
<body>
<script>
(() => {
const button = document.createElement('button');
button.className = 'action muted';
button.className = 'action ready';
button.innerHTML = '<span>Draft</span>';
const oldLabel = button.firstElementChild;
button.innerHTML = '<strong>Save</strong>';
console.log(button.className);
console.log(button.innerHTML);
console.log(oldLabel.parentNode === null);
console.log(button.toggleAttribute('disabled'));
console.log(button.toggleAttribute('disabled', true));
console.log(button.toggleAttribute('disabled', false));
})();
</script>
</body>
</html>Rezultat
action ready <strong>Save</strong> true true true false
Primer shrani kot datoteko HTML, odpri jo v brskalniku brez vsiljene uporabe Trusted Types in preveri izpis v razvijalski konzoli. Gumb ni dodan v dokument. Prvi `true` potrdi, da je bilo staro vozlišče oznake ločeno; zadnji trije rezultati prikazujejo stanje atributa `disabled` po dodajanju, zagotovitvi prisotnosti in odstranitvi.
Povezane lekcije
- JavaScript · Lekcija 39 · Srednja · Različica: 3