From 0071d8deab4f4535848f1fcb6423086340c13ff9 Mon Sep 17 00:00:00 2001 From: Chunhui Fu Date: Thu, 15 Aug 2024 16:14:00 +0800 Subject: [PATCH] [zh-cn]: create docs for HTMLTitleElement (#23061) Co-authored-by: A1lo --- files/zh-cn/web/api/htmltitleelement/index.md | 43 ++++++++++++++++++ .../web/api/htmltitleelement/text/index.md | 45 +++++++++++++++++++ 2 files changed, 88 insertions(+) create mode 100644 files/zh-cn/web/api/htmltitleelement/index.md create mode 100644 files/zh-cn/web/api/htmltitleelement/text/index.md diff --git a/files/zh-cn/web/api/htmltitleelement/index.md b/files/zh-cn/web/api/htmltitleelement/index.md new file mode 100644 index 00000000000000..5a7ae1cc1e16d7 --- /dev/null +++ b/files/zh-cn/web/api/htmltitleelement/index.md @@ -0,0 +1,43 @@ +--- +title: HTMLTitleElement +slug: Web/API/HTMLTitleElement +l10n: + sourceCommit: 32305cc3cf274fbfdcc73a296bbd400a26f38296 +--- + +{{APIRef("HTML DOM")}} + +**`HTMLTitleElement`** 接口由文档的 {{HTMLElement("title")}} 实现。此元素继承 {{domxref("HTMLElement")}} 接口的所有属性和方法。 + +{{InheritanceDiagram}} + +## 实例属性 + +_从其父接口 {{domxref("HTMLElement")}} 继承属性。_ + +- {{domxref("HTMLTitleElement.text")}} + - : 表示文档标题文本的字符串。 + +## 实例方法 + +_无特定方法；从其父接口 {{domxref("HTMLElement")}} 继承方法。_ + +## 示例 + +请勿混淆 `document.title` 和 `document.querySelector('title')`。 + +前者只是一个 setter/getter 方法，用于设置或读取文档标题的内部文本值，后者是 `HTMLTitleElement` 对象。因此你不能写：`document.title.text = "Hello world!";`。 + +相反，你可以简单地写：`document.title = "Hello world!";`，这相当于 `document.querySelector('title').text = "Hello world!";`。 + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}} + +## 参见 + +- 实现此接口的 HTML 元素：{{HTMLElement("title")}}。 diff --git a/files/zh-cn/web/api/htmltitleelement/text/index.md b/files/zh-cn/web/api/htmltitleelement/text/index.md new file mode 100644 index 00000000000000..3b18cbe4a70fc4 --- /dev/null +++ b/files/zh-cn/web/api/htmltitleelement/text/index.md @@ -0,0 +1,45 @@ +--- +title: HTMLTitleElement：text 属性 +slug: Web/API/HTMLTitleElement/text +l10n: + sourceCommit: 7cc15fff0f1284ece460597b9717ca20350a1fa9 +--- + +{{APIRef("HTML DOM")}} + +{{domxref("HTMLTitleElement")}} 接口的 **`text`** 属性表示文档标题的文本，仅包含文本部分；元素内的标签和其内容被剥离并忽略。 + +## 值 + +一个字符串。 + +## 示例 + +考虑一下示例： + +```html + + + + + 你好世界！<span class="highlight">这难道不精彩吗</span>真的吗？ + + + + +``` + +```js +const title = document.querySelector("title"); +console.log(title.text); // 产生：“你好世界！真的吗？” +``` + +如你所见，标签 `span` 和其内容被跳过。 + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}}