diff options
Diffstat (limited to 'files/fr/web/api/document/title/index.md')
| -rw-r--r-- | files/fr/web/api/document/title/index.md | 54 |
1 files changed, 54 insertions, 0 deletions
diff --git a/files/fr/web/api/document/title/index.md b/files/fr/web/api/document/title/index.md new file mode 100644 index 0000000000..8744193915 --- /dev/null +++ b/files/fr/web/api/document/title/index.md @@ -0,0 +1,54 @@ +--- +title: Document.title +slug: Web/API/Document/title +translation_of: Web/API/Document/title +--- +<div>{{APIRef("DOM")}}</div> + +<p>Obtient ou défini le titre de la page.</p> + +<h2 id="Syntax">Syntaxe</h2> + +<pre class="syntaxbox"><em>var docTitle</em> = <em>document</em>.title; +</pre> + +<p><code>title</code> est la chaîne contenant le titre de la page. Si le titre a déjà été modifié par <code>document.title</code>, cela retournera cette valeur. Sinon cela retournera le titre par défaut de la page (voir les {{Anch("Notes")}} ci-dessous).</p> + +<pre class="syntaxbox"><em>document</em>.title = <em>newTitle</em>; +</pre> + +<p><code>newTitle</code> sera le nouveau titre de la page. Le changement de titre affectera également la valeur de retour de <code>document.title</code>, le titre de la page dans le navigateur (généralement le nom de l'onglet dans votre navigateur), et affectera également le DOM de la page (le contenu de la balise HTML <code><title></code>).</p> + +<h2 id="Example">Exemple</h2> + +<pre class="brush:html"><!DOCTYPE html> +<html> +<head> +<title>Hello World!</title> +</head> +<body> + +<script> +alert(document.title); // Affiche "Hello World!" +document.title = "Goodbye World!"; +alert(document.title); // Affiche "Goodbye World!" +</script> + +</body> +</html> +</pre> + +<h2 id="Notes">Notes</h2> + +<p>Cette propriété s'applique à HTML, SVG, XUL, et aux autres documents Gecko.</p> + +<p>Pour les documents HTML, la valeur initiale de <code>document.title</code> est le texte de la balise <code><title></code>. Pour les documents XUL, c'est la valeur de l'attribut {{XULAttr("title")}} de {{XULElem("window")}} ou d'autres éléments parents de l'élément XUL.</p> + +<p>En XUL, accéder à <code>document.title</code> avant que le document soit complètement chargé a des conséquences variables (<code>document.title</code> peut retourner une chaîne vide et définir <code>document.title</code> peut n'avoir aucun effet).</p> + +<h2 id="Specification">Spécification</h2> + +<ul> + <li><a href="http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-18446827">DOM Level 2 HTML: document.title</a></li> + <li><a href="http://www.whatwg.org/html/#document.title">HTML5</a></li> +</ul> |