Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

zh-cn: Format /web/html using Prettier #14669

Merged
merged 4 commits into from
Jul 29, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 0 additions & 1 deletion .prettierignore
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,5 @@ build/
# zh-cn
/files/zh-cn/web/api/**/*.md
/files/zh-cn/web/css/**/*.md
/files/zh-cn/web/html/**/*.md
/files/zh-cn/web/javascript/reference/**/*.md
/files/zh-cn/web/svg/**/*.md
8 changes: 2 additions & 6 deletions files/zh-cn/web/html/attributes/disabled/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,9 +51,7 @@ slug: Web/HTML/Attributes/disabled
<fieldset>
<legend>复选框</legend>
<p>
<label>
<input type="checkbox" name="chbox" value="regular" /> 普通
</label>
<label> <input type="checkbox" name="chbox" value="regular" /> 普通 </label>
</p>
<p>
<label>
Expand Down Expand Up @@ -98,9 +96,7 @@ slug: Web/HTML/Attributes/disabled
<fieldset disabled>
<legend>禁用的 fieldset</legend>
<p>
<label>
名字:<input type="name" name="radio" value="普通" />
</label>
<label> 名字:<input type="name" name="radio" value="普通" /> </label>
</p>
<p>
<label>数字:<input type="number" /></label>
Expand Down
56 changes: 28 additions & 28 deletions files/zh-cn/web/html/attributes/rel/index.md

Large diffs are not rendered by default.

9 changes: 5 additions & 4 deletions files/zh-cn/web/html/constraint_validation/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,10 +23,10 @@ original_slug: Web/Guide/HTML/Constraint_validation

