Skip to content

Commit

Permalink
chore: convert noteblocks
Browse files Browse the repository at this point in the history
  • Loading branch information
PassionPenguin committed Jul 30, 2024
1 parent 0bc612b commit c4d81da
Show file tree
Hide file tree
Showing 13 changed files with 27 additions and 13 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -108,7 +108,8 @@ URL 的第一部分是*方案*(scheme),它表示浏览器必须使用的
- 显示多媒体如图片(用 {{HTMLElement("img")}} 元素)、视频(用 {{HTMLElement("video")}} 元素)、声音和音乐(用 {{HTMLElement("audio")}} 元素)等;
- 显示其他 HTML 文档,用 {{HTMLElement("iframe")}} 元素。

> **备注:** 当在页面中加载资源时指定 URL(例如使用 `<script>``<audio>``<img>``<video>` 等),通常应只使用 HTTP 和 HTTPS URL,除了一些例外情况(一个显著的例外是 `data:`;参见[数据 URL](/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URLs))。例如,使用 FTP 是不安全的,并且不再受现代浏览器的支持。
> [!NOTE]
> 当在页面中加载资源时指定 URL(例如使用 `<script>``<audio>``<img>``<video>` 等),通常应只使用 HTTP 和 HTTPS URL,除了一些例外情况(一个显著的例外是 `data:`;参见[数据 URL](/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URLs))。例如,使用 FTP 是不安全的,并且不再受现代浏览器的支持。
其他大量使用 URL 的技术(如 {{Glossary("CSS")}} 或 {{Glossary("JavaScript")}})才是 Web 的中心。

Expand Down
3 changes: 2 additions & 1 deletion files/zh-cn/web/api/element/scrollwidth/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,8 @@ slug: Web/API/Element/scrollWidth

`scrollWidth`值等于元素在不使用水平滚动条的情况下适合视口中的所有内容所需的最小宽度。宽度的测量方式与{{domxref("Element.clientWidth", "clientWidth")}}相同:它包含元素的内边距,但不包括边框,外边距或垂直滚动条(如果存在)。它还可以包括伪元素的宽度,例如{{cssxref("::before")}}或{{cssxref("::after")}}。如果元素的内容可以适合而不需要水平滚动条,则其`scrollWidth`等于{{domxref("Element.clientWidth", "clientWidth")}}

> **备注:** 1. 这个属性会进行四舍五入并返回整数,如果你需要小数形式的值,使用{{ domxref("element.getBoundingClientRect()") }}_._
> [!NOTE]
> 1. 这个属性会进行四舍五入并返回整数,如果你需要小数形式的值,使用{{ domxref("element.getBoundingClientRect()") }}_._
>
> _2. 在实际测试过程中,谷歌获取的_ **`Element.scrollWidth`** 和 IE,火狐下获取的 **`Element.scrollWidth`** 并不相同
Expand Down
3 changes: 2 additions & 1 deletion files/zh-cn/web/api/mediadevices/selectaudiooutput/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,8 @@ selectAudioOutput(options)

该选项适用于希望存储设备 ID 以便将来会话中默认使用同一设备的应用程序。注意,方法可能会返回同一设备的新 ID,并且持久化的 ID 必须在 {{domxref("HTMLMediaElement.setSinkId","setSinkId()")}} 成功地通过 `selectAudioOutput()` 传递后才能使用。

> **备注:** 如果在先前会话中通过 `selectAudioOutput()` 向用户显示了指定的非空 ID,则用户代理可能会选择跳过提示用户的步骤。
> [!NOTE]
> 如果在先前会话中通过 `selectAudioOutput()` 向用户显示了指定的非空 ID,则用户代理可能会选择跳过提示用户的步骤。
> 在这种情况下,用户代理可能会简单地解析为此设备 ID,或者如果设备 ID 已更改,则解析为同一设备的新 ID。
> 如果先前授予了指定设备的权限,但此后被撤销,用户代理可能会显示所有允许的设备,并突出显示具有指定 ID 的设备。
Expand Down
3 changes: 2 additions & 1 deletion files/zh-cn/web/api/rtcicecandidate/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,8 @@ l10n:

- {{domxref("RTCIceCandidate.RTCIceCandidate()","RTCIceCandidate()")}}
- : 构造一个新的表示 ICE 候选者的 `RTCIceCandidate` 对象。根据配置对象进行可选配置。
> **备注:** 为了向后兼容,构造函数也接受一个包含 {{domxref("RTCIceCandidate.candidate", "candidate")}} 属性值字符串参数,以此替代配置对象。
> [!NOTE]
> 为了向后兼容,构造函数也接受一个包含 {{domxref("RTCIceCandidate.candidate", "candidate")}} 属性值字符串参数,以此替代配置对象。
## 实例属性

Expand Down
3 changes: 2 additions & 1 deletion files/zh-cn/web/css/css_shapes/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,8 @@ slug: Web/CSS/CSS_shapes

**CSS Shapes** 是一个 CSS 模块,用于定义在 CSS 值中使用的几何形状。

