aboutsummaryrefslogtreecommitdiff
path: root/files/de/web/api/document/title/index.html
blob: 9c54e274a6106c5161a7fe241e87a890b33de464 (plain)
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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
---
title: Document.title
slug: Web/API/Document/title
translation_of: Web/API/Document/title
---
<div>{{APIRef("DOM")}}</div>

<p><span class="seoSummary">Die Eigenschaft <strong><code>document.title</code></strong> holt oder setzt den aktuellen <a href="/en-US/docs/Web/HTML/Element/title">Titel</a> des Dokuments.</span></p>

<h2 id="Syntax">Syntax</h2>

<pre class="syntaxbox">var <var>docTitle</var> = <var>document</var>.title;
</pre>

<p><em>docTitle</em> ist eine Zeichenfolge, die den Titel des Dokuments enthält. Wenn der Titel durch das Setzen von <code>document.title</code> überschrieben wurde, enthält er diesen Wert. Andernfalls enthält er den im Markup angegebenen Titel (siehe {{Anch("Anmerkungen")}} unten).</p>

<pre class="syntaxbox"><em>document</em>.title = <em>newTitle</em>;
</pre>

<p><code>newTitle</code> ist der neue Titel des Dokuments. Die Zuweisung beeinflusst den Rückgabewert von <code>document.title</code>, den für das Dokument angezeigten Titel (z.B. in der Titelleiste des Fensters oder Tabs), und sie beeinflusst auch das DOM des Dokuments (z.B. den Inhalt des Elements <code>&lt;title&gt;</code> in einem HTML-Dokument).</p>

<h2 id="Beispiel">Beispiel</h2>

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

  &lt;script&gt;
    alert(document.title); // zeigt "Hallo Welt!"
    document.title = "Tschüss Welt!";
    alert(document.title); // zeigt "Tschüss Welt!"
  &lt;/script&gt;

&lt;/body&gt;
&lt;/html&gt;
</pre>

<h2 id="Anmerkungen">Anmerkungen</h2>

<p>Diese Eigenschaft gilt für HTML-, SVG-, XUL- und andere Dokumente in Gecko.</p>

<p>Bei HTML-Dokumenten ist der Anfangswert von <code>document.title</code> der Textinhalt des Elements <code>&lt;title&gt;</code>. Bei XUL ist es der Wert des {{XULAttr("title")}} Attributs des {{XULElem("window")}} oder eines anderen XUL-Elements der obersten Ebene.</p>

<p>In XUL hat der Zugriff auf <code>document.title</code>, bevor das Dokument vollständig geladen ist, ein undefiniertes Verhalten: <code>document.title</code> gibt möglicherweise eine leere Zeichenfolge zurück, und das Setzen von <code>document.title</code> hat möglicherweise keine Wirkung.</p>

<h2 id="Spezifikationen">Spezifikationen</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Spezifikation</th>
   <th scope="col">Status</th>
   <th scope="col">Kommentar</th>
  </tr>
  <tr>
   <td>{{SpecName('HTML WHATWG','#document.title','document.title')}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td></td>
  </tr>
 </tbody>
</table>

<h2 id="Browser-Kompatibilität">Browser-Kompatibilität</h2>



<p>{{Compat("api.Document.title")}}</p>