CKTIS / JavaScript
`Document.body` et `Document.title` : contenu et titre de la page
`document.body` donne accès à l’élément qui contient le contenu de la page. `document.title` permet de lire ou de modifier le texte du titre.
Version : 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 désigne par raccourci deux propriétés de l’interface Document ; ce n’est pas une syntaxe à écrire dans le code. Dans un script de page, document est l’objet représentant le document courant. Ces propriétés relèvent des API du Web, pas d’ECMAScript 2024. Un environnement sans DOM n’est pas tenu de fournir document.
document.body renvoie le premier enfant direct de l’élément html qui soit un body ou un ancien élément frameset. S’il n’y en a pas, la propriété renvoie null. Pendant l’analyse du HTML, le corps peut ne pas encore exister. Vérifie sa présence avant de l’utiliser, ou exécute le code après l’analyse, par exemple dans un gestionnaire de DOMContentLoaded enregistré avant le déclenchement de l’événement.
document.body.append(node) ajoute du contenu sans remplacer l’élément entier. Affecter un autre élément body ou frameset remplace l’élément existant et son sous-arbre ou, s’il n’y en a pas, insère le nouvel élément sous la racine du document. Affecter null ne supprime pas le corps : l’opération lève HierarchyRequestError. La même exception est levée s’il n’y a pas de racine sous laquelle insérer le nouvel élément.
document.title renvoie une chaîne, pas un élément ni un intertitre h1. À la lecture, les caractères d’espacement ASCII sont supprimés aux extrémités et leurs suites internes sont réduites à une seule espace. En HTML, sans élément title, le résultat est la chaîne vide. Une affectation modifie le texte du titre sans l’interpréter comme du HTML et change généralement le libellé de l’onglet d’une page ouverte. Si title manque mais que head existe, elle crée un title dans head ; si les deux manquent, elle est sans effet. Un document dont la racine est un élément SVG svg utilise un élément title de l’espace de noms SVG, directement sous cette racine.
Exemples
<!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>Résultat
Study notes Review the DOM.
Enregistre l’exemple dans un fichier `.html`, ouvre-le dans un navigateur et consulte la console des outils de développement. Le script crée un document distinct et ne modifie ni le contenu de la page ouverte ni le titre de son onglet.
Leçons associées
- JavaScript · Leçon 36 · Intermédiaire · Version : 3