diff --git a/files/es/learn_web_development/extensions/forms/your_first_form/index.md b/files/es/learn_web_development/extensions/forms/your_first_form/index.md
index fca7b0b0d843fa..96e7fe3a728744 100644
--- a/files/es/learn_web_development/extensions/forms/your_first_form/index.md
+++ b/files/es/learn_web_development/extensions/forms/your_first_form/index.md
@@ -14,7 +14,7 @@ El primer artículo de nuestra serie te proporciona una primera experiencia de c
Prerrequisitos:
Conocimientos básicos de informática y de
- lenguaje HTML .
+ lenguaje HTML .
@@ -47,7 +47,7 @@ Diseñar formularios es un paso importante cuando creas un sitio web o una aplic
En este artículo, vamos a crear un formulario de contacto sencillo. Hagamos un esbozo.
-
+
Nuestro formulario va a tener tres campos de texto y un botón. Le pedimos al usuario su nombre, su correo electrónico y el mensaje que desea enviar. Al pulsar el botón sus datos se enviarán a un servidor web.
@@ -57,7 +57,7 @@ De acuerdo, intentemos crear el HTML para nuestro formulario. Vamos a utilizar l
Antes de continuar, haz una copia local de nuestra [plantilla HTML simple](https://github.com/mdn/learning-area/blob/master/html/introduction-to-html/getting-started/index.html): introduce aquí tu formulario HTML.
-### El elemento {{HTMLelement("form")}}
+### El elemento `form`
Todos los formularios comienzan con un elemento {{HTMLelement("form")}}, como este:
@@ -65,7 +65,7 @@ Todos los formularios comienzan con un elemento {{HTMLelement("form")}}, como es
```
-Este elemento define formalmente un formulario. Es un elemento contenedor, como un elemento {{HTMLelement("section")}} o {{HTMLelement("footer")}}, pero específico para contener formularios; también admite algunos atributos específicos para la configuración de la forma en que se comporta el formulario. Todos sus atributos son opcionales, pero es una práctica estándar establecer siempre al menos los atributos [`action`](/es/docs/Web/HTML/Attributes/action) y [`method`](/es/docs/Web/HTML/Attributes/method):
+Este elemento define formalmente un formulario. Es un elemento contenedor, como un elemento {{HTMLelement("section")}} o {{HTMLelement("footer")}}, pero específico para contener formularios; también admite algunos atributos específicos para la configuración de la forma en que se comporta el formulario. Todos sus atributos son opcionales, pero es una práctica estándar establecer siempre al menos los atributos [`action`](/es/docs/Web/HTML/Element/form#action) y [`method`](/es/docs/Web/HTML/Element/form#method):
- El atributo `action` define la ubicación (URL) donde se envían los datos que el formulario ha recopilado cuando se validan.
- El atributo `method` define con qué método HTTP se envían los datos (generalmente `get` o `post`).
@@ -75,7 +75,7 @@ Este elemento define formalmente un formulario. Es un elemento contenedor, como
Por ahora, añade el elemento {{htmlelement("form")}} anterior a tu elemento HTML {{htmlelement("body")}}.
-### Los elementos {{HTMLelement("label")}}, {{HTMLelement("input")}} y {{HTMLelement("textarea")}}
+### Los elementos ``, `
+slug: Web/SVG/Element/g
+l10n:
+ sourceCommit: 2f43f506240fa6c866cc3bc2d018364ae49421d9
+---
+
+{{SVGRef}}
+
+**``** [SVG](/ko/docs/Web/SVG) 요소는 다른 SVG 요소를 그룹화한 컨테이너입니다.
+
+`` 요소에 적용된 변형 속성은 자식 요소들에서 동작합니다. 그리고 그 특성은 자식 요소에게로 상속됩니다. 이는 또한 다중 요소를 그룹화하여 {{SVGElement("use")}} 요소와 함께 참조될 수 있도록 합니다.
+
+## 예제
+
+```css hidden
+html,
+body,
+svg {
+ height: 100%;
+}
+```
+
+```html
+
+
+
+
+
+```
+
+{{EmbedLiveSample('Example', 100, '100%')}}
+
+## 사용 일람
+
+{{svginfo}}
+
+## 명세서
+
+{{Specifications}}
+
+## 브라우저 호환성
+
+{{Compat}}
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/management/uninstall/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/management/uninstall/index.md
new file mode 100644
index 00000000000000..9f30c6ee38d519
--- /dev/null
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/management/uninstall/index.md
@@ -0,0 +1,97 @@
+---
+title: management.uninstall()
+slug: Mozilla/Add-ons/WebExtensions/API/management/uninstall
+l10n:
+ sourceCommit: c9bad2ef8b5655146481292f3bce7de0dd86ba68
+---
+
+{{AddonSidebar}}
+
+卸载给定 ID 的附加组件。
+
+该 API 需要“management”[API 权限](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions)。
+
+这是一个异步函数，返回一个 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise)。
+
+## 语法
+
+```js-nolint
+let uninstalling = browser.management.uninstall(
+ id, // 字符串
+ options // 对象
+)
+```
+
+### 参数
+
+- `id`
+ - : `string`，要卸载的附加组件的 ID。
+- `options` {{optional_inline}}
+ - : `object`，可能包含单一属性 `showConfirmDialog` 的对象。如果 `showConfirmDialog` 为 `true`，浏览器将显示一个对话框询问用户是否确认卸载该附加组件。
+
+
+
+- 如果 `id` 是调用该方法的附加组件的 ID，`showConfirmDialog` 默认为 `false`。
+- 如果 `id` 是其他附加组件的 ID，则 `showConfirmDialog` 选项将被忽略，并且确认对话框总是会显示。
+
+### 返回值
+
+[`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise)。如果用户取消卸载，则 Promise 会被拒绝并返回一个错误消息。
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 示例
+
+卸载 ID 为“addon-id”的附加组件并询问用户确认。在回调中检查用户是否取消了卸载，以及附加组件的卸载是否成功。
+
+```js
+let id = "addon-id";
+
+function onCanceled(error) {
+ console.log(`取消卸载：${error}`);
+}
+
+function onUninstalled() {
+ console.log("附加组件已被卸载");
+}
+
+let uninstalling = browser.management.uninstall(id);
+uninstalling.then(onUninstalled, onCanceled);
+```
+
+{{WebExtExamples}}
+
+> [!NOTE]
+> 该 API 基于 Chromium 的 [`chrome.management`](https://developer.chrome.google.cn/docs/extensions/reference/api/management#method-uninstall) API。本文衍生自 Chromium 代码中的 [`management.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/management.json)。
+
+
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/notifications/getall/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/notifications/getall/index.md
new file mode 100644
index 00000000000000..283672c2078a88
--- /dev/null
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/notifications/getall/index.md
@@ -0,0 +1,79 @@
+---
+title: notifications.getAll()
+slug: Mozilla/Add-ons/WebExtensions/API/notifications/getAll
+l10n:
+ sourceCommit: b8a0743ca8b1e1b1b1a95cc93a4413c020f11262
+---
+
+{{AddonSidebar}}
+
+获取由当前扩展创建的所有当前活动通知。
+
+这是一个返回 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise) 的异步函数。
+
+## 语法
+
+```js-nolint
+let gettingAll = browser.notifications.getAll()
+```
+
+### 参数
+
+无。
+
+### 返回值
+
+[`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise)，将会以一个对象兑现。所有的活动通知都会是该对象的一个属性，其中属性名为通知 ID 而属性值为描述该通知的 {{WebExtAPIRef("notifications.NotificationOptions")}} 对象。
+
+需要注意，你可以通过将 ID 传递给 {{WebExtAPIRef("notifications.create()")}} 来显式定义通知的 ID。如果你不这样做，浏览器会生成一个 ID。显式指定的 ID 是字符串，而生成的 ID 是数字。
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 示例
+
+下属示例在用户点击浏览器操作时显示一个通知（如果通知已经在显示了则会清除这一通知）。它使用 `getAll()` 来判断通知是否正在显示：
+
+```js
+const myNotification = "my-notification";
+
+function toggleAlarm(all) {
+ const ids = Object.keys(all);
+ if (ids.includes(myNotification)) {
+ browser.notifications.clear(myNotification);
+ } else {
+ console.log("显示");
+
+ browser.notifications.create(myNotification, {
+ type: "basic",
+ title: "一个令人印象深刻的标题",
+ message: "一些有意思的文本内容",
+ });
+ }
+}
+
+function handleClick() {
+ console.log("被点击");
+ browser.notifications.getAll().then(toggleAlarm);
+}
+
+browser.browserAction.onClicked.addListener(handleClick);
+```
+
+下述示例则打印所有活动通知的标题：
+
+```js
+function logNotifications(all) {
+ for (const id in all) {
+ console.log(`标题：${all[id].title}`);
+ }
+}
+
+browser.notifications.getAll().then(logNotifications);
+```
+
+{{WebExtExamples}}
+
+> [!NOTE]
+> 该 API 基于 Chromium 的 [`chrome.notifications`](https://developer.chrome.google.cn/docs/extensions/reference/api/notifications) API。
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/notifications/onclicked/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/notifications/onclicked/index.md
new file mode 100644
index 00000000000000..8306dfe95cb0f5
--- /dev/null
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/notifications/onclicked/index.md
@@ -0,0 +1,57 @@
+---
+title: notifications.onClicked
+slug: Mozilla/Add-ons/WebExtensions/API/notifications/onClicked
+l10n:
+ sourceCommit: b8a0743ca8b1e1b1b1a95cc93a4413c020f11262
+---
+
+{{AddonSidebar}}
+
+当用户点击通知并且点击的并不是通知的按钮时触发（对于点击按钮的事件，参见 {{WebExtAPIRef("notifications.onButtonClicked")}}）。
+
+## 语法
+
+```js-nolint
+browser.notifications.onClicked.addListener(listener)
+browser.notifications.onClicked.removeListener(listener)
+browser.notifications.onClicked.hasListener(listener)
+```
+
+事件有三个函数：
+
+- `addListener(listener)`
+ - : 为此事件添加监听器。
+- `removeListener(listener)`
+ - : 停止监听此事件。`listener` 参数是要移除的监听器。
+- `hasListener(listener)`
+ - : 检查是否已为此事件注册了 `listener`。若正在监听，返回 `true`，否则返回 `false`。
+
+## addListener 语法
+
+### 参数
+
+- `listener`
+
+ - : 当此事件发生时调用的函数。该函数需要你传递下列参数：
+
+ - `notificationId`
+ - : `string`。用户点击的通知的 ID。
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 示例
+
+在下述简单示例中，我们为 `notifications.onClicked` 事件添加一个监听器，以监听用户点击系统通知。当这种情况发生时，我们会在控制台中打印相应的消息。
+
+```js
+browser.notifications.onClicked.addListener((notificationId) => {
+ console.log(`通知 ${notificationId} 被用户点击`);
+});
+```
+
+{{WebExtExamples}}
+
+> [!NOTE]
+> 该 API 基于 Chromium 的 [`chrome.notifications`](https://developer.chrome.google.cn/docs/extensions/reference/api/notifications) API。
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/notifications/onclosed/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/notifications/onclosed/index.md
new file mode 100644
index 00000000000000..34c9eae5befba0
--- /dev/null
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/notifications/onclosed/index.md
@@ -0,0 +1,59 @@
+---
+title: notifications.onClosed
+slug: Mozilla/Add-ons/WebExtensions/API/notifications/onClosed
+l10n:
+ sourceCommit: 1c0dda60cb2b680a753264b538e2c46776ecd837
+---
+
+{{AddonSidebar}}
+
+当通知被关闭（无论是系统关闭还是用户关闭）时触发。
+
+## 语法
+
+```js-nolint
+browser.notifications.onClosed.addListener(listener)
+browser.notifications.onClosed.removeListener(listener)
+browser.notifications.onClosed.hasListener(listener)
+```
+
+事件有三个函数：
+
+- `addListener(listener)`
+ - : 为此事件添加监听器。
+- `removeListener(listener)`
+ - : 停止监听此事件。`listener` 参数是要移除的监听器。
+- `hasListener(listener)`
+ - : 检查是否已为此事件注册了 `listener`。若正在监听，返回 `true`，否则返回 `false`。
+
+## addListener 语法
+
+### 参数
+
+- `listener`
+
+ - : 当此事件发生时调用的函数。该函数需要你传递下列参数：
+
+ - `notificationId`
+ - : `string`。被关闭的通知的 ID。
+ - `byUser`
+ - : `boolean`。如果通知是由用户关闭的，则为 `true`，如果是由系统关闭的，则为 `false`。在 Firefox 中该参数不受支持。
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 示例
+
+在这个简单的示例中，我们为 `notifications.onClosed` 事件添加一个监听器，以监听系统通知的关闭。当发生这种情况时，我们将打印一段适当的消息到控制台中。
+
+```js
+browser.notifications.onClosed.addListener((notificationId) => {
+ console.log(`通知 ${notificationId} 被关闭。`);
+});
+```
+
+{{WebExtExamples}}
+
+> [!NOTE]
+> 该 API 基于 Chromium 的 [`chrome.notifications`](https://developer.chrome.google.cn/docs/extensions/reference/api/notifications) API。
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/notifications/templatetype/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/notifications/templatetype/index.md
new file mode 100644
index 00000000000000..9c784fe182ae8f
--- /dev/null
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/notifications/templatetype/index.md
@@ -0,0 +1,47 @@
+---
+title: notifications.TemplateType
+slug: Mozilla/Add-ons/WebExtensions/API/notifications/TemplateType
+l10n:
+ sourceCommit: b8a0743ca8b1e1b1b1a95cc93a4413c020f11262
+---
+
+{{AddonSidebar}}
+
+这是表示要创建的通知类型的字符串。有四种通知类型：“basic”、“image”、“list”、“progress”。
+
+这将作为 {{WebExtAPIRef("notifications.NotificationOptions", "NotificationOptions")}} 中的 `type` 属性的值传递给 {{WebExtAPIRef("notifications.create()")}} 和 {{WebExtAPIRef("notifications.update()")}}。
+
+## 类型
+
+该类型的取值是字符串。可能的取值包括：
+
+- `"basic"`：通知包括：
+
+ - 标题（`NotificationOptions.title`）
+ - 消息（`NotificationOptions.message`）
+ - 图标（`NotificationOptions.iconUrl`）{{optional_inline}}
+ - 额外消息（`NotificationOptions.contextMessage`）{{optional_inline}}
+ - 最多两个按钮（`NotificationOptions.buttons`）{{optional_inline}}
+
+- `"image"`：包括 `"basic"` 中的所有内容，以及：
+
+ - 图像（`NotificationOptions.imageUrl`）
+
+- `"list"`：包括 `"basic"` 中的所有内容，以及：
+
+ - 项目列表（`NotificationOptions.items`）
+
+- `"progress"`：包括 `"basic"` 中的所有内容，以及：
+
+ - 进度条（`NotificationOptions.progress`）
+
+目前 Firefox 仅支持“basic”。
+
+## 浏览器兼容性
+
+{{Compat}}
+
+{{WebExtExamples}}
+
+> [!NOTE]
+> 该 API 基于 Chromium 的 [`chrome.notifications`](https://developer.chrome.google.cn/docs/extensions/reference/api/notifications) API。
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/omnibox/oninputentered/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/omnibox/oninputentered/index.md
new file mode 100644
index 00000000000000..c50806e8ce401d
--- /dev/null
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/omnibox/oninputentered/index.md
@@ -0,0 +1,128 @@
+---
+title: omnibox.onInputEntered
+slug: Mozilla/Add-ons/WebExtensions/API/omnibox/onInputEntered
+l10n:
+ sourceCommit: b8a0743ca8b1e1b1b1a95cc93a4413c020f11262
+---
+
+{{AddonSidebar}}
+
+当用户选中扩展添加到地址栏下拉菜单的任一推荐时触发。
+
+使用这个事件来处理用户的选择（通常是打开相应的页面）。事件监听器会传递：
+
+- 用户的选择
+- {{WebExtAPIRef("omnibox.OnInputEnteredDisposition")}}：据此决定是在当前标签页中打开新页面，在新的前台标签页中打开，还是在新的后台标签页中打开。
+
+## 语法
+
+```js-nolint
+browser.omnibox.onInputEntered.addListener(listener)
+browser.omnibox.onInputEntered.removeListener(listener)
+browser.omnibox.onInputEntered.hasListener(listener)
+```
+
+事件有三个函数：
+
+- `addListener(listener)`
+ - : 为此事件添加监听器。
+- `removeListener(listener)`
+ - : 停止监听此事件。`listener` 参数是要移除的监听器。
+- `hasListener(listener)`
+ - : 检查是否已为此事件注册了 `listener`。若正在监听，返回 `true`，否则返回 `false`。
+
+## addListener 语法
+
+该监听器函数需要传递两个参数：字符串 `text` 以及 {{WebExtAPIRef("omnibox.OnInputEnteredDisposition", "OnInputEnteredDisposition")}}。
+
+### 参数
+
+- `text`
+ - : `String`。这是用户选择的 {{WebExtAPIRef("omnibox.SuggestResult")}} 对象的 `content` 属性的值。
+- `disposition`
+ - : {{WebExtAPIRef("omnibox.OnInputEnteredDisposition", "OnInputEnteredDisposition")}}。{{WebExtAPIRef("omnibox.OnInputEnteredDisposition")}} 枚举，指示扩展应该在当前标签页中打开页面，还是在新的前台标签页中打开，还是在新的后台标签页中打开。
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 示例
+
+本示例将用户输入的内容解释为 CSS 属性名称，并为每个与输入内容匹配的 CSS 属性在下拉列表中填充一个 {{WebExtAPIRef("omnibox.SuggestResult")}} 对象。`SuggestResult` 的 `description` 属性将为该属性的全名，而 `content` 将是该属性的 MDN 页面。
+
+本示例还会监听 `omnibox.onInputEntered` 并根据 {{WebExtAPIRef("omnibox.OnInputEnteredDisposition")}} 参数打开与选择相对应的 MDN 页面。
+
+```js
+browser.omnibox.setDefaultSuggestion({
+ description: "输入一个 CSS 属性名",
+});
+
+/*
+包含一些 CSS 属性的非常短的列表
+*/
+const props = [
+ "animation",
+ "background",
+ "border",
+ "box-shadow",
+ "color",
+ "display",
+ "flex",
+ "flex",
+ "float",
+ "font",
+ "grid",
+ "margin",
+ "opacity",
+ "overflow",
+ "padding",
+ "position",
+ "transform",
+ "transition",
+];
+
+const baseURL = "https://developer.mozilla.org/zh-CN/docs/Web/CSS/";
+
+/*
+返回一个 SuggestResult 对象数组，每个对象代表一个与用户输入匹配的 CSS 属性。
+*/
+function getMatchingProperties(input) {
+ const result = [];
+ for (const prop of props) {
+ if (prop.startsWith(input)) {
+ console.log(prop);
+ const suggestion = {
+ content: `${baseURL}${prop}`,
+ description: prop,
+ };
+ result.push(suggestion);
+ } else if (result.length !== 0) {
+ return result;
+ }
+ }
+ return result;
+}
+
+browser.omnibox.onInputChanged.addListener((input, suggest) => {
+ suggest(getMatchingProperties(input));
+});
+
+browser.omnibox.onInputEntered.addListener((url, disposition) => {
+ switch (disposition) {
+ case "currentTab":
+ browser.tabs.update({ url });
+ break;
+ case "newForegroundTab":
+ browser.tabs.create({ url });
+ break;
+ case "newBackgroundTab":
+ browser.tabs.create({ url, active: false });
+ break;
+ }
+});
+```
+
+{{WebExtExamples}}
+
+> [!NOTE]
+> 该 API 基于 Chromium 的 [`chrome.omnibox`](https://developer.chrome.google.cn/docs/extensions/reference/api/omnibox) API。
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/omnibox/oninputentereddisposition/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/omnibox/oninputentereddisposition/index.md
new file mode 100644
index 00000000000000..2027015f7a9f89
--- /dev/null
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/omnibox/oninputentereddisposition/index.md
@@ -0,0 +1,30 @@
+---
+title: omnibox.OnInputEnteredDisposition
+slug: Mozilla/Add-ons/WebExtensions/API/omnibox/OnInputEnteredDisposition
+l10n:
+ sourceCommit: b8a0743ca8b1e1b1b1a95cc93a4413c020f11262
+---
+
+{{AddonSidebar}}
+
+**`omnibox.OnInputEnteredDisposition`** 类型描述了扩展应如何处理用户在地址栏的下拉菜单中的推荐中的选择。
+
+它将与选择本身一起传递到 {{WebExtAPIRef("omnibox.onInputEntered")}} 事件监听器中。
+
+## 类型
+
+该类型的取值是字符串，可以取以下值之一：
+
+- "currentTab"
+ - : 在当前标签页中打开选择的内容。
+- "newForegroundTab"
+ - : 在新标签页中打开选择的内容，并将新标签页置于前台。
+- "newBackgroundTab"
+ - : 在新后台标签页中打开选择的内容，并保持当前标签页在前台。
+
+## 浏览器兼容性
+
+{{Compat}}
+
+> [!NOTE]
+> 该 API 基于 Chromium 的 [`chrome.omnibox`](https://developer.chrome.google.cn/docs/extensions/reference/api/omnibox) API。
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/omnibox/setdefaultsuggestion/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/omnibox/setdefaultsuggestion/index.md
new file mode 100644
index 00000000000000..7dc1279dbe8331
--- /dev/null
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/omnibox/setdefaultsuggestion/index.md
@@ -0,0 +1,46 @@
+---
+title: omnibox.setDefaultSuggestion()
+slug: Mozilla/Add-ons/WebExtensions/API/omnibox/setDefaultSuggestion
+l10n:
+ sourceCommit: b8a0743ca8b1e1b1b1a95cc93a4413c020f11262
+---
+
+{{AddonSidebar}}
+
+设置用户与扩展交互时在地址栏下拉菜单中显示的默认建议。
+
+一旦用户输入了你的关键词并开始与你的扩展交互，这个默认建议将始终出现在下拉菜单的第一项。与你在 {{WebExtAPIRef("omnibox.onInputChanged")}} 中提供的建议不同，这个项目不能被选中。使用它来为用户提供关于输入内容以及如果他们输入这样的内容他们将会看到的内容的指导。
+
+## 语法
+
+```js-nolint
+browser.omnibox.setDefaultSuggestion(
+ suggestion // 对象
+)
+```
+
+### 参数
+
+- `suggestion`
+ - : `object`。包含一个字符串属性 `description` 的对象，当用户开始与你的扩展交互时，这将在下拉菜单中的第一项处显示。
+
+### 返回值
+
+无。
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 示例
+
+```js
+browser.omnibox.setDefaultSuggestion({
+ description: "输入 CSS 属性名",
+});
+```
+
+{{WebExtExamples}}
+
+> [!NOTE]
+> 该 API 基于 Chromium 的 [`chrome.omnibox`](https://developer.chrome.google.cn/docs/extensions/reference/api/omnibox) API。
diff --git a/files/zh-cn/web/api/uievent/index.md b/files/zh-cn/web/api/uievent/index.md
index 29aee4d8c508aa..2fa1f51f3f5112 100644
--- a/files/zh-cn/web/api/uievent/index.md
+++ b/files/zh-cn/web/api/uievent/index.md
@@ -1,50 +1,44 @@
---
title: UIEvent
slug: Web/API/UIEvent
+l10n:
+ sourceCommit: 5b20f5f4265f988f80f513db0e4b35c7e0cd70dc
---
{{APIRef("UI Events")}}
-`UIEvent` 接口表示简单的用户界面事件。
+**`UIEvent`** 接口表示简单的用户界面事件。
`UIEvent` 是从 {{domxref("Event")}} 派生出来的。尽管 {{domxref("UIEvent.initUIEvent()")}} 方法为了向后兼容而一直保留着，但是你应该使用 {{domxref("UIEvent.UIEvent", "UIEvent()")}} 构造器来创建 `UIEvent` 对象。
-某些接口是这个的直接或间接后代：{{domxref("MouseEvent")}}, {{domxref("TouchEvent")}}, {{domxref("FocusEvent")}}, {{domxref("KeyboardEvent")}}, {{domxref("WheelEvent")}}, {{domxref("InputEvent")}}, 和{{domxref("CompositionEvent")}}.
+某些接口是此接口的直接或间接后代：{{domxref("MouseEvent")}}、{{domxref("TouchEvent")}}、{{domxref("FocusEvent")}}、{{domxref("KeyboardEvent")}}、{{domxref("WheelEvent")}}、{{domxref("InputEvent")}} 和 {{domxref("CompositionEvent")}}。
-## Constructors
+{{InheritanceDiagram}}
+
+## 构造函数
- {{domxref("UIEvent.UIEvent()", "UIEvent()")}}
- - : 创建一个 `UIEvent` 对象
-
-## 属性
-
-_也继承了父代 {{domxref("Event")}} 的一些属性。_
-
-- {{domxref("UIEvent.cancelBubble")}} {{Non-standard_inline}} {{Deprecated_inline}}
- - : 返回一个 {{jsxref("Boolean")}}，表示该事件的冒泡是否被取消。
-- {{domxref("UIEvent.detail")}}{{readonlyinline}}
- - : Returns a `long` with details about the event, depending on the event type.
-- {{domxref("UIEvent.layerX")}} {{Non-standard_inline}} {{readonlyinline}}
- - : 返回事件相对于当前层的水平坐标。
-- {{domxref("UIEvent.layerY")}} {{Non-standard_inline}} {{readonlyinline}}
- - : 返回事件相对于当前层的垂直坐标。
-- {{domxref("UIEvent.pageX")}} {{Non-standard_inline}} {{readonlyinline}}
- - : 返回事件相对于整个文档的水平坐标。
-- {{domxref("UIEvent.pageY")}} {{Non-standard_inline}} {{readonlyinline}}
- - : 返回事件相对于整个文档的垂直坐标。
-- {{domxref("UIEvent.sourceCapabilities")}} {{non-standard_inline}} {{readonlyinline}}
- - : 返回输入设备功能接口的一个实例，它提供有关负责生成 touch 事件的物理设备的信息。
-- {{domxref("UIEvent.view")}}{{readonlyinline}}
- - : 返回一个包含了产生该事件的视图的 {{domxref("WindowProxy")}} 。
-- {{domxref("UIEvent.which")}} {{Non-standard_inline}} {{readonlyinline}}
- - : 返回一个对应（键盘）按下的数字类型的 `keyCode` ，或者一个字母数字键按下时的字符码 (`charCode`)。
-
-## 方法
-
-_也继承了父代 {{domxref("Event")}} 的一些方法。_
+ - : 创建一个 `UIEvent` 对象。
+
+## 实例属性
+
+_此接口也继承了父接口 {{domxref("Event")}} 的一些属性。_
+
+- {{domxref("UIEvent.detail")}}{{ReadOnlyInline}}
+ - : 返回一个 `long`，其中包含有关事件的详细信息，具体取决于事件类型。
+- {{domxref("UIEvent.sourceCapabilities")}} {{Experimental_Inline}} {{ReadOnlyInline}}
+ - : 返回 `InputDeviceCapabilities` 接口的实例，它提供有关负责生成 touch 事件的物理设备的信息。
+- {{domxref("UIEvent.view")}}{{ReadOnlyInline}}
+ - : 返回一个包含了产生该事件的视图的 {{glossary("WindowProxy")}} 。
+- {{domxref("UIEvent.which")}} {{Deprecated_Inline}} {{ReadOnlyInline}}
+ - : 返回一个对应（键盘）按下的数字类型的 `keyCode`，或者一个字母数字键按下时的字符码（`charCode`）。
+
+## 实例方法
+
+_也继承了父接口 {{domxref("Event")}} 的一些方法。_
- {{domxref("UIEvent.initUIEvent()")}} {{deprecated_inline}}
- - : 初始化一个 `UIEvent` 对象。如果事件已经被分派，这个方法什么都不做。
+ - : 初始化一个 `UIEvent` 对象。如果事件已经被派发，这个方法什么都不做。
## 规范
@@ -54,7 +48,7 @@ _也继承了父代 {{domxref("Event")}} 的一些方法。_
{{Compat}}
-## 相关链接
+## 参见
-- [Introduction to events](/zh-CN/docs/Learn_web_development/Core/Scripting/Events)
+- [事件介绍](/zh-CN/docs/Learn_web_development/Core/Scripting/Events)
- {{domxref("Event")}}
diff --git a/files/zh-cn/web/api/uievent/sourcecapabilities/index.md b/files/zh-cn/web/api/uievent/sourcecapabilities/index.md
new file mode 100644
index 00000000000000..e4bd860b66bce5
--- /dev/null
+++ b/files/zh-cn/web/api/uievent/sourcecapabilities/index.md
@@ -0,0 +1,26 @@
+---
+title: UIEvent：sourceCapabilities 属性
+slug: Web/API/UIEvent/sourceCapabilities
+l10n:
+ sourceCommit: 8cac4a3fed6a702840efd2deda67a922120732d0
+---
+
+{{APIRef("Input Device Capabilities API")}}{{SeeCompatTable}}
+
+{{domxref("UIEvent")}} 接口的 **`sourceCapabilities`** 只读属性返回 {{domxref('InputDeviceCapabilities')}} 接口的一个实例，该实例提供有关负责生成触摸事件的物理设备的信息。如果没有输入设备对事件负责，则返回 `null`。
+
+当单个用户与输入设备的交互生成一系列不同的输入事件时，所有这些事件的 `sourceCapabilities` 属性将指向 `InputDeviceCapabilities` 的同一个实例。例如，当用户将手指从触摸屏上抬起时，可能会生成若干个 UIEvent，包括 `touchend`、`mousedown`、`click` 和 `focus`。所有这些事件必须具有表示触摸屏的相同 `sourceCapabilities`。
+
+只有当该交互是 Web 平台提供的抽象的一部分时，设备才被视为对事件“负责”。例如，许多用户代理允许使用鼠标或键盘调整窗口大小，但这个细节不会以任何方式暴露给 Web 平台，因此 resize 事件的 sourceCapabilities 通常为 null。
+
+## 值
+
+{{domxref('InputDeviceCapabilities')}} 的实例。
+
+## 规范
+
+{{Specifications}}
+
+## 浏览器兼容性
+
+{{Compat}}
diff --git a/files/zh-cn/web/api/uievent/view/index.md b/files/zh-cn/web/api/uievent/view/index.md
index cc9920253a6d1c..895e2aad3142c0 100644
--- a/files/zh-cn/web/api/uievent/view/index.md
+++ b/files/zh-cn/web/api/uievent/view/index.md
@@ -1,24 +1,22 @@
---
-title: 用户界面项目视图
+title: UIEvent：view 属性
slug: Web/API/UIEvent/view
+l10n:
+ sourceCommit: 0c8a320b035cf625c1df67713a94ead2e7f3aec6
---
{{APIRef("UI Events")}}
-The **`UIEvent.view`** 只读属性返回的生成事件的 {{domxref("document.defaultView")}} (`window` of the document) 对象。在浏览器中，这是事件所在的 {{ domxref("Window") }} 对象。
+**`UIEvent.view`** 只读属性返回 {{glossary("WindowProxy")}} 生成事件的对象。在浏览器中，这个事件发生在 {{domxref("Window")}} 对象。
-## 语法
-
-```plain
-var view = event.view;
-```
+## 值
- `view` 是对 `AbstractView` 对象的引用。
-## 技术参数
+## 规范
{{Specifications}}
-## 浏览器的兼容性
+## 浏览器兼容性
{{Compat}}
diff --git a/files/zh-cn/web/api/workletglobalscope/index.md b/files/zh-cn/web/api/workletglobalscope/index.md
new file mode 100644
index 00000000000000..9a9410a771e8b1
--- /dev/null
+++ b/files/zh-cn/web/api/workletglobalscope/index.md
@@ -0,0 +1,34 @@
+---
+title: WorkletGlobalScope
+slug: Web/API/WorkletGlobalScope
+l10n:
+ sourceCommit: e561fa67af347b9770b359ba93e8579d2a540682
+---
+
+{{APIRef("HTML DOM")}}{{SecureContext_Header}}
+
+**`WorkletGlobalScope`** 接口是一个抽象类，特定的 worklet 作用域类从该类继承。每个 `WorkletGlobalScope` 都定义了一个新的全局环境。
+
+> [!NOTE]
+> 通常情况下，你不需要与此接口进行交互。它是一个基础接口，旨在被子类化。你将在 {{domxref("AudioWorklet")}} 对象中遇到子类 {{domxref("AudioWorkletGlobalScope")}}，或在 CSS 绘制 {{domxref("Worklet")}} 对象中遇到子类 {{domxref("PaintWorkletGlobalScope")}}。
+
+## 实例属性
+
+无。
+
+## 实例方法
+
+无。
+
+## 规范
+
+{{Specifications}}
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 参见
+
+- {{domxref("AudioWorkletGlobalScope")}}
+- {{domxref("PaintWorkletGlobalScope")}}
diff --git a/files/zh-cn/web/javascript/reference/global_objects/boolean/valueof/index.md b/files/zh-cn/web/javascript/reference/global_objects/boolean/valueof/index.md
index afc1f5a813876d..d7985ca86a1186 100644
--- a/files/zh-cn/web/javascript/reference/global_objects/boolean/valueof/index.md
+++ b/files/zh-cn/web/javascript/reference/global_objects/boolean/valueof/index.md
@@ -1,37 +1,43 @@
---
title: Boolean.prototype.valueOf()
slug: Web/JavaScript/Reference/Global_Objects/Boolean/valueOf
+l10n:
+ sourceCommit: 86aba12ebfdca9fb1de77afb08cc78a0c9e44d45
---
{{JSRef}}
-**`valueOf()`** 方法返回一个{{jsxref("Boolean")}}对象的原始值。
+{{jsxref("Boolean")}} 值的 **`valueOf()`** 方法返回 {{jsxref("Boolean")}} 对象的原始值。
{{EmbedInteractiveExample("pages/js/boolean-valueof.html")}}
## 语法
-```plain
-bool.valueOf()
+```js-nolint
+valueOf()
```
+### 参数
+
+无。
+
### 返回值
-给定{{jsxref("Boolean")}}对象的原始值
+给定 {{jsxref("Boolean")}} 对象的原始值。
## 描述
-{{jsxref("Boolean")}}的 `valueOf` 方法返回一个{{jsxref("Boolean")}}对象或{{jsxref("Boolean")}}字面量的原始值作为布尔数据类型。
+{{jsxref("Boolean")}} 的 `valueOf()` 方法以布尔数据类型返回 `Boolean` 对象或 `Boolean` 字面量的原始值。
该方法通常在 JavaScript 内部调用，而不是在代码中显式调用。
## 示例
-### 使用 `valueOf`
+### 使用 `valueOf()`
```js
-x = new Boolean();
-myVar = x.valueOf(); // assigns false to myVar
+const x = new Boolean();
+const myVar = x.valueOf(); // 给 myVar 赋值 false
```
## 规范
diff --git a/files/zh-cn/web/javascript/reference/operators/import/index.md b/files/zh-cn/web/javascript/reference/operators/import/index.md
new file mode 100644
index 00000000000000..06162465d7d2d9
--- /dev/null
+++ b/files/zh-cn/web/javascript/reference/operators/import/index.md
@@ -0,0 +1,198 @@
+---
+title: import()
+slug: Web/JavaScript/Reference/Operators/import
+l10n:
+ sourceCommit: eb7cf694c19b31ee8826f22eaac6c12e808b1e50
+---
+
+{{jsSidebar("Operators")}}
+
+**`import()`** 语法（通常被称为*动态导入*）是一种允许异步和动态地将 ECMAScript 模块加载到一个潜在的非模块环境中的类函数表达式。
+
+跟[与之对应的声明式风格](/zh-CN/docs/Web/JavaScript/Reference/Statements/import)不同，动态导入只有在被需要时才会求值，并提供了更强大的语法灵活性。
+
+## 语法
+
+```js-nolint
+import(moduleName)
+import(moduleName, options)
+```
+
+`import()` 调用是一个类似于函数调用的语法，但 `import` 本身是一个关键字，而不是一个函数。你不能像 `const myImport = import` 那样为其添加别名，这会抛出 {{jsxref("SyntaxError")}}。
+
+只有在运行时也支持 `options` 时，[尾后逗号](/zh-CN/docs/Web/JavaScript/Reference/Trailing_commas)才被允许使用。请查看[浏览器兼容性](#浏览器兼容性)部分。
+
+### 参数
+
+- `moduleName`
+ - : 要导入的模块。标识符的求值是宿主特异的（host-specified），但始终遵循与静态的 [import 声明](/zh-CN/docs/Web/JavaScript/Reference/Statements/import)相同的算法。
+- `options`
+ - : 一个包含了导入选项的对象。以下是可识别的键：
+ - `with`
+ - : [import 属性](/zh-CN/docs/Web/JavaScript/Reference/Statements/import/with)。
+
+### 返回值
+
+返回一个 promise：
+
+- 如果引用的模块被成功加载和求值，则兑现为一个[模块命名空间对象](#模块命名空间对象)：一个包含 `moduleName` 中所有导出的对象。
+- 如果对 `moduleName` 做[字符串强制转换](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#字符串强制转换)时抛出错误，则以抛出的错误拒绝。
+- 如果 `moduleName` 引用的模块不存在，则以实现定义的错误拒绝（Node 使用通用的 `Error`，而所有浏览器使用 `TypeError`）。
+- 如果引用的模块在求值时抛出错误，则以抛出的错误拒绝。
+
+> **备注：** `import()` 从来不会同步地抛出错误。
+
+## 描述
+
+import 声明语法（`import something from "somewhere"`）是静态的，并且总是会在一加载时就对导入的模块求值。动态导入允许绕过 import 声明的语法刚性（syntactic rigidity），并有条件地或按需加载模块。以下是你可能需要使用动态导入的一些原因：
+
+- 当静态导入显著减慢你的代码加载，或增加你的程序内存使用时，那么你很可能不需要正要导入的代码，或者以后才会需要它。
+- 当你正要导入的模块在加载时并不存在时。
+- 当导入标识符字符串需要动态构建时。（静态导入仅支持静态标识符。）
+- 当你正要导入的模块有副作用，并且你仅在某些条件下才希望有这些副作用。（建议模块中不要有任何副作用，但有时模块的依赖项中是否有副作用也无法控制）
+- 当你处于非模块化的环境（例如，`eval` 或脚本文件）时。
+
+仅在必要时使用动态导入。静态导入更适合加载初始依赖项，并且可以更容易地从静态分析工具和[摇树优化](/zh-CN/docs/Glossary/Tree_shaking)中获益。
+
+如果你的文件不是作为模块运行的（如果它在 HTML 文件中被引用，脚本标签必须有 `type="module"` 属性），你将无法使用静态导入声明。而另一方面，异步的动态导入语法却始终可用，它允许你将模块导入到非模块环境中。
+
+`options` 参数允许不同类型的导入选项。例如 [import 属性](/zh-CN/docs/Web/JavaScript/Reference/Statements/import/with)：
+
+```js
+import("./data.json", { with: { type: "json" } });
+```
+
+动态模块导入并不在所有执行上下文中都可使用。例如，`import()` 可以在主线程、共享/专用 worker 中使用，但如果在 [service worker](/zh-CN/docs/Web/API/Service_Worker_API) 或 [worklet](/zh-CN/docs/Web/API/Worklet) 中调用，则会抛出错误。
+
+### 模块命名空间对象
+
+*模块命名空间对象*是一个描述模块所有导出的对象。它是一个静态对象，在模块被求值时创建。有两种方式可以访问模块的模块命名空间对象：通过[命名空间导入](/zh-CN/docs/Web/JavaScript/Reference/Statements/import#命名空间导入)（`import * as name from moduleName`）或通过动态导入的兑现值。
+
+模块命名空间对象是一个[密封](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Object/isSealed)的、具有 [`null` 原型](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Object#null_原型对象)的对象。也就是说，对象的所有字符串键对应于模块的导出，并且永远不会有额外的键。所有键都是以字典序[可枚举的](/zh-CN/docs/Web/JavaScript/Enumerability_and_ownership_of_properties)（即 [`Array.prototype.sort()`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Array/sort#描述) 的默认行为），默认导出以名为 `default` 的键可用。此外，模块命名空间对象具有一个值为 `"Module"` 的 [`[Symbol.toStringTag]`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Symbol/toStringTag) 属性，在 {{jsxref("Object.prototype.toString()")}} 中被使用。
+
+在使用 {{jsxref("Object.getOwnPropertyDescriptors()")}} 获取它们的描述符时会发现，字符串属性是不可配置的和可写入的。然而它们实际上是只读的，因为你不能给属性重新赋一个新的值。这些值可以由导出它们的模块重新赋值，但不能由导入它们的模块重新赋值——这种行为反映了静态导入所创建的“[实时绑定](/zh-CN/docs/Web/JavaScript/Reference/Statements/import#导入的值只能由导出者修改)”。属性的可写入性反映了值是可能发生变化的，因为不可配置和不可写入的属性必须是常量。例如，你可以重新给一个导出的变量赋值，并且可以在模块命名空间对象中观察到新的值。
+
+每个模块标识符对应一个唯一的模块命名空间对象，所以下面的代码通常是正确的：
+
+```js
+import * as mod from "/my-module.js";
+
+import("/my-module.js").then((mod2) => {
+ console.log(mod === mod2); // true
+});
+```
+
+除了一个奇怪的情况：由于 promise 对象永远不会兑现为 [thenable](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise#thenable)，如果 `my-module.js` 模块恰好导出了一个名为 `then()` 的函数，那么该函数将在动态导入的 promise 兑现时自动被调用，因为这是 [promise 解决](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise/Promise#resolve_函数)处理流程的一部分。
+
+```js
+// my-module.js
+export function then(resolve) {
+ console.log("then() 已被调用");
+ resolve(1);
+}
+```
+
+```js
+// main.js
+import * as mod from "/my-module.js";
+
+import("/my-module.js").then((mod2) => {
+ // 打印“then() 已被调用”
+ console.log(mod === mod2); // false
+});
+```
+
+> [!WARNING]
+> 不要从模块中导出名为 `then()` 的函数。这将导致模块在动态导入和静态导入时的行为不同。
+
+## 示例
+
+### 仅导入模块以获取其副作用
+
+```js
+(async () => {
+ if (somethingIsTrue) {
+ // 导入模块以获取其副作用
+ await import("/modules/my-module.js");
+ }
+})();
+```
+
+如果你的项目使用导出 ESM 的包，你也可以仅导入它们以获取其副作用。这将仅运行包的入口点文件（以及它导入的任何文件）中的代码。
+
+### 导入默认值
+
+如果你正在解构导入的模块命名空间对象，那么你必须重命名 `default` 键，因为 `default` 是保留字。
+
+```js
+(async () => {
+ if (somethingIsTrue) {
+ const {
+ default: myDefault,
+ foo,
+ bar,
+ } = await import("/modules/my-module.js");
+ }
+})();
+```
+
+### 根据用户操作按需导入
+
+这个示例展示了如何根据用户操作（在本例中为按钮点击）将功能加载到页面上，然后在该模块中调用一个函数。这不是实现此功能的唯一方式。`import()` 函数也支持 `await`。
+
+```js
+const main = document.querySelector("main");
+for (const link of document.querySelectorAll("nav > a")) {
+ link.addEventListener("click", (e) => {
+ e.preventDefault();
+
+ import("/modules/my-module.js")
+ .then((module) => {
+ module.loadPageInto(main);
+ })
+ .catch((err) => {
+ main.textContent = err.message;
+ });
+ });
+}
+```
+
+### 根据环境导入不同的模块
+
+在服务器端渲染等过程中，你可能需要在服务器或浏览器中加载不同的逻辑，因为它们与不同的全局对象或模块交互（例如，浏览器代码可以访问 `document` 和 `navigator` 等 Web API，而服务器代码可以访问服务器文件系统）。你可以通过条件动态导入来实现这一点。
+
+```js
+let myModule;
+
+if (typeof window === "undefined") {
+ myModule = await import("module-used-on-server");
+} else {
+ myModule = await import("module-used-in-browser");
+}
+```
+
+### 使用非字面量标识符导入模块
+
+动态导入允许任何表达式作为模块标识符，而不仅仅是字符串字面量。
+
+这里，我们同时加载 10 个模块（如 `/modules/module-0.js`、`/modules/module-1.js` 等），并调用每个模块导出的 `load` 函数。
+
+```js
+Promise.all(
+ Array.from({ length: 10 }).map(
+ (_, index) => import(`/modules/module-${index}.js`),
+ ),
+).then((modules) => modules.forEach((module) => module.load()));
+```
+
+## 规范
+
+{{Specifications}}
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 参见
+
+- [`import`](/zh-CN/docs/Web/JavaScript/Reference/Statements/import)
diff --git a/files/zh-tw/web/css/--_star_/index.md b/files/zh-tw/web/css/--_star_/index.md
new file mode 100644
index 00000000000000..8e6b391448ff2b
--- /dev/null
+++ b/files/zh-tw/web/css/--_star_/index.md
@@ -0,0 +1,87 @@
+---
+title: 自訂屬性（--*）：CSS 變數
+slug: Web/CSS/--*
+l10n:
+ sourceCommit: 50c8e290f11b061bbf2267e1a3279f28180a5fcb
+---
+
+{{CSSRef}}
+
+以 `--` 為前綴的屬性名稱，例如 `--example-name`，代表包含值的*自訂屬性*，可以使用 {{cssxref("var", "var()")}} 函數在其他宣告中使用。
+
+自訂屬性作用於其宣告的元素，並參與層疊：這類自訂屬性的值是由層疊演算法決定的宣告值。
+
+{{CSSInfo}}
+
+## 語法
+
+```css
+--some-keyword: left;
+--some-color: #0000ff;
+--some-complex-value: 3px 6px rgb(20 32 54);
+```
+
+- ``
+ - : 此值匹配一個或多個標記的序列，只要該序列不包含任何不允許的標記。它代表有效宣告可以具有的值的全部內容。
+
+> [!NOTE]
+> 自訂屬性名稱區分大小寫——`--my-color` 與 `--My-color` 將被視為不同的自訂屬性。
+
+## 範例
+
+### HTML
+
+```html
+這段文字應該有藍色背景和黃色文字。
+這段文字應該有黃色背景和藍色文字。
+
+```
+
+### CSS
+
+```css
+:root {
+ --first-color: #16f;
+ --second-color: #ff7;
+}
+
+#firstParagraph {
+ background-color: var(--first-color);
+ color: var(--second-color);
+}
+
+#secondParagraph {
+ background-color: var(--second-color);
+ color: var(--first-color);
+}
+
+#container {
+ --first-color: #290;
+}
+
+#thirdParagraph {
+ background-color: var(--first-color);
+ color: var(--second-color);
+}
+```
+
+### 結果
+
+{{EmbedLiveSample('範例', 500, 130)}}
+
+## 規範
+
+{{Specifications}}
+
+## 瀏覽器相容性
+
+{{Compat}}
+
+## 參見
+
+- {{cssxref("var", "var()")}} 函數
+- {{cssxref("@property")}} @ 規則
+- [使用 CSS 自訂屬性（變數）](/zh-TW/docs/Web/CSS/Using_CSS_custom_properties)指南
+- [CSS 自訂屬性用於層疊變數](/zh-TW/docs/Web/CSS/CSS_cascading_variables)模組
diff --git a/package.json b/package.json
index d1009dfdbe7c90..ee398e4ff17bea 100644
--- a/package.json
+++ b/package.json
@@ -34,7 +34,7 @@
"husky": "9.1.7",
"lint-staged": "15.2.11",
"markdown-it": "^14.1.0",
- "markdownlint-cli2": "0.16.0",
+ "markdownlint-cli2": "0.17.0",
"markdownlint-rule-search-replace": "1.2.0",
"mdast-util-from-markdown": "^2.0.2",
"ora": "^8.1.1",
diff --git a/yarn.lock b/yarn.lock
index 79602d6053cbbb..88463a3988a5da 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -35,6 +35,11 @@
dependencies:
"@types/ms" "*"
+"@types/katex@^0.16.0":
+ version "0.16.7"
+ resolved "https://registry.yarnpkg.com/@types/katex/-/katex-0.16.7.tgz#03ab680ab4fa4fbc6cb46ecf987ecad5d8019868"
+ integrity sha512-HMwFiRujE5PjrgwHQ25+bsLJgowjGjm5Z8FVSf0N6PwgJrwxH0QxzHYDcKsTfV3wva0vzrpqMTJS2jXPr5BMEQ==
+
"@types/mdast@^4.0.0":
version "4.0.4"
resolved "https://registry.yarnpkg.com/@types/mdast/-/mdast-4.0.4.tgz#7ccf72edd2f1aa7dd3437e180c64373585804dd6"
@@ -52,6 +57,11 @@
resolved "https://registry.yarnpkg.com/@types/unist/-/unist-3.0.3.tgz#acaab0f919ce69cce629c2d4ed2eb4adc1b6c20c"
integrity sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q==
+"@types/unist@^2.0.0":
+ version "2.0.11"
+ resolved "https://registry.yarnpkg.com/@types/unist/-/unist-2.0.11.tgz#11af57b127e32487774841f7a4e54eab166d03c4"
+ integrity sha512-CmBKiL6NNo/OqgmMn95Fk9Whlp2mtvIv+KNpQKN2F4SjvrEesubTRWGYSg+BnWZOnlCaSTU1sMpsBOzgbYhnsA==
+
ansi-escapes@^7.0.0:
version "7.0.0"
resolved "https://registry.yarnpkg.com/ansi-escapes/-/ansi-escapes-7.0.0.tgz#00fc19f491bbb18e1d481b97868204f92109bfe7"
@@ -154,11 +164,21 @@ chalk@^5.3.0, chalk@~5.3.0:
resolved "https://registry.yarnpkg.com/chalk/-/chalk-5.3.0.tgz#67c20a7ebef70e7f3970a01f90fa210cb6860385"
integrity sha512-dLitG79d+GV1Nb/VYcCDFivJeK1hiukt9QjRNVOsUtTy1rR1YJsmpGGTZ3qJos+uw7WmWF4wUwBd9jxjocFC2w==
+character-entities-legacy@^3.0.0:
+ version "3.0.0"
+ resolved "https://registry.yarnpkg.com/character-entities-legacy/-/character-entities-legacy-3.0.0.tgz#76bc83a90738901d7bc223a9e93759fdd560125b"
+ integrity sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ==
+
character-entities@^2.0.0:
version "2.0.2"
resolved "https://registry.yarnpkg.com/character-entities/-/character-entities-2.0.2.tgz#2d09c2e72cd9523076ccb21157dff66ad43fcc22"
integrity sha512-shx7oQ0Awen/BRIdkjkvz54PnEEI/EjwXDSIZp86/KKdbafHh1Df/RYGBhn4hbe2+uKC9FnT5UCEdyPz3ai9hQ==
+character-reference-invalid@^2.0.0:
+ version "2.0.1"
+ resolved "https://registry.yarnpkg.com/character-reference-invalid/-/character-reference-invalid-2.0.1.tgz#85c66b041e43b47210faf401278abf808ac45cb9"
+ integrity sha512-iBZ4F4wRbyORVsu0jPV7gXkOsGYjGHPmAyv+HiHG8gi5PtC9KI2j1+v8/tlibRvjoWX027ypmG/n0HtO5t7unw==
+
cld@^2.10.0:
version "2.10.0"
resolved "https://registry.yarnpkg.com/cld/-/cld-2.10.0.tgz#b65aa393e96a19e5db2be0994c54f54b992eb455"
@@ -214,6 +234,11 @@ colorette@^2.0.20:
resolved "https://registry.yarnpkg.com/colorette/-/colorette-2.0.20.tgz#9eb793e6833067f7235902fcd3b09917a000a95a"
integrity sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w==
+commander@^8.3.0:
+ version "8.3.0"
+ resolved "https://registry.yarnpkg.com/commander/-/commander-8.3.0.tgz#4837ea1b2da67b9c616a67afbb0fafee567bca66"
+ integrity sha512-OkTL9umf+He2DZkUq8f8J9of7yL6RJKI24dVITBmNfZBmri9zYZQrKkuXiKhyfPSu8tUhnVBB1iKXevvnlR4Ww==
+
commander@~12.1.0:
version "12.1.0"
resolved "https://registry.yarnpkg.com/commander/-/commander-12.1.0.tgz#01423b36f501259fdaac4d0e4d60c96c991585d3"
@@ -425,6 +450,24 @@ inherits@2:
resolved "https://registry.yarnpkg.com/inherits/-/inherits-2.0.4.tgz#0fa2c64f932917c3433a0ded55363aae37416b7c"
integrity sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==
+is-alphabetical@^2.0.0:
+ version "2.0.1"
+ resolved "https://registry.yarnpkg.com/is-alphabetical/-/is-alphabetical-2.0.1.tgz#01072053ea7c1036df3c7d19a6daaec7f19e789b"
+ integrity sha512-FWyyY60MeTNyeSRpkM2Iry0G9hpr7/9kD40mD/cGQEuilcZYS4okz8SN2Q6rLCJ8gbCt6fN+rC+6tMGS99LaxQ==
+
+is-alphanumerical@^2.0.0:
+ version "2.0.1"
+ resolved "https://registry.yarnpkg.com/is-alphanumerical/-/is-alphanumerical-2.0.1.tgz#7c03fbe96e3e931113e57f964b0a368cc2dfd875"
+ integrity sha512-hmbYhX/9MUMF5uh7tOXyK/n0ZvWpad5caBA17GsC6vyuCqaWliRG5K1qS9inmUhEMaOBIW7/whAnSwveW/LtZw==
+ dependencies:
+ is-alphabetical "^2.0.0"
+ is-decimal "^2.0.0"
+
+is-decimal@^2.0.0:
+ version "2.0.1"
+ resolved "https://registry.yarnpkg.com/is-decimal/-/is-decimal-2.0.1.tgz#9469d2dc190d0214fd87d78b78caecc0cc14eef7"
+ integrity sha512-AAB9hiomQs5DXWcRB1rqsxGUstbRroFOPPVAomNk/3XHR5JyEZChOyTWe2oayKnsSsr/kcGqF+z6yuH6HHpN0A==
+
is-extglob@^2.1.1:
version "2.1.1"
resolved "https://registry.yarnpkg.com/is-extglob/-/is-extglob-2.1.1.tgz#a88c02535791f02ed37c76a1b9ea9773c833f8c2"
@@ -454,6 +497,11 @@ is-glob@^4.0.1:
dependencies:
is-extglob "^2.1.1"
+is-hexadecimal@^2.0.0:
+ version "2.0.1"
+ resolved "https://registry.yarnpkg.com/is-hexadecimal/-/is-hexadecimal-2.0.1.tgz#86b5bf668fca307498d319dfc03289d781a90027"
+ integrity sha512-DgZQp241c8oO6cA1SbTEWiXeoxV42vlcJxgH+B3hi1AiqqKruZR3ZGF8In3fj4+/y/7rHvlOZLZtgJ/4ttYGZg==
+
is-interactive@^2.0.0:
version "2.0.0"
resolved "https://registry.yarnpkg.com/is-interactive/-/is-interactive-2.0.0.tgz#40c57614593826da1100ade6059778d597f16e90"
@@ -504,6 +552,13 @@ jsonc-parser@3.3.1:
resolved "https://registry.yarnpkg.com/jsonc-parser/-/jsonc-parser-3.3.1.tgz#f2a524b4f7fd11e3d791e559977ad60b98b798b4"
integrity sha512-HUgH65KyejrUFPvHFPbqOY0rsFip3Bo5wb4ngvdi1EpCYWUQDC5V+Y7mZws+DLkr4M//zQJoanu1SP+87Dv1oQ==
+katex@^0.16.0:
+ version "0.16.18"
+ resolved "https://registry.yarnpkg.com/katex/-/katex-0.16.18.tgz#20781284288bc52805c519e48ac756163ad4b1f3"
+ integrity sha512-LRuk0rPdXrecAFwQucYjMiIs0JFefk6N1q/04mlw14aVIVgxq1FO0MA9RiIIGVaKOB5GIP5GH4aBBNraZERmaQ==
+ dependencies:
+ commander "^8.3.0"
+
lilconfig@~3.1.3:
version "3.1.3"
resolved "https://registry.yarnpkg.com/lilconfig/-/lilconfig-3.1.3.tgz#a1bcfd6257f9585bf5ae14ceeebb7b559025e4c4"
@@ -580,23 +635,18 @@ markdownlint-cli2-formatter-default@0.0.5:
resolved "https://registry.yarnpkg.com/markdownlint-cli2-formatter-default/-/markdownlint-cli2-formatter-default-0.0.5.tgz#b8fde4e127f9a9c0596e6d45eed352dd0aa0ff98"
integrity sha512-4XKTwQ5m1+Txo2kuQ3Jgpo/KmnG+X90dWt4acufg6HVGadTUG5hzHF/wssp9b5MBYOMCnZ9RMPaU//uHsszF8Q==
-markdownlint-cli2@0.16.0:
- version "0.16.0"
- resolved "https://registry.yarnpkg.com/markdownlint-cli2/-/markdownlint-cli2-0.16.0.tgz#95c599e28aff8e4286fbf08003e7fc1282ec0cac"
- integrity sha512-oy5dJdOxGMKSwrlouxdEGf6N4O2Iz8oJ4/HO2Ix67o4vTK1AQNGjZUNwTIzfa5x+XbJ++dfgR1gLfILajsW+1Q==
+markdownlint-cli2@0.17.0:
+ version "0.17.0"
+ resolved "https://registry.yarnpkg.com/markdownlint-cli2/-/markdownlint-cli2-0.17.0.tgz#1a93fa0c1708981a8f12b175e53d899fe7b448d1"
+ integrity sha512-8Xz7wkkkV4wJTf+pvryU3J/fT3BZWD3ZykcjYBR0GuH0GHvrCbswaCdurbuUuAPDGFZy4cxBGYCJSAOW8jM4aQ==
dependencies:
globby "14.0.2"
js-yaml "4.1.0"
jsonc-parser "3.3.1"
- markdownlint "0.36.1"
+ markdownlint "0.37.2"
markdownlint-cli2-formatter-default "0.0.5"
micromatch "4.0.8"
-markdownlint-micromark@0.1.12:
- version "0.1.12"
- resolved "https://registry.yarnpkg.com/markdownlint-micromark/-/markdownlint-micromark-0.1.12.tgz#8fc055f4588039654e5af75f1b9fc492da64c76a"
- integrity sha512-RlB6EwMGgc0sxcIhOQ2+aq7Zw1V2fBnzbXKGgYK/mVWdT7cz34fteKSwfYeo4rL6+L/q2tyC9QtD/PgZbkdyJQ==
-
markdownlint-micromark@0.1.2:
version "0.1.2"
resolved "https://registry.yarnpkg.com/markdownlint-micromark/-/markdownlint-micromark-0.1.2.tgz#5520e04febffa46741875a2f297509ffdb561f5c"
@@ -616,13 +666,19 @@ markdownlint-rule-search-replace@1.2.0:
dependencies:
markdownlint-rule-helpers "0.21.0"
-markdownlint@0.36.1:
- version "0.36.1"
- resolved "https://registry.yarnpkg.com/markdownlint/-/markdownlint-0.36.1.tgz#86491d35ad6eda89e1290404850a574da3e64490"
- integrity sha512-s73fU2CQN7WCgjhaQUQ8wYESQNzGRNOKDd+3xgVqu8kuTEhmwepd/mxOv1LR2oV046ONrTLBFsM7IoKWNvmy5g==
+markdownlint@0.37.2:
+ version "0.37.2"
+ resolved "https://registry.yarnpkg.com/markdownlint/-/markdownlint-0.37.2.tgz#72461a7abfef2e01ae7f3b596cdc083a25856571"
+ integrity sha512-m8QhYnRA1ptbhIjhVVBUkKQcUelVxuyO/yXyLewnc1+xs4eXhST/+hIy29goO+EYVLmWtknH4SmYQ4s0caoKqw==
dependencies:
markdown-it "14.1.0"
- markdownlint-micromark "0.1.12"
+ micromark "4.0.1"
+ micromark-extension-directive "3.0.2"
+ micromark-extension-gfm-autolink-literal "2.1.0"
+ micromark-extension-gfm-footnote "2.1.0"
+ micromark-extension-gfm-table "2.1.0"
+ micromark-extension-math "3.1.0"
+ micromark-util-types "2.0.1"
mdast-util-from-markdown@^2.0.2:
version "2.0.2"
@@ -686,6 +742,67 @@ micromark-core-commonmark@^2.0.0:
micromark-util-symbol "^2.0.0"
micromark-util-types "^2.0.0"
+micromark-extension-directive@3.0.2:
+ version "3.0.2"
+ resolved "https://registry.yarnpkg.com/micromark-extension-directive/-/micromark-extension-directive-3.0.2.tgz#2eb61985d1995a7c1ff7621676a4f32af29409e8"
+ integrity sha512-wjcXHgk+PPdmvR58Le9d7zQYWy+vKEU9Se44p2CrCDPiLr2FMyiT4Fyb5UFKFC66wGB3kPlgD7q3TnoqPS7SZA==
+ dependencies:
+ devlop "^1.0.0"
+ micromark-factory-space "^2.0.0"
+ micromark-factory-whitespace "^2.0.0"
+ micromark-util-character "^2.0.0"
+ micromark-util-symbol "^2.0.0"
+ micromark-util-types "^2.0.0"
+ parse-entities "^4.0.0"
+
+micromark-extension-gfm-autolink-literal@2.1.0:
+ version "2.1.0"
+ resolved "https://registry.yarnpkg.com/micromark-extension-gfm-autolink-literal/-/micromark-extension-gfm-autolink-literal-2.1.0.tgz#6286aee9686c4462c1e3552a9d505feddceeb935"
+ integrity sha512-oOg7knzhicgQ3t4QCjCWgTmfNhvQbDDnJeVu9v81r7NltNCVmhPy1fJRX27pISafdjL+SVc4d3l48Gb6pbRypw==
+ dependencies:
+ micromark-util-character "^2.0.0"
+ micromark-util-sanitize-uri "^2.0.0"
+ micromark-util-symbol "^2.0.0"
+ micromark-util-types "^2.0.0"
+
+micromark-extension-gfm-footnote@2.1.0:
+ version "2.1.0"
+ resolved "https://registry.yarnpkg.com/micromark-extension-gfm-footnote/-/micromark-extension-gfm-footnote-2.1.0.tgz#4dab56d4e398b9853f6fe4efac4fc9361f3e0750"
+ integrity sha512-/yPhxI1ntnDNsiHtzLKYnE3vf9JZ6cAisqVDauhp4CEHxlb4uoOTxOCJ+9s51bIB8U1N1FJ1RXOKTIlD5B/gqw==
+ dependencies:
+ devlop "^1.0.0"
+ micromark-core-commonmark "^2.0.0"
+ micromark-factory-space "^2.0.0"
+ micromark-util-character "^2.0.0"
+ micromark-util-normalize-identifier "^2.0.0"
+ micromark-util-sanitize-uri "^2.0.0"
+ micromark-util-symbol "^2.0.0"
+ micromark-util-types "^2.0.0"
+
+micromark-extension-gfm-table@2.1.0:
+ version "2.1.0"
+ resolved "https://registry.yarnpkg.com/micromark-extension-gfm-table/-/micromark-extension-gfm-table-2.1.0.tgz#5cadedfbb29fca7abf752447967003dc3b6583c9"
+ integrity sha512-Ub2ncQv+fwD70/l4ou27b4YzfNaCJOvyX4HxXU15m7mpYY+rjuWzsLIPZHJL253Z643RpbcP1oeIJlQ/SKW67g==
+ dependencies:
+ devlop "^1.0.0"
+ micromark-factory-space "^2.0.0"
+ micromark-util-character "^2.0.0"
+ micromark-util-symbol "^2.0.0"
+ micromark-util-types "^2.0.0"
+
+micromark-extension-math@3.1.0:
+ version "3.1.0"
+ resolved "https://registry.yarnpkg.com/micromark-extension-math/-/micromark-extension-math-3.1.0.tgz#c42ee3b1dd5a9a03584e83dd8f08e3de510212c1"
+ integrity sha512-lvEqd+fHjATVs+2v/8kg9i5Q0AP2k85H0WUOwpIVvUML8BapsMvh1XAogmQjOCsLpoKRCVQqEkQBB3NhVBcsOg==
+ dependencies:
+ "@types/katex" "^0.16.0"
+ devlop "^1.0.0"
+ katex "^0.16.0"
+ micromark-factory-space "^2.0.0"
+ micromark-util-character "^2.0.0"
+ micromark-util-symbol "^2.0.0"
+ micromark-util-types "^2.0.0"
+
micromark-factory-destination@^2.0.0:
version "2.0.1"
resolved "https://registry.yarnpkg.com/micromark-factory-destination/-/micromark-factory-destination-2.0.1.tgz#8fef8e0f7081f0474fbdd92deb50c990a0264639"
@@ -830,12 +947,12 @@ micromark-util-symbol@^2.0.0:
resolved "https://registry.yarnpkg.com/micromark-util-symbol/-/micromark-util-symbol-2.0.1.tgz#e5da494e8eb2b071a0d08fb34f6cefec6c0a19b8"
integrity sha512-vs5t8Apaud9N28kgCrRUdEed4UJ+wWNvicHLPxCa9ENlYuAY31M0ETy5y1vA33YoNPDFTghEbnh6efaE8h4x0Q==
-micromark-util-types@^2.0.0:
+micromark-util-types@2.0.1, micromark-util-types@^2.0.0:
version "2.0.1"
resolved "https://registry.yarnpkg.com/micromark-util-types/-/micromark-util-types-2.0.1.tgz#a3edfda3022c6c6b55bfb049ef5b75d70af50709"
integrity sha512-534m2WhVTddrcKVepwmVEVnUAmtrx9bfIjNoQHRqfnvdaHQiFytEhJoTgpWJvDEXCO5gLTQh3wYC1PgOJA4NSQ==
-micromark@^4.0.0:
+micromark@4.0.1, micromark@^4.0.0:
version "4.0.1"
resolved "https://registry.yarnpkg.com/micromark/-/micromark-4.0.1.tgz#294c2f12364759e5f9e925a767ae3dfde72223ff"
integrity sha512-eBPdkcoCNvYcxQOAKAlceo5SNdzZWfF+FcSupREAzdAh9rRmE239CEQAiTwIgblwnoM8zzj35sZ5ZwvSEOF6Kw==
@@ -936,6 +1053,19 @@ ora@^8.1.1:
string-width "^7.2.0"
strip-ansi "^7.1.0"
+parse-entities@^4.0.0:
+ version "4.0.2"
+ resolved "https://registry.yarnpkg.com/parse-entities/-/parse-entities-4.0.2.tgz#61d46f5ed28e4ee62e9ddc43d6b010188443f159"
+ integrity sha512-GG2AQYWoLgL877gQIKeRPGO1xF9+eG1ujIb5soS5gPvLQ1y2o8FL90w2QWNdf9I361Mpp7726c+lj3U0qK1uGw==
+ dependencies:
+ "@types/unist" "^2.0.0"
+ character-entities-legacy "^3.0.0"
+ character-reference-invalid "^2.0.0"
+ decode-named-character-reference "^1.0.0"
+ is-alphanumerical "^2.0.0"
+ is-decimal "^2.0.0"
+ is-hexadecimal "^2.0.0"
+
path-is-absolute@^1.0.0:
version "1.0.1"
resolved "https://registry.yarnpkg.com/path-is-absolute/-/path-is-absolute-1.0.1.tgz#174b9268735534ffbc7ace6bf53a5a9e1b5c5f5f"