Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

`Document.body` a `Document.title`: obsah a názov stránky

`document.body` sprístupňuje prvok s obsahom stránky, kým `document.title` umožňuje prečítať alebo zmeniť text názvu dokumentu.

Verzia: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

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 text

Document.body/title je skratka pre dve vlastnosti rozhrania Document, nie zápis určený do kódu. V skripte stránky je document objekt aktuálneho dokumentu. Obe vlastnosti patria do API webovej platformy, nie do ECMAScriptu 2024. Prostredie bez DOM nemusí poskytovať objekt document.

document.body vráti prvého priameho potomka prvku html, ktorý je prvkom body alebo zastaraným prvkom frameset. Ak taký potomok neexistuje, vráti null. Počas spracúvania HTML ešte telo nemusí existovať. Pred použitím over, či už existuje, alebo kód spusti až po spracovaní HTML, napríklad v obsluhe udalosti DOMContentLoaded zaregistrovanej pred jej vyvolaním.

Ak chceš pridať obsah bez výmeny celého prvku, použi document.body.append(node). Priradením iného prvku body alebo frameset nahradíš existujúci prvok aj s jeho podstromom. Ak taký prvok ešte neexistuje, nový sa vloží pod koreňový prvok dokumentu. Priradenie null telo neodstráni, ale vyvolá výnimku HierarchyRequestError. Táto výnimka nastane aj vtedy, keď chýba koreňový prvok, pod ktorý by sa nový prvok vložil.

document.title vráti reťazec, nie prvok ani nadpis h1. Pri čítaní sa odstránia biele znaky ASCII na okrajoch a ich postupnosti vo vnútri sa nahradia jednou medzerou. Ak v HTML chýba title, výsledkom je prázdny reťazec. Priradenie zmení text názvu bez toho, aby sa spracoval ako HTML, a pri otvorenej stránke zvyčajne zmení aj označenie karty. Ak title chýba, ale head existuje, vytvorí sa title v head. Ak chýbajú oba, priradenie nemá účinok. Dokument s koreňovým prvkom SVG svg používa title v mennom priestore SVG priamo pod týmto koreňom.

Prí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ýsledok

Study notes
Review the DOM.

Ulož príklad ako súbor `.html`, otvor ho v prehliadači a skontroluj výstup v konzole vývojárskych nástrojov. Skript vytvorí samostatný dokument, takže nezmení obsah otvorenej stránky ani názov jej karty.

Súvisiace lekcie

  • JavaScript · Lekcia 36 · Stredne pokročilá · Verzia: 3

Zdroje