mdn · yin1999 · Aug 29, 2024 · Aug 26, 2024 · Aug 26, 2024 · Aug 26, 2024
@@ -58,26 +58,27 @@
 
 ## 标题/表格
 
-| 英文词汇               | 翻译         | 备注               | 引用来源                                                                    |
-| ---------------------- | ------------ | ------------------ | --------------------------------------------------------------------------- |
-| Accessibility concerns | 无障碍考虑   |                    | https://github.com/mdn/translated-content/issues/11456                      |
-| Active learning        | 动手练习     |                    | https://github.com/mdn/translated-content/pull/12696#discussion_r1164859935 |
-| Associated interfaces  | 相关接口     |                    |                                                                             |
-| Associated roles       | 相关角色     |                    |                                                                             |
-| Browser compatibility  | 浏览器兼容性 |                    |                                                                             |
-| Conclusion             | 总结         |                    | https://github.com/mdn/translated-content/pull/13329#discussion_r1199677894 |
-| Examples               | 示例         |                    |                                                                             |
-| Exceptions             | 异常         |                    |                                                                             |
-| Formal Definition      | 形式定义     |                    | https://zh.wikipedia.org/zh-cn/形式文法                                     |
-| Formal syntax          | 形式语法     |                    | https://zh.wikipedia.org/zh-cn/形式文法                                     |
-| Objective              | 目标         | 在学习区表格中使用 |                                                                             |
-| Parameters             | 参数         |                    |                                                                             |
-| Prerequisites          | 前提         | 在学习区表格中使用 |                                                                             |
-| See also               | 参见         |                    |                                                                             |
-| Specifications         | 规范         |                    |                                                                             |
-| Technical summary      | 技术概要     |                    | https://github.com/mdn/translated-content/issues/11456                      |
-| Test your skills       | 技能测试     |                    |                                                                             |
-| Usage notes            | 使用说明     |                    | https://github.com/mdn/translated-content/pull/12600#discussion_r1161045585 |
+| 英文词汇               | 翻译         | 备注               | 引用来源                                                                     |
+| ---------------------- | ------------ | ------------------ | ---------------------------------------------------------------------------- |
+| Accessibility concerns | 无障碍考虑   |                    | https://github.com/mdn/translated-content/issues/11456                       |
+| Active learning        | 动手练习     |                    | https://github.com/mdn/translated-content/pull/12696#discussion_r1164859935  |
+| Associated interfaces  | 相关接口     |                    |                                                                              |
+| Associated roles       | 相关角色     |                    |                                                                              |
+| Browser compatibility  | 浏览器兼容性 |                    |                                                                              |
+| Conclusion             | 总结         |                    | https://github.com/mdn/translated-content/pull/13329#discussion_r1199677894  |
+| Examples               | 示例         |                    |                                                                              |
+| Exceptions             | 异常         |                    |                                                                              |
+| Formal Definition      | 形式定义     |                    | https://zh.wikipedia.org/zh-cn/形式文法                                      |
+| Formal syntax          | 形式语法     |                    | https://zh.wikipedia.org/zh-cn/形式文法                                      |
+| Objective              | 目标         | 在学习区表格中使用 |                                                                              |
+| Parameters             | 参数         |                    |                                                                              |
+| Prerequisites          | 前提         | 在学习区表格中使用 |                                                                              |
+| See also               | 参见         |                    |                                                                              |
+| Specifications         | 规范         |                    |                                                                              |
+| Technical summary      | 技术概要     |                    | https://github.com/mdn/translated-content/issues/11456                       |
+| Test your skills       | 技能测试     |                    |                                                                              |
+| Usage context          | 使用上下文   |                    | https://github.com/mdn/translated-content/pull/23257#issuecomment-2309852450 |
+| Usage notes            | 使用说明     |                    | https://github.com/mdn/translated-content/pull/12600#discussion_r1161045585  |
 
 ## 通用术语
 

@@ -58,7 +58,7 @@ _这个类型没有属性。它是一个双精度浮点数。_
 
 _这个类型没有方法。_
 
