Skip to content

Commit

Permalink
zh-cn: Format /web/html using Prettier
Browse files Browse the repository at this point in the history
  • Loading branch information
queengooborg committed Jul 28, 2023
1 parent 881e54e commit 7f58e13
Show file tree
Hide file tree
Showing 122 changed files with 1,400 additions and 1,078 deletions.
1 change: 0 additions & 1 deletion .prettierignore
Original file line number Diff line number Diff line change
Expand Up @@ -93,7 +93,6 @@ 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/http/**/*.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

0 comments on commit 7f58e13

Please sign in to comment.