CKTIS / JavaScript
`Document.body` a `Document.title`: obsah a název stránky
`document.body` zpřístupňuje prvek s obsahem stránky, zatímco `document.title` umožňuje přečíst nebo změnit text názvu dokumentu.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
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 zkratka pro dvě vlastnosti rozhraní Document, nikoli zápis určený do kódu. Ve skriptu stránky je document objektem aktuálního dokumentu. Obě vlastnosti patří do API webové platformy, ne do ECMAScriptu 2024. Prostředí bez DOM nemusí objekt document poskytovat.
document.body vrací prvního přímého potomka prvku html, který je prvkem body nebo zastaralým prvkem frameset. Pokud takový potomek neexistuje, vrací null. Během zpracování HTML nemusí být tělo ještě vytvořené. Před použitím ověř, že existuje, nebo kód spusť až po zpracování HTML, například v obsluze události DOMContentLoaded zaregistrované před jejím vyvoláním.
Pro přidání obsahu bez výměny celého prvku použij document.body.append(node). Přiřazením jiného prvku body nebo frameset nahradíš stávající prvek i s jeho podstromem. Pokud takový prvek ještě neexistuje, nový se vloží pod kořenový prvek dokumentu. Přiřazení null tělo neodstraní, ale vyvolá výjimku HierarchyRequestError. Stejná výjimka nastane, pokud chybí kořenový prvek, pod který by se nový prvek vložil.
document.title vrací řetězec, ne prvek ani nadpis h1. Při čtení se odstraní bílé znaky ASCII z obou konců a každá jejich posloupnost uvnitř se nahradí jednou mezerou. Pokud v HTML chybí title, výsledkem je prázdný řetězec. Přiřazením změníš text názvu, aniž by se zpracoval jako HTML, a u otevřené stránky se obvykle změní popisek karty. Jestliže title chybí, ale head existuje, vytvoří se title uvnitř head. Chybějí-li oba, přiřazení nemá účinek. Dokument s kořenovým prvkem SVG svg používá title v jmenném prostoru SVG přímo pod tímto kořenem.
Příklady
<!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>Výsledek
Study notes Review the DOM.
Ulož příklad jako soubor `.html`, otevři ho v prohlížeči a zkontroluj výstup v konzoli vývojářských nástrojů. Skript vytvoří samostatný dokument, takže nezmění obsah otevřené stránky ani název její karty.
Související lekce
- JavaScript · Lekce 36 · Středně pokročilá · Verze: 3