-## 用法说明
+## 使用说明
 
 你可以通过调用 {{domxref("performance")}} 的 {{domxref("performance.now", "now()")}} 方法来获取当前的时间戳的值（自创建上下文以来经过的时间）。此方法在 {{domxref("Window")}} 和 {{domxref("Worker")}} 上下文中均可用。
 

@@ -63,7 +63,7 @@ addEventListener(type, listener, useCapture);
 
 无（{{jsxref("undefined")}}）。
 
-## 用法说明
+## 使用说明
 
 ### 事件监听回调
 

@@ -23,7 +23,7 @@ None.
 
 `undefined`.
 
-## 用法
+## 使用说明
 
 调用 `load()` 会使媒体上所有正在进行的操作中止，然后根据 `audio` 或者 `video` 元素的 `src` 或者 `source` 属性里寻找合适的播放源并重新加载媒体内容。更多查看 [Supporting multiple formats](/zh-CN/docs/Learn/HTML/Multimedia_and_embedding/Video_and_audio_content#Supporting_multiple_formats) 和 [Video and audio content](/zh-CN/docs/Learn/HTML/Multimedia_and_embedding/Video_and_audio_content) 。
 

@@ -166,7 +166,7 @@ _此接口也从父类 {{domxref("UIEvent")}} 和 {{domxref("Event")}} 中继承
 - {{domxref("Element.keypress_event", "keypress")}} {{Deprecated_Inline}}
   - : 通常在一个按键被按下时触发，并产生一个字符串值，这个事件高度依赖硬件且已过时，不应该使用它。
 
-## 用法说明
+## 使用说明
 
 键盘事件有三种类型：{{domxref("Element/keydown_event", "keydown")}}、{{domxref("Element/keypress_event", "keypress")}} 和 {{domxref("Element/keyup_event", "keyup")}}。对于大多数按键，Gecko 会像这样派发一系列按键事件：
 

@@ -7,7 +7,7 @@ slug: Web/API/Performance/clearMarks
 
 **`clearMarks()`** 这个方法可以从浏览器的 performance entry 缓存中移除声明的标记。如果调用这个方法时没有传递参数，则所有带有{{domxref("PerformanceEntry.entryType","entry type")}}这类标记的{{domxref("PerformanceEntry","performance entries")}} 将从 performance entry 缓存区中被移除。
 
-## 用法
+## 语法
 
 ```
 performance.clearMarks();

@@ -9,7 +9,7 @@ slug: Web/API/Performance/clearMeasures
 
 {{AvailableInWorkers}}
 
-## 用法
+## 语法
 
 ```
 performance.clearMeasures();

@@ -36,7 +36,7 @@ slug: Web/API/PerformanceLongTaskTiming
 
 即执行任务的容器清单。针对没有在顶层页面容器内执行的任务，`containerId`、`containerName`和`containerSrc`字段可以用来提供任务源信息。
 
-## 用法
+## 示例
 
 ```js
 var observer = new PerformanceObserver(function (list) {

@@ -9,7 +9,7 @@ slug: Web/API/Selection/anchorNode
 
 **`Selection.anchorNode`** 只读属性返回选区开始位置所属的节点（{{domxref("Node")}}）。
 
-## 用法
+## 语法
 
 ```plain
 sel.anchorNode

@@ -1,20 +1,28 @@
 ---
-title: Selection.isCollapsed
+title: "Selection: isCollapsed property"
+short-title: isCollapsed
 slug: Web/API/Selection/isCollapsed
 ---
 
-{{ ApiRef() }}
+{{ ApiRef("DOM") }}
 
-### 概述
+**`Selection.isCollapsed`** 只读属性返回一个布尔值，表示当前是否有任何文本被选中。当选定内容的起点和终点位于内容中的同一位置时，没有选定文本。
 
-返回一个布尔值用于描述选区的起始点和终止点是否位于一个位置（即是否框选了，译者注）。
+请注意，折叠的选择可能仍有一个（在 Gecko 中为多个）{{domxref("Range")}}，因此 {{domxref("Selection.rangeCount")}} 可能不为零。在这种情况下，调用 {{domxref("Selection")}} 对象的 {{domxref("Selection.getRangeAt", "getRangeAt()")}} 方法可能会返回折叠的 `Range` 对象。
 
-### 用法
+## 值
 
-```plain
-sel.isCollapsed
-```
+一个布尔值。
 
-### 注意
+## 规范
 
-即使是一个被折叠了的选区，其 rangeCount 的结果也可能大于 0。sel.getRangeAt(0) 会在选区被折叠的情况下返回一个值。
+{{Specifications}}
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 参见
+
+- {{domxref("Selection")}}
+- {{domxref("Range")}}
@@ -9,7 +9,7 @@ slug: Web/API/Selection/removeRange
 
 将一个区域从选区中移除。
 
-### 用法
+### 语法
 
 ```plain
 sel.removeRange(range)

@@ -7,7 +7,7 @@ slug: Web/API/Selection/selectAllChildren
 
 Selection.selectAllChildren() 把指定元素的所有子元素设为选中区域，并取消之前的选中区域。
 
-## 用法
+## 语法
 
 ```
 sel.selectAllChildren(parentNode)

@@ -125,8 +125,6 @@ function multiplyMatrices(matrixA, matrixB) {
 }
 ```
 
-### 用法
-
 让我们看一看实际使用：
 
 ```js

diff --git a/files/zh-cn/web/api/xmlhttprequest_api/html_in_xmlhttprequest/index.md b/files/zh-cn/web/api/xmlhttprequest_api/html_in_xmlhttprequest/index.md
@@ -13,7 +13,7 @@ W3C {{domxref("XMLHttpRequest")}} 规范为 {{domxref("XMLHttpRequest")}} 添加
 
 为了阻止同步使用 `XMLHttpRequest`，HTML 支持在同步模式下是不可用的。另外，只有当 {{domxref("XMLHttpRequest.responseType", "responseType")}} 属性被设置为 `"document"` 时，才会有 HTML 支持。这一限制避免了当遗留代码在默认模式下使用 `XMLHttpRequest` 来检索 {{domxref("XMLHttpRequest.responseText", "responseText")}}，对 `text/html` 资源进行无用的解析而浪费时间。同时，这个限制也避免了遗留代码的问题，这些代码假定 {{domxref("XMLHttpRequest.responseXML", "responseXML")}} 对于 HTTP 错误页面（通常有一个 `text/html` 响应体）是 `null`。
 
-## 用法
+## 使用说明
 
 使用 {{domxref("XMLHttpRequest")}} 检索作为 DOM 的 HTML 资源，就像使用 `XMLHttpRequest` 检索作为 DOM 的 XML 资源一样，只是你不能使用同步模式，你必须在调用 {{domxref("XMLHttpRequest.open", "open()")}} 之后，{{domxref("XMLHttpRequest.send", "send()")}} 之前，将字符串 `"document"` 分配给 {{domxref("XMLHttpRequest", "responseType")}} 对象的属性，来明确请求一个文档。
 

@@ -15,7 +15,7 @@ slug: Web/CSS/:picture-in-picture
 }
 ```
 
-## 用法说明
+## 使用说明
 
 `:picture-in-picture` 伪类允许你配置样式表，以便视频在画中画或者传统播放模式来回切换时自动调整内容的大小、样式或布局。
 

@@ -15,7 +15,7 @@ CSS 表达式 `attr()` 用来获取选择到的元素的某一 HTML 属性值，
 
 `attr()` 表达式可以用于任何 CSS 属性。 {{ experimental_inline() }}
 
-## 用法
+## 语法
 
 ```
 语法：attr( attribute-name <type-or-unit>? [, <fallback> ]? )