> **备注:** ### CSS3 Shapes & CSS3 Regions<https://www.w3.org/TR/css-shapes-1/> > <https://www.w3.org/TR/css-regions-1/>
> [!NOTE]
> ### CSS3 Shapes & CSS3 Regions<https://www.w3.org/TR/css-shapes-1/> > <https://www.w3.org/TR/css-regions-1/>
## Reference

Expand Down
3 changes: 2 additions & 1 deletion files/zh-cn/web/css/grid-template-columns/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,8 @@ grid-template-columns: unset;

- : 如果该网格轨道为最大时,该属性等同于 `<max-content>`,为最小时,则等同于 `<min-content>`。

**备注:** 网格轨道大小为 `auto`(且只有为 `auto`)时,才可以被属性 {{cssxref("align-content")}} 和 {{cssxref("justify-content")}} 拉伸。
> [!NOTE]
> 网格轨道大小为 `auto`(且只有为 `auto`)时,才可以被属性 {{cssxref("align-content")}} 和 {{cssxref("justify-content")}} 拉伸。

- {{cssxref("fit-content", "fit-content( [ &lt;length&gt; | &lt;percentage&gt; ] )")}}
- : 相当于公式 `min(max-content, max(auto, argument))`,类似于 `auto` 的计算(即 `minmax(auto, max-content)`),除了网格轨道大小值是确定下来的,否则该值都大于 `auto` 的最小值。
Expand Down
3 changes: 2 additions & 1 deletion files/zh-cn/web/html/element/input/checkbox/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -83,7 +83,8 @@ slug: Web/HTML/Element/input/checkbox
- `checked`

