From 8157be69d44155abcc8a8e1c7402df13161acba5 Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Sun, 15 Dec 2024 22:25:47 +0800 Subject: [PATCH 1/3] feat: update translation --- .../api/omnibox/oninputstarted/index.md | 53 +++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 files/zh-cn/mozilla/add-ons/webextensions/api/omnibox/oninputstarted/index.md diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/omnibox/oninputstarted/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/omnibox/oninputstarted/index.md new file mode 100644 index 00000000000000..46160dd0ffa5d2 --- /dev/null +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/omnibox/oninputstarted/index.md @@ -0,0 +1,53 @@ +--- +title: omnibox.onInputStarted +slug: Mozilla/Add-ons/WebExtensions/API/omnibox/onInputStarted +l10n: + sourceCommit: +--- + +{{AddonSidebar}} + +当用户开始与扩展交互（在地址栏输入关键词以及一个空格）时触发。 + +这个事件将在任何 {{WebExtAPIRef("omnibox.onInputChanged")}} 事件之前发送。 + +## 语法 + +```js-nolint +browser.omnibox.onInputStarted.addListener(listener) +browser.omnibox.onInputStarted.removeListener(listener) +browser.omnibox.onInputStarted.hasListener(listener) +``` + +事件有三个函数： + +- `addListener(listener)` + - : 添加一个监听器到这个事件。 +- `removeListener(listener)` + - : 停止监听这个事件。`listener` 参数是要移除的监听器。 +- `hasListener(listener)` + - : 检查 `listener` 是否已注册到这个事件。若在监听，返回 `true`，否则返回 `false`。 + +## addListener 语法 + +### 参数 + +- `listener` + - : 当这个事件发生时调用的函数。该函数不接收任何参数。 + +## 浏览器兼容性 + +{{Compat}} + +## 示例 + +```js +browser.omnibox.onInputStarted.addListener(() => { + console.log("用户已经开始交互"); +}); +``` + +{{WebExtExamples}} + +> [!NOTE] +> 该 API 基于 Chromium 的 [`chrome.omnibox`](https://developer.chrome.google.cn/docs/extensions/reference/api/omnibox) API。 From ebdaa9470663125f75815d735b590378183af6f1 Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Sun, 15 Dec 2024 22:40:26 +0800 Subject: [PATCH 2/3] Update index.md --- .../add-ons/webextensions/api/omnibox/oninputstarted/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/omnibox/oninputstarted/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/omnibox/oninputstarted/index.md index 46160dd0ffa5d2..471ce5b04fe5ae 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/omnibox/oninputstarted/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/omnibox/oninputstarted/index.md @@ -2,12 +2,12 @@ title: omnibox.onInputStarted slug: Mozilla/Add-ons/WebExtensions/API/omnibox/onInputStarted l10n: - sourceCommit: + sourceCommit: b8a0743ca8b1e1b1b1a95cc93a4413c020f11262 --- {{AddonSidebar}} -当用户开始与扩展交互（在地址栏输入关键词以及一个空格）时触发。 +当用户开始与扩展交互（在地址栏输入扩展的关键词以及一个空格）时触发。 这个事件将在任何 {{WebExtAPIRef("omnibox.onInputChanged")}} 事件之前发送。 From 3999110bcaa7097e63dabf066262dd2c28b1857b Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Sat, 28 Dec 2024 20:18:07 +0800 Subject: [PATCH 3/3] Update index.md --- .../webextensions/api/omnibox/oninputstarted/index.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/omnibox/oninputstarted/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/omnibox/oninputstarted/index.md index 471ce5b04fe5ae..4998f7e72c93dc 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/omnibox/oninputstarted/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/omnibox/oninputstarted/index.md @@ -22,18 +22,18 @@ browser.omnibox.onInputStarted.hasListener(listener) 事件有三个函数： - `addListener(listener)` - - : 添加一个监听器到这个事件。 + - : 为此事件添加监听器。 - `removeListener(listener)` - - : 停止监听这个事件。`listener` 参数是要移除的监听器。 + - : 停止监听此事件。`listener` 参数是要移除的监听器。 - `hasListener(listener)` - - : 检查 `listener` 是否已注册到这个事件。若在监听，返回 `true`，否则返回 `false`。 + - : 检查是否已为此事件注册了 `listener`。若正在监听，返回 `true`，否则返回 `false`。 ## addListener 语法 ### 参数 - `listener` - - : 当这个事件发生时调用的函数。该函数不接收任何参数。 + - : 当此事件发生时调用的函数。该函数不需要传递任何参数。 ## 浏览器兼容性