aboutsummaryrefslogtreecommitdiff
path: root/files/zh-cn/web/api/document/title/index.html
blob: 40056fafe28d12173a1a44d2fa9c7dbbdb22bf51 (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
---
title: Document.title
slug: Web/API/Document/title
translation_of: Web/API/Document/title
---
<div>
 {{APIRef}}</div>
<h2 id="Summary" name="Summary">概述</h2>
<p>获取或设置文档的标题。</p>
<h2 id="Syntax" name="Syntax">语法</h2>
<pre class="syntaxbox"><em>var docTitle</em> = <em>document</em>.title;
</pre>
<p><code>title</code> 是一个包含 <code>document</code> 标题的字符串。如果通过设置 <code>document.title</code> 将标题覆盖,则返回覆盖后的值。否则返回标签里指定的标题(参见下面的 {{Anch("Notes")}})。</p>
<pre class="syntaxbox"><em>document</em>.title = <em>newTitle</em>;
</pre>
<p><code>newTitle</code> 是文档的新标题。赋值操作影响 <code>document.title</code> 的返回值,<span style="line-height: 1.5;">文档的显示标题(即窗口或标签页顶部的标题栏),另外还会影响文档的 DOM,即改变 HTML 文档中 </span><code style="font-style: normal; line-height: 1.5;">&lt;title&gt;</code><span style="line-height: 1.5;"> 元素的内容。</span></p>
<h2 id="Example" name="Example">示例</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); // 显示 "Hello World!"
document.title = "Goodbye World!";
alert(document.title); // 显示 "Goodbye World!"
&lt;/script&gt;

&lt;/body&gt;
&lt;/html&gt;
</pre>
<h2 id="Notes" name="Notes">备注</h2>
<p>在 Gecko 中,该属性适应于 HTML、SVG、XUL 和其他文档。</p>
<p>对于 HTML 文档来说,<code>document.title</code> 的初始值是 <code>&lt;title&gt;</code> 元素的文本内容。对于 XUL 来说,它是 {{XULElem("window")}} 或其他顶级 XUL 元素的 {{XULAttr("title")}} 属性的值。</p>
<p>在 XUL 里,在文档完全加载之前访问 <code>document.title</code>,会有未定义行为(<code>document.title</code> 可能返回一个空字符串,并且设置 <code>document.title</code> 也无效)。</p>
<h2 id="Specification" name="Specification">规范</h2>
<ul>
 <li><a class="external" href="http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-18446827">DOM Level 2 HTML: document.title</a></li>
 <li><a class="external" href="http://www.whatwg.org/html/#document.title">HTML5</a></li>
</ul>