@@ -61,7 +61,7 @@ slug: Web/HTML/Element/picture
 
 这个元素只包含[全局属性](/zh-CN/docs/Web/HTML/Global_attributes)。
 
-## 用法提示
+## 使用说明
 
 你可以使用 {{cssxref("object-position")}} 属性调整元素框架内图像的位置，用 {{cssxref("object-fit")}} 属性控制图片如何调整大小来适应框架。
 

@@ -40,7 +40,7 @@ slug: Web/HTML/Element/rb
 
 这个元素仅仅支持 [全局属性](/zh-CN/docs/HTML/Global_attributes)。
 
-## 用法注解
+## 使用说明
 
 - Ruby 注解用于展示东亚文字的发音，例如使用日语罗马音和汉语拼音的文字。 `<rb>` 元素用于分隔出 ruby 基本文本的每个片段。
 - 虽然 `<rb>` 不是一个空元素，但是在源码中通常只包括每个元素的开始标签。因此 ruby 标记就不那么复杂，也更容易阅读。在渲染版本中，浏览器也可以填充完整的元素。

@@ -38,7 +38,7 @@ slug: Web/HTML/Element/rp
 
 这个元素仅仅支持 [全局属性](/zh-CN/docs/HTML/Global_attributes)。
 
-## 用法注解
+## 使用说明
 
 - Ruby 注解用于展示东亚文字的发音，例如使用日语罗马音和汉语拼音的文字。 `<rp>` 元素用于不支持 {{ HTMLElement("ruby") }} 元素的情况。 `<rp>` 的内容提供了应该展示的东西，通常是圆括号，以便表示 ruby 注解的存在。
 

