Skip to content

Commit

Permalink
refactor(zh-cn): unify the translation of Usage notes
Browse files Browse the repository at this point in the history
  • Loading branch information
Gahotx committed Aug 26, 2024
1 parent b51932b commit d4f13c5
Show file tree
Hide file tree
Showing 116 changed files with 116 additions and 116 deletions.
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/domhighrestimestamp/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ _这个类型没有属性。它是一个双精度浮点数。_

_这个类型没有方法。_

## 用法说明
## 使用说明

你可以通过调用 {{domxref("performance")}} 的 {{domxref("performance.now", "now()")}} 方法来获取当前的时间戳的值(自创建上下文以来经过的时间)。此方法在 {{domxref("Window")}} 和 {{domxref("Worker")}} 上下文中均可用。

Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/eventtarget/addeventlistener/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ addEventListener(type, listener, useCapture);

无({{jsxref("undefined")}})。

## 用法说明
## 使用说明

### 事件监听回调

Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/htmlmediaelement/load/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)

Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/keyboardevent/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 会像这样派发一系列按键事件:

Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/performance/clearmarks/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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();
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/performance/clearmeasures/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ slug: Web/API/Performance/clearMeasures

{{AvailableInWorkers}}

## 用法
## 使用说明

```
performance.clearMeasures();
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/performancelongtasktiming/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ slug: Web/API/PerformanceLongTaskTiming

即执行任务的容器清单。针对没有在顶层页面容器内执行的任务,`containerId``containerName``containerSrc`字段可以用来提供任务源信息。

## 用法
## 使用说明

```js
var observer = new PerformanceObserver(function (list) {
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/selection/anchornode/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ slug: Web/API/Selection/anchorNode

**`Selection.anchorNode`** 只读属性返回选区开始位置所属的节点({{domxref("Node")}})。

## 用法
## 使用说明

```plain
sel.anchorNode
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/selection/iscollapsed/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ slug: Web/API/Selection/isCollapsed

返回一个布尔值用于描述选区的起始点和终止点是否位于一个位置(即是否框选了,译者注)。

### 用法
### 使用说明

```plain
sel.isCollapsed
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/selection/removerange/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ slug: Web/API/Selection/removeRange

将一个区域从选区中移除。

### 用法
### 使用说明

```plain
sel.removeRange(range)
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/selection/selectallchildren/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ slug: Web/API/Selection/selectAllChildren

Selection.selectAllChildren() 把指定元素的所有子元素设为选中区域,并取消之前的选中区域。

## 用法
## 使用说明

```
sel.selectAllChildren(parentNode)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -125,7 +125,7 @@ function multiplyMatrices(matrixA, matrixB) {
}
```

### 用法
### 使用说明

让我们看一看实际使用:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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")}} 对象的属性,来明确请求一个文档。

Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/css/_colon_picture-in-picture/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ slug: Web/CSS/:picture-in-picture
}
```

## 用法说明
## 使用说明

`:picture-in-picture` 伪类允许你配置样式表,以便视频在画中画或者传统播放模式来回切换时自动调整内容的大小、样式或布局。

Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/css/attr/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ CSS 表达式 `attr()` 用来获取选择到的元素的某一 HTML 属性值,

`attr()` 表达式可以用于任何 CSS 属性。 {{ experimental_inline() }}

## 用法
## 使用说明

```
语法:attr( attribute-name <type-or-unit>? [, <fallback> ]? )
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/html/element/picture/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ slug: Web/HTML/Element/picture

这个元素只包含[全局属性](/zh-CN/docs/Web/HTML/Global_attributes)

## 用法提示
## 使用说明

你可以使用 {{cssxref("object-position")}} 属性调整元素框架内图像的位置,用 {{cssxref("object-fit")}} 属性控制图片如何调整大小来适应框架。

Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/html/element/rb/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ slug: Web/HTML/Element/rb

这个元素仅仅支持 [全局属性](/zh-CN/docs/HTML/Global_attributes)

## 用法注解
## 使用说明

- Ruby 注解用于展示东亚文字的发音,例如使用日语罗马音和汉语拼音的文字。 `<rb>` 元素用于分隔出 ruby 基本文本的每个片段。
- 虽然 `<rb>` 不是一个空元素,但是在源码中通常只包括每个元素的开始标签。因此 ruby 标记就不那么复杂,也更容易阅读。在渲染版本中,浏览器也可以填充完整的元素。
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/html/element/rp/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ slug: Web/HTML/Element/rp

这个元素仅仅支持 [全局属性](/zh-CN/docs/HTML/Global_attributes)

## 用法注解
## 使用说明

- Ruby 注解用于展示东亚文字的发音,例如使用日语罗马音和汉语拼音的文字。 `<rp>` 元素用于不支持 {{ HTMLElement("ruby") }} 元素的情况。 `<rp>` 的内容提供了应该展示的东西,通常是圆括号,以便表示 ruby 注解的存在。

Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/html/element/track/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -83,7 +83,7 @@ slug: Web/HTML/Element/track
- `srclang`
- : track 文本数据的语言。它必须是合法的 [BCP 47](http://people.w3.org/rishida/utils/subtags/) 语言标签。如果 `kind` 属性被设为 `subtitles`, 那么 `srclang` 必须定义。

## 用法说明
## 使用说明

### 轨道数据类型

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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")}} 元素:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ slug: Web/JavaScript/Reference/Global_Objects/TypedArray/subarray

{{EmbedInteractiveExample("pages/js/typedarray-subarray.html")}}

## 用法
## 使用说明

```js-nolint
subarray()
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/svg/attribute/accumulate/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ slug: Web/SVG/Attribute/accumulate

在原来的结果的基础上重复动画的时候,它通常很有用,每一次循环都累加。这个属性告诉动画是否是每次循环,前一个动画属性值要加上去。

## 用法
## 使用说明

| 类别 | 动画累加属性 |
| -------- | --------------------------------------------------------------------------------- |
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/svg/attribute/alignment-baseline/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ slug: Web/SVG/Attribute/alignment-baseline

作为一个外观属性,它还可以直接作为 CSS 样式表内部的属性使用。请阅读 {{ cssxref("alignment-baseline","CSS alignment-baseline") }} 以了解更多信息。

## 用法
## 使用说明

| 类别 | 外观属性 |
| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/svg/attribute/attributename/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ slug: Web/SVG/Attribute/attributeName

该属性标识了在一个动画动作环节中,父元素的需要被改变的属性名。

## 用法
## 使用说明

| 类别 | 动画属性目标属性 |
| -------- | ------------------------------------------------------------------------------------- |
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/svg/attribute/attributetype/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ slug: Web/SVG/Attribute/attributeType

该属性指定目标属性和它相对应的值处于哪个命名空间里。

## 用法
## 使用说明

| 类别 | 动画属性目标属性 |
| -------- | ------------------------------------------------------------------------------------- |
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/svg/attribute/baseline-shift/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ slug: Web/SVG/Attribute/baseline-shift

作为一个外观属性,它还可以直接作为 CSS 样式表内部的属性使用。请看{{ cssxref("baseline-shift","CSS baseline-shift") }}以了解更多信息。

## 用法
## 使用说明

| 类别 | 外观属性 |
| -------- | --------------------------------------------------------------------------------------------------------------- |
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/svg/attribute/begin/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`

## 用法
## 使用说明

| 类别 | 动画定时属性 |
| -------- | ----------------------------------------------------------------------------- |
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/svg/attribute/clip/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ svg {

{{EmbedLiveSample('示例', '100%', 150)}}

## 用法
## 使用说明

**Warning:** This property is deprecated. Use {{cssxref("clip-path")}} instead.

Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/svg/attribute/color/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ slug: Web/SVG/Attribute/color

作为一个外观属性,它还可以直接用作 CSS 样式表的属性。请阅读 {{ cssxref("color","CSS color") }} 以了解更多信息。

## 用法
## 使用说明

| 类别 | 外观属性 |
| -------- | ---------------------------------------------------------------------------- |
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/svg/attribute/dur/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ slug: Web/SVG/Attribute/dur

该属性标识了动画的简单持续时间。

## 用法
## 使用说明

| 类别 | 动画定时属性 |
| -------- | --------------------------------------------------------------------------- |
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/svg/attribute/dx/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ slug: Web/SVG/Attribute/dx
- 如果祖先{{SVGElement("text")}}或{{SVGElement("tspan")}}元素对于给定的字符,通过 dx 的属性指定了相对 x 坐标,那么当前文本位置会沿坐标系的 x 轴方向偏移该数值(最近的祖先具有优先级)
- 否则没有额外的 x 轴方向的偏移发生

## 用法上下文
## 使用说明

| 分类 ||
| -------- | ------------------------------------------------------------------------------------------------------------------------------- |
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/svg/attribute/edgemode/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ slug: Web/SVG/Attribute/edgeMode

如果没有指定 `edgeMode` 属性,等效于值被指定为 `duplicate`

## 用法
## 使用说明

| 类别 ||
| -------- | --------------------------------------------------------------------------------------------------------- |
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/svg/attribute/end/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ slug: Web/SVG/Attribute/end

这个属性值是一个分号分隔的数列值。每个单独值可以是定义在{{ SVGAttr("begin") }}属性中同种类型。

## 用法
## 使用说明

| 类别 | 动画定时属性 |
| -------- | --------------------------------------------------------------------------- |
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/svg/attribute/fill-opacity/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ slug: Web/SVG/Attribute/fill-opacity

该属性指定了填色的不透明度或当前对象的内容物的不透明度。

## 用法
## 使用说明

| 类别 | 外观属性 |
| -------- | ----------------------------------------------------------------------------------- |
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/svg/attribute/fill-rule/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ svg {

{{EmbedLiveSample('示例', '100%', 200)}}

## 用法
## 使用说明

| 类别 | 外观属性 |
| -------- | -------------------------------------------------------------------------------- |
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/svg/attribute/fill/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ slug: Web/SVG/Attribute/fill

对于形状元素和文本,`fill` 属性是外观属性,用来定义给定图形元素内部的颜色。哪一块算是“内部”取决于形状本身以及{{ SVGAttr("fill-rule") }} 属性的值。作为一个外观属性,它可以直接用作 CSS 样式表内部的属性。

## 用法
## 使用说明

### 对动画元素

Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/svg/attribute/filter/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ slug: Web/SVG/Attribute/filter

作为一个外观属性,它可以直接用作 CSS 样式表内部的属性。请阅读 {{ cssxref("filter","CSS filter") }} 以了解更多信息。

## 用法
## 使用说明

| 类别 | 外观属性 |
| -------- | ------------------------------------------------------------------------------- |
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/svg/attribute/fr/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ slug: Web/SVG/Attribute/fr

对于 {{ SVGElement("radialGradient") }} 元素,此属性用来定义径向渐变的焦点的半径。若该属性没有被定义,默认值为 0%。

## 用法
## 使用说明

| 类别 ||
| -------- | ---------------------------------------------------------------------------------------------------------------------------- |
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/svg/attribute/from/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ slug: Web/SVG/Attribute/From

这个属性是在 svg 动画发生过程中被修改的属性的初始值。当同时使用了这个属性和 [to](/zh-CN/docs/Web/SVG/Attribute/To) 属性,animation 将会修改这个这个设定的动画属性的值从 from 属性的值到 to 属性的值。

## 用法
## 使用说明

| 类别 | 动画属性值 |
| ---------- | ---------------------------------------------------------------------------- |
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/svg/attribute/fx/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ slug: Web/SVG/Attribute/fx

对于 {{ SVGElement("radialGradient") }} 元素,此属性用来定义径向渐变的焦点的 x 轴坐标。如果该属性没有被定义,就假定它与中心点是同一位置。

## 用法
## 使用说明

| 类别 ||
| -------- | ---------------------------------------------------------------------------------------------------------------------------- |
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/svg/attribute/fy/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -115,7 +115,7 @@ svg {

{{EmbedLiveSample("示例 2", "200", "250")}}

## 用法
## 使用说明

<table class="properties">
<tbody>
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/svg/attribute/height/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ slug: Web/SVG/Attribute/height
- {{ SVGElement("use") }}
- {{ SVGElement("mask") }}

## 用法
## 使用说明

对于 {{SVGElement('use')}} 元素,`height` 定义了引用元素的垂直长度。

Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/svg/attribute/keytimes/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ keyTimes 列表的语义取决于插值模式:

如果 duration(持续时间)不确定,则将忽略任何 keyTimes 规范。

## 用法
## 使用说明

| 类别 | 动画值属性 |
| ------ | ---------- |
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/svg/attribute/mask/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ slug: Web/SVG/Attribute/mask

作为一个外观属性,它可以直接用作 CSS 样式表内部的属性。

## 用法
## 使用说明

| 类别 | 外观属性 |
| ------ | -------------------------------------------------------------------- |
Expand Down
Loading

0 comments on commit d4f13c5

Please sign in to comment.