aboutsummaryrefslogtreecommitdiff
path: root/files/zh-cn/web/api/document/title
diff options
context:
space:
mode:
authorPeter Bengtsson <mail@peterbe.com>2020-12-08 14:40:17 -0500
committerPeter Bengtsson <mail@peterbe.com>2020-12-08 14:40:17 -0500
commit33058f2b292b3a581333bdfb21b8f671898c5060 (patch)
tree51c3e392513ec574331b2d3f85c394445ea803c6 /files/zh-cn/web/api/document/title
parent8b66d724f7caf0157093fb09cfec8fbd0c6ad50a (diff)
downloadtranslated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.gz
translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.bz2
translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.zip
initial commit
Diffstat (limited to 'files/zh-cn/web/api/document/title')
-rw-r--r--files/zh-cn/web/api/document/title/index.html42
1 files changed, 42 insertions, 0 deletions
diff --git a/files/zh-cn/web/api/document/title/index.html b/files/zh-cn/web/api/document/title/index.html
new file mode 100644
index 0000000000..3f8c887b65
--- /dev/null
+++ b/files/zh-cn/web/api/document/title/index.html
@@ -0,0 +1,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" title="http://www.whatwg.org/html/#document.title">HTML5</a></li>
+</ul>