CKTIS / JavaScript
`Document.body` in `Document.title`: vsebina in naslov strani
Z `document.body` dostopaš do elementa z vsebino strani, z `document.title` pa prebereš ali spremeniš besedilo naslova dokumenta.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
doc.body // Read: HTMLBodyElement, HTMLFrameSetElement, or null
doc.body = bodyElement // Write: supply an HTML body or frameset element
doc.title // Read: string
doc.title = titleText // Write: supply title textDocument.body/title je okrajšava za dve lastnosti vmesnika Document, ne zapis za uporabo v kodi. V skriptu strani je document objekt trenutnega dokumenta. Obe lastnosti sta del API-jev spletne platforme, ne standarda ECMAScript 2024. Okolju brez DOM-a objekta document ni treba ponujati.
document.body vrne prvega neposrednega otroka elementa html, ki je element body ali zastareli frameset. Če takega otroka ni, vrne null. Med razčlenjevanjem HTML-ja telo morda še ne obstaja. Pred uporabo preveri, ali obstaja, ali pa kodo zaženi po razčlenjevanju, na primer v obravnavalniku dogodka DOMContentLoaded, ki ga registriraš, preden se dogodek sproži.
Za dodajanje vsebine brez zamenjave celotnega elementa uporabi document.body.append(node). Če lastnosti prirediš drug element body ali frameset, se obstoječi element zamenja skupaj s poddrevesom. Če takega elementa še ni, se novi vstavi pod korenski element dokumenta. Prirejanje vrednosti null ne odstrani telesa, ampak sproži izjemo HierarchyRequestError. Enaka izjema nastane, če ni korenskega elementa, pod katerega bi bilo mogoče vstaviti novi element.
document.title vrne niz, ne elementa ali naslova h1. Pri branju se z obeh koncev odstranijo beli znaki ASCII, notranja zaporedja teh znakov pa se skrčijo na posamezne presledke. Če v HTML-ju manjka title, je rezultat prazen niz. Prirejanje spremeni besedilo naslova, ne da bi ga razčlenilo kot HTML, pri odprti strani pa običajno spremeni tudi oznako zavihka. Če manjka title, vendar obstaja head, se v head ustvari title; če manjkata oba, prirejanje nima učinka. Dokument s korenskim elementom SVG svg uporablja element title v imenskem prostoru SVG neposredno pod tem korenom.
Primeri
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Document.body and Document.title example</title>
</head>
<body>
<script>
const doc = document.implementation.createHTMLDocument();
doc.title = " Study notes ";
const paragraph = doc.createElement("p");
paragraph.textContent = "Review the DOM.";
doc.body.append(paragraph);
console.log(doc.title);
console.log(doc.body.textContent);
</script>
</body>
</html>Rezultat
Study notes Review the DOM.
Shrani primer kot datoteko `.html`, jo odpri v brskalniku in preveri izpis v konzoli razvojnih orodij. Skript ustvari ločen dokument, zato ne spremeni vsebine odprte strani niti naslova njenega zavihka.
Povezane lekcije
- JavaScript · Lekcija 36 · Srednja · Različica: 3