files/fr/web/api/document/title/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
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>&lt;title&gt;</code>).</p>

<h2 id="Example">Exemple</h2>

<pre class="brush:js">&lt;!DOCTYPE html&gt;
&lt;html&gt;
&lt;head&gt;
&lt;title&gt;Hello World!&lt;/title&gt;
&lt;/head&gt;
&lt;body&gt;

&lt;script&gt;
alert(document.title); // Affiche "Hello World!"
document.title = "Goodbye World!";
alert(document.title); // Affiche "Goodbye World!"
&lt;/script&gt;

&lt;/body&gt;
&lt;/html&gt;
</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>&lt;title&gt;</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>