From 178a63f504e2d2bc6efb63fc07993fe5fa177936 Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Mon, 2 Dec 2024 13:10:39 +0800 Subject: [PATCH 01/14] feat: update translation --- .../api/sidebaraction/settitle/index.md | 109 ++++++++++++++++++ 1 file changed, 109 insertions(+) create mode 100644 files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md new file mode 100644 index 00000000000000..74e3ccf9eb2084 --- /dev/null +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md @@ -0,0 +1,109 @@ +--- +title: sidebarAction.setTitle() +slug: Mozilla/Add-ons/WebExtensions/API/sidebarAction/setTitle +l10n: + sourceCommit: b8a0743ca8b1e1b1b1a95cc93a4413c020f11262 +--- + +{{AddonSidebar}} + +设置侧边栏的标题。标题显示在浏览器列出可用侧边栏的任何地方。例如，Firefox 会在“查看 > 侧边栏”菜单中显示它。当侧边栏打开时，它还会显示在侧边栏的顶部。 + +## 标题类型 + +你的扩展应该在 [sidebar_action](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action) manifest 键中指定侧边栏的标题（这是 _“manifest 标题”_）。如果你没有指定 manifest 标题，它将使用默认值即扩展名。 + +如果你使用 `setTitle()` 设置新标题，并包含 `tabId` 选项，那么标题仅为给定的标签设置。这个标题称为“标签特定标题”。 + +如果你使用 `setTitle()` 设置新标题，并包含 `windowId` 选项，那么标题仅为给定的窗口设置。这个标题称为“窗口特定标题”，并将出现在该窗口的所有标签中，这些标签没有设置标签特定标题。 + +如果你使用 `setTitle()` 设置新标题，并省略 `tabId` 和 `windowId` 选项，那么这将设置“全局标题”。全局标题将出现在所有没有设置标签特定标题的标签中，且其窗口没有设置窗口特定标题的标签中。 + +## 语法 + +```js-nolint +browser.sidebarAction.setTitle( + details // 对象 +) +``` + +### 参数 + +- `details` + + - : `object`。新标题和可选的目标标签页或窗口 ID。 + + - `title` + + - : `string` 或 `null`。鼠标悬停时浏览器操作应显示的字符串。 + + 如果 `title` 是空字符串，则使用扩展名作为标题，但 {{WebExtAPIRef("sidebarAction.getTitle")}} 仍会提供空字符串。 + + 如果 `title` 为 `null`： + + - 如果指定了 `tabId`，并且该标签页设置了特定的标签页标题，则该标签页将继承其所属窗口的标题。 + - 如果指定了 `windowId`，并且该窗口设置了特定的窗口标题，则该窗口将继承全局标题。 + - 否则，全局标题将重置为清单中的标题。 + + - `tabId` {{optional_inline}} + - : `integer`。仅为指定的标签页设置标题。 + - `windowId` {{optional_inline}} + - : `integer`。仅为指定的窗口设置标题。 + + + +- 如果同时提供了 `windowId` 和 `tabId`，函数将失败且标题不会被设置。 +- 如果同时省略 `windowId` 和 `tabId`，则设置全局标题。 + +## 浏览器兼容性 + +{{Compat}} + +## 示例 + +下面代码在用户点击浏览器操作时更改侧边栏的标题（但仅对当前标签页更改）： + +```js +let title = "一个不同的标题"; + +function setTitleForTab(tab) { + browser.sidebarAction.setTitle({ title, tabId: tab.id }); +} + +browser.browserAction.onClicked.addListener(setTitleForTab); +``` + +{{WebExtExamples}} + +> [!NOTE] +> 此 API 是基于 Opera 的 [`chrome.sidebarAction`](https://help.opera.com/en/extensions/sidebar-action-api/) API。 + + From 746f8fdb23bec629bc45773f056244a01d62ab44 Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Mon, 2 Dec 2024 13:20:08 +0800 Subject: [PATCH 02/14] Update index.md --- .../add-ons/webextensions/api/sidebaraction/settitle/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md index 74e3ccf9eb2084..921ffbdf15c8f3 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md @@ -11,7 +11,7 @@ l10n: ## 标题类型 -你的扩展应该在 [sidebar_action](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action) manifest 键中指定侧边栏的标题（这是 _“manifest 标题”_）。如果你没有指定 manifest 标题，它将使用默认值即扩展名。 +你的扩展应该在 [sidebar_action](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action) manifest 键中指定侧边栏的标题（这被称为_“manifest 标题”_）。如果你没有指定 manifest 标题，它将使用默认值即扩展名。 如果你使用 `setTitle()` 设置新标题，并包含 `tabId` 选项，那么标题仅为给定的标签设置。这个标题称为“标签特定标题”。 From a5f37818019deb076cab8bf2d4a6b2230d071c68 Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Mon, 2 Dec 2024 13:22:36 +0800 Subject: [PATCH 03/14] Update index.md --- .../add-ons/webextensions/api/sidebaraction/settitle/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md index 921ffbdf15c8f3..030b8149d8d397 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md @@ -11,7 +11,7 @@ l10n: ## 标题类型 -你的扩展应该在 [sidebar_action](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action) manifest 键中指定侧边栏的标题（这被称为_“manifest 标题”_）。如果你没有指定 manifest 标题，它将使用默认值即扩展名。 +你的扩展应该在 [sidebar_action](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action) manifest 键中指定侧边栏的标题（这被称为*“manifest 标题”*）。如果你没有指定 manifest 标题，它将使用默认值即扩展名。 如果你使用 `setTitle()` 设置新标题，并包含 `tabId` 选项，那么标题仅为给定的标签设置。这个标题称为“标签特定标题”。 From 0a289a8c41714c5f394930a4840250a3880d3b07 Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Mon, 2 Dec 2024 13:25:24 +0800 Subject: [PATCH 04/14] Update index.md --- .../add-ons/webextensions/api/sidebaraction/settitle/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md index 030b8149d8d397..52281b9aced083 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md @@ -11,7 +11,7 @@ l10n: ## 标题类型 -你的扩展应该在 [sidebar_action](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action) manifest 键中指定侧边栏的标题（这被称为*“manifest 标题”*）。如果你没有指定 manifest 标题，它将使用默认值即扩展名。 +你的扩展应该在 [sidebar_action](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action) manifest 键中指定侧边栏的标题（这被称为“manifest 标题”）。如果你没有指定 manifest 标题，它将使用默认值即扩展名。 如果你使用 `setTitle()` 设置新标题，并包含 `tabId` 选项，那么标题仅为给定的标签设置。这个标题称为“标签特定标题”。 From 7dad81415d7e4edf3138356bf80767c5aa6dab1e Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Mon, 2 Dec 2024 20:09:51 +0800 Subject: [PATCH 05/14] Update index.md --- .../webextensions/api/sidebaraction/settitle/index.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md index 52281b9aced083..f3f48796726817 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md @@ -11,13 +11,13 @@ l10n: ## 标题类型 -你的扩展应该在 [sidebar_action](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action) manifest 键中指定侧边栏的标题（这被称为“manifest 标题”）。如果你没有指定 manifest 标题，它将使用默认值即扩展名。 +你的扩展应该在 [sidebar_action](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action) manifest 键中指定侧边栏的标题（这被称为“_manifest 标题_”）。如果你没有指定 manifest 标题，它将使用默认值即扩展名。 -如果你使用 `setTitle()` 设置新标题，并包含 `tabId` 选项，那么标题仅为给定的标签设置。这个标题称为“标签特定标题”。 +如果你使用 `setTitle()` 设置新标题，并包含 `tabId` 选项，那么标题仅为给定的标签设置。这个标题称为“_标签特定标题_”。 -如果你使用 `setTitle()` 设置新标题，并包含 `windowId` 选项，那么标题仅为给定的窗口设置。这个标题称为“窗口特定标题”，并将出现在该窗口的所有标签中，这些标签没有设置标签特定标题。 +如果你使用 `setTitle()` 设置新标题，并包含 `windowId` 选项，那么标题仅为给定的窗口设置。这个标题称为“_窗口特定标题_”，并将出现在该窗口的所有标签中，这些标签没有设置标签特定标题。 -如果你使用 `setTitle()` 设置新标题，并省略 `tabId` 和 `windowId` 选项，那么这将设置“全局标题”。全局标题将出现在所有没有设置标签特定标题的标签中，且其窗口没有设置窗口特定标题的标签中。 +如果你使用 `setTitle()` 设置新标题，并省略 `tabId` 和 `windowId` 选项，那么这将设置“_全局标题_”。全局标题将出现在所有没有设置标签特定标题的标签中，且其窗口没有设置窗口特定标题的标签中。 ## 语法 From c8f81a2ba4ce6c9db2adeb806edc7d39dcb623ce Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Wed, 4 Dec 2024 22:47:41 +0800 Subject: [PATCH 06/14] Update index.md --- .../add-ons/webextensions/api/sidebaraction/settitle/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md index f3f48796726817..2d773e13f48e82 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md @@ -11,7 +11,7 @@ l10n: ## 标题类型 -你的扩展应该在 [sidebar_action](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action) manifest 键中指定侧边栏的标题（这被称为“_manifest 标题_”）。如果你没有指定 manifest 标题，它将使用默认值即扩展名。 +你的附加组件应该在 [sidebar_action](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action) manifest 键中指定侧边栏的标题（这被称为“_manifest 标题_”）。如果你没有指定 manifest 标题，它将使用默认值即附加组件名。 如果你使用 `setTitle()` 设置新标题，并包含 `tabId` 选项，那么标题仅为给定的标签设置。这个标题称为“_标签特定标题_”。 @@ -37,7 +37,7 @@ browser.sidebarAction.setTitle( - : `string` 或 `null`。鼠标悬停时浏览器操作应显示的字符串。 - 如果 `title` 是空字符串，则使用扩展名作为标题，但 {{WebExtAPIRef("sidebarAction.getTitle")}} 仍会提供空字符串。 + 如果 `title` 是空字符串，则使用附加组件名作为标题，但 {{WebExtAPIRef("sidebarAction.getTitle")}} 仍会提供空字符串。 如果 `title` 为 `null`： From cada66590e541a89a19ea9df4e09cb2a675a96a1 Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Wed, 4 Dec 2024 22:54:27 +0800 Subject: [PATCH 07/14] Apply suggestions from code review Co-authored-by: A1lo --- .../add-ons/webextensions/api/sidebaraction/settitle/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md index 2d773e13f48e82..48ee927aa26633 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md @@ -7,11 +7,11 @@ l10n: {{AddonSidebar}} -设置侧边栏的标题。标题显示在浏览器列出可用侧边栏的任何地方。例如，Firefox 会在“查看 > 侧边栏”菜单中显示它。当侧边栏打开时，它还会显示在侧边栏的顶部。 +设置侧边栏的标题。标题显示在浏览器列出可用侧边栏的任何地方。例如，Firefox 会在“查看 > 侧栏”菜单中显示它。当侧边栏打开时，它还会显示在侧边栏的顶部。 ## 标题类型 -你的附加组件应该在 [sidebar_action](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action) manifest 键中指定侧边栏的标题（这被称为“_manifest 标题_”）。如果你没有指定 manifest 标题，它将使用默认值即附加组件名。 +你的附加组件应该在 [sidebar_action](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action)“manifest”键中指定侧边栏的标题（这被称为“_manifest 标题_”）。如果你没有指定“manifest”标题，它将使用默认值即附加组件名。 如果你使用 `setTitle()` 设置新标题，并包含 `tabId` 选项，那么标题仅为给定的标签设置。这个标题称为“_标签特定标题_”。 From e8d72fa45edfd86c53e38133b51eef3846caa5ac Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Thu, 5 Dec 2024 11:00:27 +0800 Subject: [PATCH 08/14] Update index.md --- .../add-ons/webextensions/api/sidebaraction/settitle/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md index 48ee927aa26633..e9f64caccb9980 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md @@ -11,7 +11,7 @@ l10n: ## 标题类型 -你的附加组件应该在 [sidebar_action](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action)“manifest”键中指定侧边栏的标题（这被称为“_manifest 标题_”）。如果你没有指定“manifest”标题，它将使用默认值即附加组件名。 +你的附加组件应该在 [sidebar_action](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action) 清单键中指定侧边栏的标题（这被称为“_manifest 标题_”）。如果你没有指定清单标题，它将使用默认值即附加组件名。 如果你使用 `setTitle()` 设置新标题，并包含 `tabId` 选项，那么标题仅为给定的标签设置。这个标题称为“_标签特定标题_”。 From 6b8823d376a3c63fabc4db38503ba406a0e173fe Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Thu, 5 Dec 2024 11:05:47 +0800 Subject: [PATCH 09/14] Update index.md --- .../add-ons/webextensions/api/sidebaraction/settitle/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md index e9f64caccb9980..815aedfc38ecf6 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md @@ -11,7 +11,7 @@ l10n: ## 标题类型 -你的附加组件应该在 [sidebar_action](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action) 清单键中指定侧边栏的标题（这被称为“_manifest 标题_”）。如果你没有指定清单标题，它将使用默认值即附加组件名。 +你的附加组件应该在 [sidebar_action](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action) 清单键中指定侧边栏的标题（这被称为“清单标题_”）。如果你没有指定清单标题，它将使用默认值即附加组件名。 如果你使用 `setTitle()` 设置新标题，并包含 `tabId` 选项，那么标题仅为给定的标签设置。这个标题称为“_标签特定标题_”。 From 14125ad174f4d47b9eb80ef76604f47d679f6ed3 Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Thu, 5 Dec 2024 11:11:34 +0800 Subject: [PATCH 10/14] Update index.md --- .../add-ons/webextensions/api/sidebaraction/settitle/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md index 815aedfc38ecf6..ec724c1cae45dd 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md @@ -11,7 +11,7 @@ l10n: ## 标题类型 -你的附加组件应该在 [sidebar_action](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action) 清单键中指定侧边栏的标题（这被称为“清单标题_”）。如果你没有指定清单标题，它将使用默认值即附加组件名。 +你的附加组件应该在 [sidebar_action](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action) 清单键中指定侧边栏的标题（这被称为“_清单标题_”）。如果你没有指定清单标题，它将使用默认值即附加组件名。 如果你使用 `setTitle()` 设置新标题，并包含 `tabId` 选项，那么标题仅为给定的标签设置。这个标题称为“_标签特定标题_”。 From a66ea2eff4b92370fd2b2d63207b52df93543b2b Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Mon, 9 Dec 2024 18:56:56 +0800 Subject: [PATCH 11/14] Update index.md --- .../api/sidebaraction/settitle/index.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md index ec724c1cae45dd..8379bc994ef3a7 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md @@ -7,17 +7,17 @@ l10n: {{AddonSidebar}} -设置侧边栏的标题。标题显示在浏览器列出可用侧边栏的任何地方。例如，Firefox 会在“查看 > 侧栏”菜单中显示它。当侧边栏打开时，它还会显示在侧边栏的顶部。 +设置侧边栏的标题。标题会在浏览器列出可用侧边栏的地方显示。例如，Firefox 会在“查看 > 侧栏”菜单中显示这一标题。当侧边栏打开时，该标题还会显示在侧边栏的顶部。 ## 标题类型 -你的附加组件应该在 [sidebar_action](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action) 清单键中指定侧边栏的标题（这被称为“_清单标题_”）。如果你没有指定清单标题，它将使用默认值即附加组件名。 +你的拓展应该在 [sidebar_action](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action) 清单键中指定侧边栏的标题（这被称为“_清单标题_”）。如果你没有指定清单标题，则将默认使用拓展名作为标题。 -如果你使用 `setTitle()` 设置新标题，并包含 `tabId` 选项，那么标题仅为给定的标签设置。这个标题称为“_标签特定标题_”。 +如果你使用 `setTitle()` 设置新标题，并包含了 `tabId` 选项，那么标题仅为给定的标签设置。这个标题称为“_标签特定标题_”。 -如果你使用 `setTitle()` 设置新标题，并包含 `windowId` 选项，那么标题仅为给定的窗口设置。这个标题称为“_窗口特定标题_”，并将出现在该窗口的所有标签中，这些标签没有设置标签特定标题。 +如果你使用 `setTitle()` 设置新标题，并包含了 `windowId` 选项，那么标题仅为给定的窗口设置。这个标题称为“_窗口特定标题_”，并将出现在该窗口的所有标签中，这些标签没有设置标签特定标题。 -如果你使用 `setTitle()` 设置新标题，并省略 `tabId` 和 `windowId` 选项，那么这将设置“_全局标题_”。全局标题将出现在所有没有设置标签特定标题的标签中，且其窗口没有设置窗口特定标题的标签中。 +如果你使用 `setTitle()` 设置新标题，并省略了 `tabId` 和 `windowId` 选项，那么这将设置“_全局标题_”。全局标题将出现在所有没有设置标签特定标题的标签中，且其窗口没有设置窗口特定标题的标签中。 ## 语法 @@ -37,7 +37,7 @@ browser.sidebarAction.setTitle( - : `string` 或 `null`。鼠标悬停时浏览器操作应显示的字符串。 - 如果 `title` 是空字符串，则使用附加组件名作为标题，但 {{WebExtAPIRef("sidebarAction.getTitle")}} 仍会提供空字符串。 + 如果 `title` 是空字符串，则使用拓展名作为标题，但 {{WebExtAPIRef("sidebarAction.getTitle")}} 仍会提供空字符串。 如果 `title` 为 `null`： From e4f8edb59808230a9f2fec8ccebcee31277b3371 Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Mon, 9 Dec 2024 18:58:53 +0800 Subject: [PATCH 12/14] Update index.md --- .../webextensions/api/sidebaraction/settitle/index.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md index 8379bc994ef3a7..bbe89fdf7f342c 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md @@ -31,19 +31,19 @@ browser.sidebarAction.setTitle( - `details` - - : `object`。新标题和可选的目标标签页或窗口 ID。 + - : `object`，包含下述属性的对象： - `title` - - : `string` 或 `null`。鼠标悬停时浏览器操作应显示的字符串。 + - : `string` 或 `null`，侧边栏的新标题。 如果 `title` 是空字符串，则使用拓展名作为标题，但 {{WebExtAPIRef("sidebarAction.getTitle")}} 仍会提供空字符串。 - 如果 `title` 为 `null`： + 如果 `title` 为 `null`，那么之前设置的标题将会被移除，并且： - 如果指定了 `tabId`，并且该标签页设置了特定的标签页标题，则该标签页将继承其所属窗口的标题。 - 如果指定了 `windowId`，并且该窗口设置了特定的窗口标题，则该窗口将继承全局标题。 - - 否则，全局标题将重置为清单中的标题。 + - 否则，全局标题将被重置为清单标题。 - `tabId` {{optional_inline}} - : `integer`。仅为指定的标签页设置标题。 From 9791065dafa88f7a13801ad99a7176730603e87c Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Wed, 11 Dec 2024 11:46:26 +0800 Subject: [PATCH 13/14] Update index.md --- .../add-ons/webextensions/api/sidebaraction/settitle/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md index bbe89fdf7f342c..666653dfe98e0e 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md @@ -11,7 +11,7 @@ l10n: ## 标题类型 -你的拓展应该在 [sidebar_action](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action) 清单键中指定侧边栏的标题（这被称为“_清单标题_”）。如果你没有指定清单标题，则将默认使用拓展名作为标题。 +你的扩展应该在 [sidebar_action](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action) 清单键中指定侧边栏的标题（这被称为“_清单标题_”）。如果你没有指定清单标题，则将默认使用扩展名作为标题。 如果你使用 `setTitle()` 设置新标题，并包含了 `tabId` 选项，那么标题仅为给定的标签设置。这个标题称为“_标签特定标题_”。 @@ -37,7 +37,7 @@ browser.sidebarAction.setTitle( - : `string` 或 `null`，侧边栏的新标题。 - 如果 `title` 是空字符串，则使用拓展名作为标题，但 {{WebExtAPIRef("sidebarAction.getTitle")}} 仍会提供空字符串。 + 如果 `title` 是空字符串，则使用扩展名作为标题，但 {{WebExtAPIRef("sidebarAction.getTitle")}} 仍会提供空字符串。 如果 `title` 为 `null`，那么之前设置的标题将会被移除，并且： From e0d59f0849cc651bf8648ae295b2d278682c65ad Mon Sep 17 00:00:00 2001 From: A1lo Date: Fri, 13 Dec 2024 22:39:35 +0800 Subject: [PATCH 14/14] Apply suggestions from code review --- .../webextensions/api/sidebaraction/settitle/index.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md index 666653dfe98e0e..0d1187527c5b70 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md @@ -2,7 +2,7 @@ title: sidebarAction.setTitle() slug: Mozilla/Add-ons/WebExtensions/API/sidebarAction/setTitle l10n: - sourceCommit: b8a0743ca8b1e1b1b1a95cc93a4413c020f11262 + sourceCommit: 665b94c45d49c71009c3e6c9a9e0f601b6af0d82 --- {{AddonSidebar}} @@ -13,11 +13,11 @@ l10n: 你的扩展应该在 [sidebar_action](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action) 清单键中指定侧边栏的标题（这被称为“_清单标题_”）。如果你没有指定清单标题，则将默认使用扩展名作为标题。 -如果你使用 `setTitle()` 设置新标题，并包含了 `tabId` 选项，那么标题仅为给定的标签设置。这个标题称为“_标签特定标题_”。 +如果你使用 `setTitle()` 设置新标题，并包含了 `tabId` 选项，那么标题仅为给定的标签页设置。这个标题称为“_标签页特定标题_”。 -如果你使用 `setTitle()` 设置新标题，并包含了 `windowId` 选项，那么标题仅为给定的窗口设置。这个标题称为“_窗口特定标题_”，并将出现在该窗口的所有标签中，这些标签没有设置标签特定标题。 +如果你使用 `setTitle()` 设置新标题，并包含了 `windowId` 选项，那么标题仅为给定的窗口设置。这个标题称为“_窗口特定标题_”，并将出现在该窗口的所有没有设置标签页特定标题的标签页中。 -如果你使用 `setTitle()` 设置新标题，并省略了 `tabId` 和 `windowId` 选项，那么这将设置“_全局标题_”。全局标题将出现在所有没有设置标签特定标题的标签中，且其窗口没有设置窗口特定标题的标签中。 +如果你使用 `setTitle()` 设置新标题，并省略了 `tabId` 和 `windowId` 选项，那么这将设置“_全局标题_”。全局标题将出现在所有没有设置标签页特定标题的标签中，且其窗口没有设置窗口特定标题的标签页中。 ## 语法 @@ -41,7 +41,7 @@ browser.sidebarAction.setTitle( 如果 `title` 为 `null`，那么之前设置的标题将会被移除，并且： - - 如果指定了 `tabId`，并且该标签页设置了特定的标签页标题，则该标签页将继承其所属窗口的标题。 + - 如果指定了 `tabId`，并且该标签页设置了标签页特定的标题，则该标签页将继承其所属窗口的标题。 - 如果指定了 `windowId`，并且该窗口设置了特定的窗口标题，则该窗口将继承全局标题。 - 否则，全局标题将被重置为清单标题。