[`type`](/zh-CN/docs/Web/HTML/Element/input#type) 属性中的固有约束有:

| Input 类型 | 约束描述 | 相关违约 |
| ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| [`<input type="URL">`](/zh-CN/docs/Web/HTML/Element/input/url) | 值必须为 [URL 现行标准](https://url.spec.whatwg.org/)定义的绝对 [URL](/zh-CN/docs/Learn/Common_questions/What_is_a_URL) 地址。 | **[TypeMismatch](/zh-CN/docs/Web/API/ValidityState/typeMismatch)** 约束违反 |
| [`<input type="email">`](/zh-CN/docs/Web/HTML/Element/input/email) | 该值必须是一个语法上有效的电子邮件地址,其格式一般为 `[email protected]`,但也可以是本地的,如 `username@hostname`。 | **[TypeMismatch](/zh-CN/docs/Web/API/ValidityState/typeMismatch)** 约束违反 |
| Input 类型 | 约束描述 | 相关违约 |
| ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------- |
| [`<input type="URL">`](/zh-CN/docs/Web/HTML/Element/input/url) | 值必须为 [URL 现行标准](https://url.spec.whatwg.org/)定义的绝对 [URL](/zh-CN/docs/Learn/Common_questions/What_is_a_URL) 地址。 | **[TypeMismatch](/zh-CN/docs/Web/API/ValidityState/typeMismatch)** 约束违反 |
| [`<input type="email">`](/zh-CN/docs/Web/HTML/Element/input/email) | 该值必须是一个语法上有效的电子邮件地址,其格式一般为 `[email protected]`,但也可以是本地的,如 `username@hostname`。 | **[TypeMismatch](/zh-CN/docs/Web/API/ValidityState/typeMismatch)** 约束违反 |

对于这两种输入类型,如果设置了 [`multiple`](/zh-CN/docs/Web/HTML/Element/input#multiple) 属性,可以设置几个值,作为一个逗号分隔的列表。如果其中任何一个不满足这里描述的条件,就会触发 **TypeMismatch** 约束的违反。

Expand Down Expand Up @@ -251,6 +251,7 @@ original_slug: Web/Guide/HTML/Constraint_validation
- 通过提交表单本身。

调用 `checkValidity()` 也被称为约束的*静态*验证,调用 `reportValidity()` 也被称为约束的*交互*认证。

> **备注:**
>
> - 如果 {{ HTMLElement("form") }} 元素上设置了 [`novalidate`](/zh-CN/docs/Web/HTML/Element/form#novalidate) 属性,则不发生约束验证交互。
Expand Down
5 changes: 4 additions & 1 deletion files/zh-cn/web/html/content_categories/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -135,7 +135,10 @@ original_slug: Web/Guide/HTML/Content_categories
例如,{{HTMLElement("del")}} 和 {{HTMLELement("ins")}} 是透明的:

```html
<p>We hold these truths to be <del><em>sacred &amp; undeniable</em></del> <ins>self-evident</ins>.</p>
<p>
We hold these truths to be <del><em>sacred &amp; undeniable</em></del>
<ins>self-evident</ins>.
</p>
```

即使这两个元素被移除,这个代码段依然是合法的(至少从代码语法上)。
Expand Down
3 changes: 2 additions & 1 deletion files/zh-cn/web/html/cors_enabled_image/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,8 @@ HTML 规范为图片提供了 [`crossorigin`](/zh-CN/docs/Web/HTML/Element/img#c

```js
function startDownload() {
let imageURL = "https://cdn.glitch.com/4c9ebeb9-8b9a-4adc-ad0a-238d9ae00bb5%2Fmdn_logo-only_color.svg?1535749917189";
let imageURL =
"https://cdn.glitch.com/4c9ebeb9-8b9a-4adc-ad0a-238d9ae00bb5%2Fmdn_logo-only_color.svg?1535749917189";
let imageDescription = "The Mozilla logo";

downloadedImg = new Image();
Expand Down
26 changes: 13 additions & 13 deletions files/zh-cn/web/html/date_and_time_formats/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -226,14 +226,14 @@ HTML 中的日期和时间总会使用 [ASCII](https://zh.wikipedia.org/zh-cn/IS

所有其他年份含有 52 周。

| 星期字符串 | 年份和星期数(日期区间) |
| ---------- | ------------------------------------------------------ |
| `2001-W37` | 2001 年的第 37 周(2001 年 9 月 10-16 日) |
| 星期字符串 | 年份和星期数(日期区间) |
| ---------- | ------------------------------------------------------------ |
| `2001-W37` | 2001 年的第 37 周(2001 年 9 月 10-16 日) |
| `1953-W01` | 1953 年的第 1 周(1952 年 12 月 29 日 - 1953 年 1 月 4 日) |
| `1948-W53` | 1948 年的第 53 周(1948 年 12 月 27 日 - 1949 年 1 月 2 日) |
| `1949-W01` | 1949 年的第 1 周(1949 年 1 月 3 - 9 日) |
| `0531-W16` | 531 年的第 16 周(531 年 4 月 13 - 19 日) |
| `0042-W04` | 42 年的第 4 周(42 年 1 月 21 - 27 日) |
| `1949-W01` | 1949 年的第 1 周(1949 年 1 月 3 - 9 日) |
| `0531-W16` | 531 年的第 16 周(531 年 4 月 13 - 19 日) |
| `0042-W04` | 42 年的第 4 周(42 年 1 月 21 - 27 日) |

注意,年份和星期数都由前导零补齐长度,年份补齐至四位数,而星期数补齐至两位数。

Expand All @@ -243,8 +243,8 @@ HTML 中的日期和时间总会使用 [ASCII](https://zh.wikipedia.org/zh-cn/IS

一个 **有效的月份字符串** 由一个有效的[年份数字](#年份数字)(至少四位数的字符串)组成,后面是一个连字符(“`-`”,或 U+002D),再后面是一个两位数的[月份数字](#一年中的第几月),其中 `01` 代表一月,`12` 代表十二月。

| 月份字符串 | 年份和月 |
| ---------- | ------------ |
| 月份字符串 | 年份和月 |
| ---------- | ------------- |
| `17310-09` | 17310 年 9 月 |
| `2019-01` | 2019 年 1 月 |
| `1993-11` | 1993 年 11 月 |
Expand All @@ -257,8 +257,8 @@ HTML 中的日期和时间总会使用 [ASCII](https://zh.wikipedia.org/zh-cn/IS

一个有效的日期字符串包含[月份字符串](#月份字符串),后面是一个连字符(“`-`”,或 U+002D),再后面是一个两位数的[天数数字](#一月中的第几天)。

| 日期字符串 | 日期表示 |
| ------------ | ------------------ |
| 日期字符串 | 日期表示 |
| ------------ | ------------------- |
| `1993-11-01` | 1993 年 11 月 1 日 |
| `1066-10-14` | 1066 年 10 月 14 日 |
| `0571-04-22` | 571 年 4 月 22 日 |
Expand All @@ -277,10 +277,10 @@ HTML 中的日期和时间总会使用 [ASCII](https://zh.wikipedia.org/zh-cn/IS
- 如果指定的秒数为整数,则不可在其后方跟随小数点。
- 如果秒数包含了小数,它可以是代表毫秒数的 1 至 3 位数,且跟随在时间字符串的秒成分之后的小数点后面。

| 时间字符串 | 时间 |
| ------------- | -------------------------------- |
| 时间字符串 | 时间 |
| ------------- | ----------------------------------- |
| `00:00:30.75` | 上午 12:00:30.75(午夜后 30.75 秒) |
| `12:15` | 下午 12:15 |
| `12:15` | 下午 12:15 |
| `13:44:25` | 下午 1:44:25(下午 1:44 后 25 秒) |

## 本地日期时间字符串
Expand Down
8 changes: 5 additions & 3 deletions files/zh-cn/web/html/element/a/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,9 @@ slug: Web/HTML/Element/a
- `download`

- : 导致浏览器将链接的 URL 视为下载资源。可以使用或不使用 `filename` 值:

- 如果没有指定值,浏览器会从多个来源决定文件名和扩展名:

- {{HTTPHeader("Content-Disposition")}} HTTP 标头。
- URL [路径](/zh-CN/docs/Web/API/URL/pathname)的最后一段。
- {{Glossary("MIME_type", "媒体类型")}}。来自 {{HTTPHeader("Content-Type")}} 标头,[`data:` URL](/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URLs) 的开头,或 [`blob:` URL](/zh-CN/docs/Web/API/URL/createObjectURL_static) 的 {{domxref("Blob.type")}}。
Expand Down Expand Up @@ -239,7 +241,7 @@ function draw(x, y) {
}

canvas.addEventListener("mousemove", (event) =>
draw(event.offsetX, event.offsetY)
draw(event.offsetX, event.offsetY),
);
canvas.addEventListener("mousedown", () => (isDrawing = true));
canvas.addEventListener("mouseup", () => (isDrawing = false));
Expand All @@ -248,7 +250,7 @@ document
.querySelector("a")
.addEventListener(
"click",
(event) => (event.target.href = canvas.toDataURL())
(event) => (event.target.href = canvas.toDataURL()),
);
```

Expand Down Expand Up @@ -326,7 +328,7 @@ document
<a href="2017-annual-report.ppt"> 2017 年度报告(PowerPoint) </a>
```

如果使用图标标志链接行为,确保其具有[*替代文本*](/zh-CN/docs/Web/HTML/Element/img#alt):
如果使用图标标志链接行为,确保其具有[_替代文本_](/zh-CN/docs/Web/HTML/Element/img#alt):

```html
<a target="_blank" href="https://www.wikipedia.org">
Expand Down
26 changes: 15 additions & 11 deletions files/zh-cn/web/html/element/abbr/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -114,8 +114,7 @@ abbr {
#### HTML

```html
<p>Ashok's joke made me <abbr title="Laugh Out Loud">LOL</abbr> big
time.</p>
<p>Ashok's joke made me <abbr title="Laugh Out Loud">LOL</abbr> big time.</p>
```

#### 结果
Expand All @@ -129,14 +128,16 @@ time.</p>
#### HTML

```html
<p><dfn id="html"><abbr title="HyperText Markup Language">HTML</abbr>
</dfn> is a markup language used to create the semantics and structure
of a web page.</p>

<p>A <dfn id="spec">Specification</dfn>
(<abbr title="Specification">spec</abbr>) is a document that outlines
in detail how a technology or API is intended to function and how it is
accessed.</p>
<p>
<dfn id="html"><abbr title="HyperText Markup Language">HTML</abbr> </dfn> is a
markup language used to create the semantics and structure of a web page.
</p>

<p>
A <dfn id="spec">Specification</dfn> (<abbr title="Specification">spec</abbr>)
is a document that outlines in detail how a technology or API is intended to
function and how it is accessed.
</p>
```

#### 结果
Expand All @@ -152,7 +153,10 @@ accessed.</p>
#### Example

```html
<p>JavaScript Object Notation (<abbr>JSON</abbr>) is a lightweight data-interchange format.</p>
<p>
JavaScript Object Notation (<abbr>JSON</abbr>) is a lightweight
data-interchange format.
</p>
```

这对于不熟悉内容中讨论的术语或概念的人,对语言不熟悉的人以及具有认知问题的人特别有用。
Expand Down
5 changes: 4 additions & 1 deletion files/zh-cn/web/html/element/acronym/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,10 @@ HTML Acronym 元素 (`<acronym>)` 允许作者明确地声明一个字符序列
## 例子

```html
<p>The <acronym title="World Wide Web">WWW</acronym> is only one component of the Internet.</p>
<p>
The <acronym title="World Wide Web">WWW</acronym> is only one component of the
Internet.
</p>
```

## 默认样式
Expand Down
22 changes: 11 additions & 11 deletions files/zh-cn/web/html/element/address/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,17 +57,17 @@ slug: Web/HTML/Element/address
这个例子演示了如何使用 `<address>` 表示一篇文章的作者的联系信息。

```html
<address>
You can contact author at <a href="http://www.somedomain.com/contact">
www.somedomain.com</a>.<br>
If you see any bugs, please <a href="mailto:[email protected]">
contact webmaster</a>.<br>
You may also want to visit us:<br>
Mozilla Foundation<br>
331 E Evelyn Ave<br>
Mountain View, CA 94041<br>
USA
</address>
<address>
You can contact author at
<a href="http://www.somedomain.com/contact">www.somedomain.com</a>.<br />
If you see any bugs, please
<a href="mailto:[email protected]">contact webmaster</a>.<br />
You may also want to visit us:<br />
Mozilla Foundation<br />
331 E Evelyn Ave<br />
Mountain View, CA 94041<br />
USA
</address>
```

### 结果
Expand Down
3 changes: 3 additions & 0 deletions files/zh-cn/web/html/element/area/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,7 @@ _HTML `<area>` 元素 在图片上定义一个热点区域,可以关联一个
- `media`
- : 指明链接资源的媒体类型,例:print and screen。如果此属性省略,默认全部。仅在 href 属性存在情况下使用。
- `nohref` {{Deprecated_Inline}}

- : 指明此区域没有超链接。在\<area>中必须存在 nohref 或者 href。

> **备注:** 此属性在 html5 中是废弃的,而忽略 href 属性就足够了。
Expand All @@ -45,12 +46,14 @@ _HTML `<area>` 元素 在图片上定义一个热点区域,可以关联一个
- `tabindex` {{Deprecated_Inline}}
- : 用于指定浏览器 tab 键获取焦点的顺序。在 html5 中是全局属性。
- `target`

- : 本属性指明了在什么地方显示链接的资源。HTML4 里,这个值是一个 frame 的链接或者关键字。HTML5 里,它是一个浏览器上下文 (比如:标签,窗口或者内嵌的 frame) 的链接或者关键字。值的含义:

- `_self`: 在当前区域加载链接指向的资源。这个是默认值。
- `_blank`: 在新的未命名的窗口或者 tab 里加载超链接资源。
- `_parent`: 在父级加载超链接资源。HTML4 里,是当前 frame 的父级,HTML5 里是当前的浏览器上下文,如果当前环境没有父级,行为和`_self`一样。
- `_top`: HTML4 里:将响应加载到完整的原始窗口中,取消所有其他帧。在 HTML5 中:将响应加载到顶级浏览上下文 (也就是说,浏览上下文是当前版本的祖先,并且没有父类)。如果没有父类,这个选项的行为方式与 self 相同本属性只能在指明 href 属性之后使用。

- `type`
- : 该属性指定了用于链接目标的 MIME 类型的媒体类型。一般来说,这是严格的咨询信息;然而,在未来,浏览器可能会为多媒体类型添加一个小图标。例如,当类型设置为音频/wav 时,浏览器可能会添加一个小的扬声器图标。公认的 MIME 类型的完整列表,请参阅 <http://www.w3.org/TR/html4/references.html> ref-MIMETYPES。只有当 href 属性存在时才使用该属性。

Expand Down
11 changes: 4 additions & 7 deletions files/zh-cn/web/html/element/aside/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,14 +49,11 @@ slug: Web/HTML/Element/aside
```html
<article>
<p>
迪斯尼电影<cite>海的女儿</cite>(<cite>The Little Mermaid</cite>)于 1989 年首次登上银幕。
</p>
<aside>
在首次发行期间,该片便收获了 8700 万美元的票房。
</aside>
<p>
更多有关该电影的信息…
迪斯尼电影<cite>海的女儿</cite>(<cite>The Little Mermaid</cite>)于 1989
年首次登上银幕。
</p>
<aside>在首次发行期间,该片便收获了 8700 万美元的票房。</aside>
<p>更多有关该电影的信息…</p>
</article>
```

Expand Down
Loading