@@ -83,7 +83,7 @@ slug: Web/HTML/Element/track
 - `srclang`
   - : track 文本数据的语言。它必须是合法的 [BCP 47](http://people.w3.org/rishida/utils/subtags/) 语言标签。如果 `kind` 属性被设为 `subtitles`, 那么 `srclang` 必须定义。
 
-## 用法说明
+## 使用说明
 
 ### 轨道数据类型
 

diff --git a/files/zh-cn/web/html/global_attributes/data-_star_/index.md b/files/zh-cn/web/html/global_attributes/data-_star_/index.md
@@ -17,7 +17,7 @@ slug: Web/HTML/Global_attributes/data-*
 
 注意，{{domxref("HTMLElement.dataset")}} 属性是一个{{domxref("DOMStringMap")}}，并且自定义数据属性 _data-test-value_ 可以通过 `HTMLElement.dataset.testValue` ( 或者是 `HTMLElement.dataset["testValue"]`) 来访问，任何破折号 (`U+002D`) 都会被下个字母的大写替代 (驼峰拼写)。
 
-### 用法
+### 使用说明
 
 通过添加 **data-\*** 属性，即使是普通的 HTML 元素也能变成相当复杂且强大的编程对象。例如，在游戏里的太空船 "[sprite](https://en.wikipedia.org/wiki/Sprite_%28computer_graphics%29)" 可以是一个带有一个 [class](/zh-CN/docs/Web/HTML/Global_attributes/class) 属性和几个 data-\* 属性的简单 {{HTMLElement("img")}} 元素：
 

@@ -9,7 +9,7 @@ slug: Web/JavaScript/Reference/Global_Objects/TypedArray/subarray
 
 {{EmbedInteractiveExample("pages/js/typedarray-subarray.html")}}
 
-## 用法
+## 语法
 
 ```js-nolint
 subarray()

@@ -9,7 +9,7 @@ slug: Web/SVG/Attribute/accumulate
 
 在原来的结果的基础上重复动画的时候，它通常很有用，每一次循环都累加。这个属性告诉动画是否是每次循环，前一个动画属性值要加上去。
 
-## 用法
+## 使用说明
 
 | 类别     | 动画累加属性                                                                      |
 | -------- | --------------------------------------------------------------------------------- |

@@ -9,7 +9,7 @@ slug: Web/SVG/Attribute/alignment-baseline
 
 作为一个外观属性，它还可以直接作为 CSS 样式表内部的属性使用。请阅读 {{ cssxref("alignment-baseline","CSS alignment-baseline") }} 以了解更多信息。
 
-## 用法
+## 使用说明
 
 | 类别     | 外观属性                                                                                                                                                                         |
 | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

@@ -7,7 +7,7 @@ slug: Web/SVG/Attribute/attributeName
 
 该属性标识了在一个动画动作环节中，父元素的需要被改变的属性名。
 
-## 用法
+## 使用说明
 
 | 类别     | 动画属性目标属性                                                                      |
 | -------- | ------------------------------------------------------------------------------------- |

@@ -7,7 +7,7 @@ slug: Web/SVG/Attribute/attributeType
 
 该属性指定目标属性和它相对应的值处于哪个命名空间里。
 
-## 用法
+## 使用说明
 
 | 类别     | 动画属性目标属性                                                                      |
 | -------- | ------------------------------------------------------------------------------------- |

@@ -9,7 +9,7 @@ slug: Web/SVG/Attribute/baseline-shift
 
 作为一个外观属性，它还可以直接作为 CSS 样式表内部的属性使用。请看{{ cssxref("baseline-shift","CSS baseline-shift") }}以了解更多信息。
 
-## 用法
+## 使用说明
 
 | 类别     | 外观属性                                                                                                        |
 | -------- | --------------------------------------------------------------------------------------------------------------- |

@@ -9,7 +9,7 @@ slug: Web/SVG/Attribute/begin
 
 这个属性值是一个分号分隔的数列值。SMIL 规范的["Evaluation of begin and end time lists"](http://www.w3.org/TR/2001/REC-smil-animation-20010904/#Timing-EvaluationOfBeginEndTimeLists)章节详细解释了开始时间数列。每个单独的值可以是下述之一：`<offset-value>`、`<syncbase-value>`、`<event-value>`、`<repeat-value>`、`<accessKey-value>`、`<wallclock-sync-value>`或者关键词`indefinite`。
 
-## 用法
+## 使用说明
 
 | 类别     | 动画定时属性                                                                  |
 | -------- | ----------------------------------------------------------------------------- |

@@ -37,7 +37,7 @@ svg {
 
 {{EmbedLiveSample('示例', '100%', 150)}}
 
-## 用法
+## 使用说明
 
 **Warning:** This property is deprecated. Use {{cssxref("clip-path")}} instead.
 

@@ -9,7 +9,7 @@ slug: Web/SVG/Attribute/color
 
 作为一个外观属性，它还可以直接用作 CSS 样式表的属性。请阅读 {{ cssxref("color","CSS color") }} 以了解更多信息。
 
-## 用法
+## 使用说明
 
 | 类别     | 外观属性                                                                     |
 | -------- | ---------------------------------------------------------------------------- |

@@ -7,7 +7,7 @@ slug: Web/SVG/Attribute/dur
 
 该属性标识了动画的简单持续时间。
 
-## 用法
+## 使用说明
 
 | 类别     | 动画定时属性                                                                |
 | -------- | --------------------------------------------------------------------------- |

@@ -22,7 +22,7 @@ slug: Web/SVG/Attribute/dx
 - 如果祖先{{SVGElement("text")}}或{{SVGElement("tspan")}}元素对于给定的字符，通过 dx 的属性指定了相对 x 坐标，那么当前文本位置会沿坐标系的 x 轴方向偏移该数值（最近的祖先具有优先级）
 - 否则没有额外的 x 轴方向的偏移发生
 
-## 用法上下文
+## 使用说明
 
 | 分类     | 无                                                                                                                              |
 | -------- | ------------------------------------------------------------------------------------------------------------------------------- |

@@ -9,7 +9,7 @@ slug: Web/SVG/Attribute/edgeMode
 
 如果没有指定 `edgeMode` 属性，等效于值被指定为 `duplicate`。
 
-## 用法
+## 使用说明
 
 | 类别     | 无                                                                                                        |
 | -------- | --------------------------------------------------------------------------------------------------------- |
-Original file line number
+Diff line change
@@ Expand Up / @@ -125,8 +125,6 @@ function multiplyMatrices(matrixA, matrixB) { @@
     }
     ```
-    ### 用法
     让我们看一看实际使用：
     ```js
@@ Expand Down @@