- : 一个布尔属性,表示该复选框是否被默认选中(当页面加载时)。它不表示这个复选框当前是否被选中:如果复选框的状态被改变,这个内容属性不反映这个变化。此时,只有 {{domxref("HTMLInputElement")}} 的 IDL 属性 `checked` 会更新。
> **备注:** 与其他输入控件不同,复选框的值只有在复选框当前状态为 `checked` 时才会被包含在提交的数据中。如果它被选中,那么复选框的 `value` 属性的值就会被报告为输入的值。不像其他浏览器那样,Firefox 默认情况下在不同页面之间会[保持 `<input>` 动态选中的状态](https://stackoverflow.com/questions/5985839/bug-with-firefox-disabled-attribute-of-input-not-resetting-when-refreshing)。请使用 [`autocomplete`](/zh-CN/docs/Web/HTML/Element/input#autocomplete) 属性来控制这个特性。
> [!NOTE]
> 与其他输入控件不同,复选框的值只有在复选框当前状态为 `checked` 时才会被包含在提交的数据中。如果它被选中,那么复选框的 `value` 属性的值就会被报告为输入的值。不像其他浏览器那样,Firefox 默认情况下在不同页面之间会[保持 `<input>` 动态选中的状态](https://stackoverflow.com/questions/5985839/bug-with-firefox-disabled-attribute-of-input-not-resetting-when-refreshing)。请使用 [`autocomplete`](/zh-CN/docs/Web/HTML/Element/input#autocomplete) 属性来控制这个特性。
- `value`

Expand Down
4 changes: 3 additions & 1 deletion files/zh-cn/web/html/element/input/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -1077,7 +1077,9 @@ nameInput.addEventListener("invalid", () => {

> [!NOTE]
> 始终在客户端和服务器端验证输入约束。约束验证并不能消除在*服务器端*进行验证的必要性。无效的值仍然可以由旧的浏览器或坏的行为者发送。
> **备注:** Firefox 在许多版本中支持一个专有的错误属性——`x-moz-errormessage`,它允许你以类似的方式设置自定义错误信息。从第 66 版开始,这个属性已被移除(见[Firefox bug 1513890](https://bugzil.la/1513890))。
> [!NOTE]
> Firefox 在许多版本中支持一个专有的错误属性——`x-moz-errormessage`,它允许你以类似的方式设置自定义错误信息。从第 66 版开始,这个属性已被移除(见[Firefox bug 1513890](https://bugzil.la/1513890))。
### 本地化

Expand Down
3 changes: 2 additions & 1 deletion files/zh-cn/web/html/element/script/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -106,7 +106,8 @@ slug: Web/HTML/Element/script
- `strict-origin`:只在协议安全等级相同时(如 HTTPS→HTTPS)发送文档的源作为 referrer,目标安全性降低(如 HTTPS→HTTP)时不发送。
- `strict-origin-when-cross-origin`:在执行同源请求时,发送完整的 URL,但只在协议安全级别保持不变(如 HTTPS→HTTPS)时发送源,而在目标安全性降低(如 HTTPS→HTTP)时不发送标头。
- `unsafe-url`:referrer 将包含源**路径(但不包含[片段](/zh-CN/docs/Web/API/HTMLAnchorElement/hash)[密码](/zh-CN/docs/Web/API/HTMLAnchorElement/password)[用户名](/zh-CN/docs/Web/API/HTMLAnchorElement/username))。**这个值是不安全的**,因为它将 TLS 保护的资源的源和路径泄露给不安全的源。
> **备注:** 空字符串(`""`)既是默认值,也是在不支持 `referrerpolicy` 的情况下的一个回退值。如果没有在 `<script>` 元素上明确指定 `referrerpolicy`,它将采用更高级别的 referrer 策略,即对整个文档或域设置的策略。如果没有更高级别的策略,空字符串将被视为等同于 `no-referrer-when-downgrade`
> [!NOTE]
> 空字符串(`""`)既是默认值,也是在不支持 `referrerpolicy` 的情况下的一个回退值。如果没有在 `<script>` 元素上明确指定 `referrerpolicy`,它将采用更高级别的 referrer 策略,即对整个文档或域设置的策略。如果没有更高级别的策略,空字符串将被视为等同于 `no-referrer-when-downgrade`
- `src`
- : 这个属性定义引用外部脚本的 URI,这可以用来代替直接在文档中嵌入脚本。
Expand Down
3 changes: 2 additions & 1 deletion files/zh-cn/web/html/global_attributes/lang/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,8 @@ slug: Web/HTML/Global_attributes/lang

{{EmbedInteractiveExample("pages/tabbed/attribute-lang.html","tabbed-shorter")}}

> **备注:** ## 语言标签语法完整的 BCP47 语法足以标记极其特定的语言方言,但大多数用法都要简单得多。语言标记由连字符分隔的语言子标签组成,其中每个子标签指示该语言的特定属性。3 个最常见的子标签是:
> [!NOTE]
> ## 语言标签语法完整的 BCP47 语法足以标记极其特定的语言方言,但大多数用法都要简单得多。语言标记由连字符分隔的语言子标签组成,其中每个子标签指示该语言的特定属性。3 个最常见的子标签是:
>
> - 语言子标签
> - : Required。一个 2 或 3 个字符的代码,用于定义基本语言,通常全部用小写编写。例如,English 的语言代码是`en`,Badeshi 的代码是`bdz`
Expand Down
3 changes: 2 additions & 1 deletion files/zh-cn/web/http/cors/errors/corsmethodnotfound/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,8 @@ Access-Control-Allow-Methods: GET,HEAD,POST

请确保当访问服务时你的代码只使用了允许的 HTTP 方法。

**备注:** 如果服务器的 `Access-Control-Allow-methods` 标头中包含任何未识别的或未定义的方法名称,会出现不同的错误:原因:[`Reason: invalid token 'xyz' in CORS header 'Access-Control-Allow-Methods'`](/zh-CN/docs/Web/HTTP/CORS/Errors/CORSInvalidAllowMethod)
> [!NOTE]
> 如果服务器的 `Access-Control-Allow-methods` 标头中包含任何未识别的或未定义的方法名称,会出现不同的错误:原因:[`Reason: invalid token 'xyz' in CORS header 'Access-Control-Allow-Methods'`](/zh-CN/docs/Web/HTTP/CORS/Errors/CORSInvalidAllowMethod)
## 参见

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

**`vector-effect`** 属性指明绘制对象时要使用的矢量效果。在任何其他合成操作(如滤镜,蒙版和剪辑等)之前,都要应用矢量效果。

**备注:** 作为显示性属性, `vector-effect` 也可以直接在 CSS 样式表中作为属性使用。
> [!NOTE]
> 作为显示性属性, `vector-effect` 也可以直接在 CSS 样式表中作为属性使用。
作为显示性属性,它能被应用到任何元素,但只对这 10 个元素有效果:{{SVGElement("circle")}}, {{SVGElement("ellipse")}}, {{SVGElement("foreignObject")}}, {{SVGElement("image")}}, {{SVGElement("line")}}, {{SVGElement("path")}}, {{SVGElement("polygon")}}, {{SVGElement("polyline")}}, {{SVGElement("rect")}}, {{SVGElement("text")}}, {{SVGElement("textPath")}} {{SVGElement("tspan")}}, and {{SVGElement("use")}}

Expand Down
3 changes: 2 additions & 1 deletion files/zh-tw/learn/javascript/first_steps/math/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -141,7 +141,8 @@ Arithmetic operators are the basic operators that we use to do sums:
> [!NOTE]
> You'll sometimes see numbers involved in sums referred to as {{Glossary("Operand", "operands")}}.
**備註:** You may sometimes see exponents expressed using the older {{jsxref("Math.pow()")}} method, which works in a very similar way. For example, in `Math.pow(7, 3)`, `7` is the base and `3` is the exponent, so the result of the expression is `343`. `Math.pow(7, 3)` is equivalent to `7**3`.
> [!NOTE]
> You may sometimes see exponents expressed using the older {{jsxref("Math.pow()")}} method, which works in a very similar way. For example, in `Math.pow(7, 3)`, `7` is the base and `3` is the exponent, so the result of the expression is `343`. `Math.pow(7, 3)` is equivalent to `7**3`.
We probably don't need to teach you how to do basic math, but we would like to test your understanding of the syntax involved. Try entering the examples below into your [developer tools JavaScript console](/zh-TW/docs/Learn/Common_questions/What_are_browser_developer_tools), or use the simple built in console seen earlier if you'd prefer, to familiarize yourself with the syntax.

Expand Down

0 comments on commit c4d81da

Please sign in to comment.