Document.title

概述

获取或设置文档的标题。

语法

var docTitle = document.title;

title 是一个包含 document 标题的字符串。如果通过设置 document.title 将标题覆盖,则返回覆盖后的值。否则返回标签里指定的标题(参见下面的 Notes)。

document.title = newTitle;

newTitle 是文档的新标题。赋值操作影响 document.title 的返回值,文档的显示标题(即窗口或标签页顶部的标题栏),另外还会影响文档的 DOM,即改变 HTML 文档中 <title> 元素的内容。

示例

<!DOCTYPE html>
<html>
<head>
<title>Hello World!</title>
</head>
<body>
<script>
alert(document.title); // 显示 "Hello World!"
document.title = "Goodbye World!";
alert(document.title); // 显示 "Goodbye World!"
</script>
</body>
</html>

备注

在 Gecko 中,该属性适应于 HTML、SVG、XUL 和其他文档。

对于 HTML 文档来说,document.title 的初始值是 <title> 元素的文本内容。对于 XUL 来说,它是 window 或其他顶级 XUL 元素的 title 属性的值。

在 XUL 里,在文档完全加载之前访问 document.title,会有未定义行为(document.title 可能返回一个空字符串,并且设置 document.title 也无效)。

规范

文档标签和贡献者