diff --git a/.prettierignore b/.prettierignore index 50dc02b28a883d..f23b1b75743812 100644 --- a/.prettierignore +++ b/.prettierignore @@ -90,5 +90,4 @@ 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 diff --git a/files/zh-cn/web/html/attributes/disabled/index.md b/files/zh-cn/web/html/attributes/disabled/index.md index 8a82d76aa94270..c69216055ec205 100644 --- a/files/zh-cn/web/html/attributes/disabled/index.md +++ b/files/zh-cn/web/html/attributes/disabled/index.md @@ -51,9 +51,7 @@ slug: Web/HTML/Attributes/disabled
复选框

- +

禁用的 fieldset

- +

diff --git a/files/zh-cn/web/html/attributes/rel/index.md b/files/zh-cn/web/html/attributes/rel/index.md index 25aee6d880e560..8f1643dd5cf94b 100644 --- a/files/zh-cn/web/html/attributes/rel/index.md +++ b/files/zh-cn/web/html/attributes/rel/index.md @@ -11,34 +11,34 @@ slug: Web/HTML/Attributes/rel 下表列出了一些最重要的现有关键词。在一个以空格分隔的值内的每个关键词在该值内都应该是唯一的。 -| `rel` 值 | 描述 | {{htmlelement('link')}} | {{htmlelement('a')}} 和 {{htmlelement('area')}} | {{htmlelement('form')}} | -| -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | ----------------------------------------------- | ----------------------- | -| [`alternate`](#attr-alternate) | 当前文档的替代描述。 | 链接 | 链接 | 不允许 | -| [`author`](#attr-author) | 当前文档或文章的作者。 | 链接 | 链接 | 不允许 | -| [`bookmark`](#attr-bookmark) | 到最近祖先章节的永久链接。 | 不允许 | 链接 | 不允许 | -| [`canonical`](#attr-canonical) | 当前文档的首要 URL。 | 链接 | 不允许 | 不允许 | -| [`dns-prefetch`](/zh-CN/docs/Web/HTML/Attributes/rel/dns-prefetch) | 告知浏览器为目标资源的来源预先执行 DNS 解析。 | 外部资源 | 不允许 | 不允许 | -| [`external`](#attr-external) | 引用的文档与当前的文档不属于同一个站点。 | 不允许 | 注解 | 注解 | -| [`help`](#attr-help) | 链接到上下文相关的帮助。 | 链接 | 链接 | 链接 | -| [`icon`](#attr-icon) | 代表当前文档的图标。 | 外部资源 | 不允许 | 不允许 | -| [`license`](#attr-license) | 表示当前文档的主要内容由被引用文件描述的版权许可所涵盖。 | 链接 | 链接 | 链接 | -| [`manifest`](/zh-CN/docs/Web/HTML/Attributes/rel/manifest) | Web 应用清单 | 链接 | 不允许 | 不允许 | -| [`me`](/zh-CN/docs/Web/HTML/Attributes/rel/me) | 表示当前文档代表拥有链接内容的人。 | 链接 | 链接 | 不允许 | -| [`modulepreload`](/zh-CN/docs/Web/HTML/Attributes/rel/modulepreload) | 告知浏览器预先获取该脚本，并将其存储在文档的模块映射中，以便稍后评估。也可以一同获取该模块的依赖关系。 | 外部资源 | 不允许 | 不允许 | -| [`next`](#attr-next) | 表示当前文档是一个系列的一部分，被引用的文档是该系列中的下一个文档。 | 链接 | 链接 | 链接 | -| [`nofollow`](#attr-nofollow) | 表示当前文档的原作者或出版商不认可被引用的文件。 | 不允许 | 注解 | 注解 | -| [`noopener`](/zh-CN/docs/Web/HTML/Attributes/rel/noopener) | 创建一个顶级浏览上下文。如果该超链接一开始就会创建其中之一，则该浏览上下文不是一个辅助浏览上下文（即有一个适当的 `target` 属性值）。 | 不允许 | 不允许 | 注解 | -| [`noreferrer`](#attr-noreferrer) | 不会包含 `Referer` 标头。和 `noopener` 效果类似。 | 不允许 | 注解 | 注解 | -| [`opener`](#attr-opener) | 如果超链接会创建一个非辅助浏览上下文的顶级浏览上下文（即以“`_blank`”作为 `target` 属性值），则创建一个辅助浏览上下文。 | 不允许 | 注解 | 注解 | -| [`pingback`](#attr-pingback) | 给出处理当前文档 pingback 的 pingback 服务器的地址。 | 外部资源 | 不允许 | 不允许 | -| [`preconnect`](/zh-CN/docs/Web/HTML/Attributes/rel/preconnect) | 指定用户代理应预先连接到目标资源的来源。 | 外部资源 | 不允许 | 不允许 | -| [`prefetch`](/zh-CN/docs/Web/HTML/Attributes/rel/prefetch) | 指定用户代理应预先获取并缓存目标资源，因为后续的导航可能需要它。 | 外部资源 | 不允许 | 不允许 | -| [`preload`](/zh-CN/docs/Web/HTML/Attributes/rel/preload) | 指定用户代理必须根据 [`as`](/zh-CN/docs/Web/HTML/Element/link#attr-as) 属性给出的潜在目的地（以及与相应目的地相关的优先级），为当前导航预先获取和缓存目标资源。 | 外部资源 | 不允许 | 不允许 | -| [`prerender`](/zh-CN/docs/Web/HTML/Attributes/rel/prerender) | 指定用户代理应预先获取目标资源，并以有助于在未来提供更快的响应的方式处理它。 | 外部资源 | 不允许 | 不允许 | -| [`prev`](#attr-prev) | 表示当前文档是系列的一部分，被引用的文档是该系列中的上一个文档。 | 链接 | 链接 | 链接 | -| [`search`](#attr-search) | 给出一个资源的链接，可以用来搜索当前文件及其相关页面。 | 链接 | 链接 | 链接 | -| [`stylesheet`](#attr-stylesheet) | 导入样式表。 | 外部资源 | 不允许 | 不允许 | -| [`tag`](#attr-tag) | 给出一个适用于当前文档的标签（由给定地址识别）。 | 不允许 | 链接 | 链接 | +| `rel` 值 | 描述 | {{htmlelement('link')}} | {{htmlelement('a')}} 和 {{htmlelement('area')}} | {{htmlelement('form')}} | +| -------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | ----------------------------------------------- | ----------------------- | +| [`alternate`](#attr-alternate) | 当前文档的替代描述。 | 链接 | 链接 | 不允许 | +| [`author`](#attr-author) | 当前文档或文章的作者。 | 链接 | 链接 | 不允许 | +| [`bookmark`](#attr-bookmark) | 到最近祖先章节的永久链接。 | 不允许 | 链接 | 不允许 | +| [`canonical`](#attr-canonical) | 当前文档的首要 URL。 | 链接 | 不允许 | 不允许 | +| [`dns-prefetch`](/zh-CN/docs/Web/HTML/Attributes/rel/dns-prefetch) | 告知浏览器为目标资源的来源预先执行 DNS 解析。 | 外部资源 | 不允许 | 不允许 | +| [`external`](#attr-external) | 引用的文档与当前的文档不属于同一个站点。 | 不允许 | 注解 | 注解 | +| [`help`](#attr-help) | 链接到上下文相关的帮助。 | 链接 | 链接 | 链接 | +| [`icon`](#attr-icon) | 代表当前文档的图标。 | 外部资源 | 不允许 | 不允许 | +| [`license`](#attr-license) | 表示当前文档的主要内容由被引用文件描述的版权许可所涵盖。 | 链接 | 链接 | 链接 | +| [`manifest`](/zh-CN/docs/Web/HTML/Attributes/rel/manifest) | Web 应用清单 | 链接 | 不允许 | 不允许 | +| [`me`](/zh-CN/docs/Web/HTML/Attributes/rel/me) | 表示当前文档代表拥有链接内容的人。 | 链接 | 链接 | 不允许 | +| [`modulepreload`](/zh-CN/docs/Web/HTML/Attributes/rel/modulepreload) | 告知浏览器预先获取该脚本，并将其存储在文档的模块映射中，以便稍后评估。也可以一同获取该模块的依赖关系。 | 外部资源 | 不允许 | 不允许 | +| [`next`](#attr-next) | 表示当前文档是一个系列的一部分，被引用的文档是该系列中的下一个文档。 | 链接 | 链接 | 链接 | +| [`nofollow`](#attr-nofollow) | 表示当前文档的原作者或出版商不认可被引用的文件。 | 不允许 | 注解 | 注解 | +| [`noopener`](/zh-CN/docs/Web/HTML/Attributes/rel/noopener) | 创建一个顶级浏览上下文。如果该超链接一开始就会创建其中之一，则该浏览上下文不是一个辅助浏览上下文（即有一个适当的 `target` 属性值）。 | 不允许 | 不允许 | 注解 | +| [`noreferrer`](#attr-noreferrer) | 不会包含 `Referer` 标头。和 `noopener` 效果类似。 | 不允许 | 注解 | 注解 | +| [`opener`](#attr-opener) | 如果超链接会创建一个非辅助浏览上下文的顶级浏览上下文（即以“`_blank`”作为 `target` 属性值），则创建一个辅助浏览上下文。 | 不允许 | 注解 | 注解 | +| [`pingback`](#attr-pingback) | 给出处理当前文档 pingback 的 pingback 服务器的地址。 | 外部资源 | 不允许 | 不允许 | +| [`preconnect`](/zh-CN/docs/Web/HTML/Attributes/rel/preconnect) | 指定用户代理应预先连接到目标资源的来源。 | 外部资源 | 不允许 | 不允许 | +| [`prefetch`](/zh-CN/docs/Web/HTML/Attributes/rel/prefetch) | 指定用户代理应预先获取并缓存目标资源，因为后续的导航可能需要它。 | 外部资源 | 不允许 | 不允许 | +| [`preload`](/zh-CN/docs/Web/HTML/Attributes/rel/preload) | 指定用户代理必须根据 [`as`](/zh-CN/docs/Web/HTML/Element/link#attr-as) 属性给出的潜在目的地（以及与相应目的地相关的优先级），为当前导航预先获取和缓存目标资源。 | 外部资源 | 不允许 | 不允许 | +| [`prerender`](/zh-CN/docs/Web/HTML/Attributes/rel/prerender) | 指定用户代理应预先获取目标资源，并以有助于在未来提供更快的响应的方式处理它。 | 外部资源 | 不允许 | 不允许 | +| [`prev`](#attr-prev) | 表示当前文档是系列的一部分，被引用的文档是该系列中的上一个文档。 | 链接 | 链接 | 链接 | +| [`search`](#attr-search) | 给出一个资源的链接，可以用来搜索当前文件及其相关页面。 | 链接 | 链接 | 链接 | +| [`stylesheet`](#attr-stylesheet) | 导入样式表。 | 外部资源 | 不允许 | 不允许 | +| [`tag`](#attr-tag) | 给出一个适用于当前文档的标签（由给定地址识别）。 | 不允许 | 链接 | 链接 | `rel` 属性与 {{htmlelement('link')}}、{{htmlelement('a')}}、{{htmlelement('area')}} 和 {{htmlelement('form')}} 元素有关，但有些值只与这些元素的子集有关。像所有的 HTML 关键字属性值一样，这些值是不区分大小写的。 diff --git a/files/zh-cn/web/html/constraint_validation/index.md b/files/zh-cn/web/html/constraint_validation/index.md index e507fa6a43480a..755c643ac6a8b1 100644 --- a/files/zh-cn/web/html/constraint_validation/index.md +++ b/files/zh-cn/web/html/constraint_validation/index.md @@ -23,10 +23,10 @@ original_slug: Web/Guide/HTML/Constraint_validation [`type`](/zh-CN/docs/Web/HTML/Element/input#type) 属性中的固有约束有： -| Input 类型 | 约束描述 | 相关违约 | -| ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | -| [``](/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)** 约束违反 | -| [``](/zh-CN/docs/Web/HTML/Element/input/email) | 该值必须是一个语法上有效的电子邮件地址，其格式一般为 `username@hostname.tld`，但也可以是本地的，如 `username@hostname`。 | **[TypeMismatch](/zh-CN/docs/Web/API/ValidityState/typeMismatch)** 约束违反 | +| Input 类型 | 约束描述 | 相关违约 | +| ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------- | +| [``](/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)** 约束违反 | +| [``](/zh-CN/docs/Web/HTML/Element/input/email) | 该值必须是一个语法上有效的电子邮件地址，其格式一般为 `username@hostname.tld`，但也可以是本地的，如 `username@hostname`。 | **[TypeMismatch](/zh-CN/docs/Web/API/ValidityState/typeMismatch)** 约束违反 | 对于这两种输入类型，如果设置了 [`multiple`](/zh-CN/docs/Web/HTML/Element/input#multiple) 属性，可以设置几个值，作为一个逗号分隔的列表。如果其中任何一个不满足这里描述的条件，就会触发 **TypeMismatch** 约束的违反。 @@ -251,6 +251,7 @@ original_slug: Web/Guide/HTML/Constraint_validation - 通过提交表单本身。 调用 `checkValidity()` 也被称为约束的*静态*验证，调用 `reportValidity()` 也被称为约束的*交互*认证。 + > **备注：** > > - 如果 {{ HTMLElement("form") }} 元素上设置了 [`novalidate`](/zh-CN/docs/Web/HTML/Element/form#novalidate) 属性，则不发生约束验证交互。 diff --git a/files/zh-cn/web/html/content_categories/index.md b/files/zh-cn/web/html/content_categories/index.md index 139a88a1326401..facf35364684ad 100644 --- a/files/zh-cn/web/html/content_categories/index.md +++ b/files/zh-cn/web/html/content_categories/index.md @@ -135,7 +135,10 @@ original_slug: Web/Guide/HTML/Content_categories 例如，{{HTMLElement("del")}} 和 {{HTMLELement("ins")}} 是透明的： ```html -

We hold these truths to be sacred & undeniable self-evident.

+

+ We hold these truths to be sacred & undeniable + self-evident. +

``` 即使这两个元素被移除，这个代码段依然是合法的（至少从代码语法上）。 diff --git a/files/zh-cn/web/html/cors_enabled_image/index.md b/files/zh-cn/web/html/cors_enabled_image/index.md index 8c864b7be0521a..3cd12231a5524f 100644 --- a/files/zh-cn/web/html/cors_enabled_image/index.md +++ b/files/zh-cn/web/html/cors_enabled_image/index.md @@ -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(); diff --git a/files/zh-cn/web/html/date_and_time_formats/index.md b/files/zh-cn/web/html/date_and_time_formats/index.md index 3e70d47bfe323e..7d24319e155277 100644 --- a/files/zh-cn/web/html/date_and_time_formats/index.md +++ b/files/zh-cn/web/html/date_and_time_formats/index.md @@ -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 日） | 注意，年份和星期数都由前导零补齐长度，年份补齐至四位数，而星期数补齐至两位数。 @@ -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 月 | @@ -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 日 | @@ -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 秒） | ## 本地日期时间字符串 diff --git a/files/zh-cn/web/html/element/a/index.md b/files/zh-cn/web/html/element/a/index.md index e536cbebf0a1c8..223deca68bbd1c 100644 --- a/files/zh-cn/web/html/element/a/index.md +++ b/files/zh-cn/web/html/element/a/index.md @@ -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")}}。 @@ -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)); @@ -248,7 +250,7 @@ document .querySelector("a") .addEventListener( "click", - (event) => (event.target.href = canvas.toDataURL()) + (event) => (event.target.href = canvas.toDataURL()), ); ``` @@ -326,7 +328,7 @@ document 2017 年度报告（PowerPoint） ``` -如果使用图标标志链接行为，确保其具有[*替代文本*](/zh-CN/docs/Web/HTML/Element/img#alt)： +如果使用图标标志链接行为，确保其具有[_替代文本_](/zh-CN/docs/Web/HTML/Element/img#alt)： ```html diff --git a/files/zh-cn/web/html/element/abbr/index.md b/files/zh-cn/web/html/element/abbr/index.md index f084e7f77ebd23..7d60a1e8505a68 100644 --- a/files/zh-cn/web/html/element/abbr/index.md +++ b/files/zh-cn/web/html/element/abbr/index.md @@ -114,8 +114,7 @@ abbr { #### HTML ```html -

Ashok's joke made me LOL big -time.

+

Ashok's joke made me LOL big time.

``` #### 结果 @@ -129,14 +128,16 @@ time.

#### HTML ```html -

HTML - is a markup language used to create the semantics and structure -of a web page.

- -

A Specification -(spec) is a document that outlines -in detail how a technology or API is intended to function and how it is -accessed.

+

+ HTML is a + markup language used to create the semantics and structure of a web page. +

+ +

+ A Specification (spec) + is a document that outlines in detail how a technology or API is intended to + function and how it is accessed. +

``` #### 结果 @@ -152,7 +153,10 @@ accessed.

#### Example ```html -

JavaScript Object Notation (JSON) is a lightweight data-interchange format.

+

+ JavaScript Object Notation (JSON) is a lightweight + data-interchange format. +

``` 这对于不熟悉内容中讨论的术语或概念的人，对语言不熟悉的人以及具有认知问题的人特别有用。 diff --git a/files/zh-cn/web/html/element/acronym/index.md b/files/zh-cn/web/html/element/acronym/index.md index 89141ddaca479b..6d03a116741384 100644 --- a/files/zh-cn/web/html/element/acronym/index.md +++ b/files/zh-cn/web/html/element/acronym/index.md @@ -24,7 +24,10 @@ HTML Acronym 元素 (`)` 允许作者明确地声明一个字符序列 ## 例子 ```html -

The WWW is only one component of the Internet.

+

+ The WWW is only one component of the + Internet. +

``` ## 默认样式 diff --git a/files/zh-cn/web/html/element/address/index.md b/files/zh-cn/web/html/element/address/index.md index ece17186e54c36..7b526861a38a1f 100644 --- a/files/zh-cn/web/html/element/address/index.md +++ b/files/zh-cn/web/html/element/address/index.md @@ -57,17 +57,17 @@ slug: Web/HTML/Element/address 这个例子演示了如何使用 `
` 表示一篇文章的作者的联系信息。 ```html -
- You can contact author at - www.somedomain.com.
- If you see any bugs, please - contact webmaster.
- You may also want to visit us:
- Mozilla Foundation
- 331 E Evelyn Ave
- Mountain View, CA 94041
- USA -
+
+ You can contact author at + www.somedomain.com.
+ If you see any bugs, please + contact webmaster.
+ You may also want to visit us:
+ Mozilla Foundation
+ 331 E Evelyn Ave
+ Mountain View, CA 94041
+ USA +
``` ### 结果 diff --git a/files/zh-cn/web/html/element/area/index.md b/files/zh-cn/web/html/element/area/index.md index b14343b3a38990..ef09a2ca6922eb 100644 --- a/files/zh-cn/web/html/element/area/index.md +++ b/files/zh-cn/web/html/element/area/index.md @@ -34,6 +34,7 @@ _HTML `` 元素 在图片上定义一个热点区域，可以关联一个 - `media` - : 指明链接资源的媒体类型，例：print and screen。如果此属性省略，默认全部。仅在 href 属性存在情况下使用。 - `nohref` {{Deprecated_Inline}} + - : 指明此区域没有超链接。在\中必须存在 nohref 或者 href。 > **备注：** 此属性在 html5 中是废弃的，而忽略 href 属性就足够了。 @@ -45,12 +46,14 @@ _HTML `` 元素 在图片上定义一个热点区域，可以关联一个 - `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 类型的完整列表，请参阅 ref-MIMETYPES。只有当 href 属性存在时才使用该属性。 diff --git a/files/zh-cn/web/html/element/aside/index.md b/files/zh-cn/web/html/element/aside/index.md index 3b09ea22e9cd37..b2f25a66e3c7d0 100644 --- a/files/zh-cn/web/html/element/aside/index.md +++ b/files/zh-cn/web/html/element/aside/index.md @@ -49,14 +49,11 @@ slug: Web/HTML/Element/aside ```html

- 迪斯尼电影海的女儿（The Little Mermaid）于 1989 年首次登上银幕。 -

- -

- 更多有关该电影的信息… + 迪斯尼电影海的女儿（The Little Mermaid）于 1989 + 年首次登上银幕。

+ +

更多有关该电影的信息…

``` diff --git a/files/zh-cn/web/html/element/audio/index.md b/files/zh-cn/web/html/element/audio/index.md index 13bdfc39c2bd3a..d49de33c5eed5b 100644 --- a/files/zh-cn/web/html/element/audio/index.md +++ b/files/zh-cn/web/html/element/audio/index.md @@ -18,9 +18,11 @@ slug: Web/HTML/Element/audio 该元素包含 [全局属性](/zh-CN/docs/Web/HTML/Global_attributes)。 - `autoplay` + - : 布尔值属性；声明该属性，音频会尽快自动播放，不会等待整个音频文件下载完成。 > **备注：** 自动播放音频（或有声视频）可能会破坏用户体验，所以应该尽可能避免。如果你一定要提供自动播放功能，你应该加入开关（让用户主动打开自动播放）。然而，如果需要创建一些媒体元素，其播放源由用户在稍后设置，自动播放就会很有用。想了解如果正确使用自动播放，可参见我们的[自动播放指南](/zh-CN/docs/Web/Media/Autoplay_guide)。 + - `controls` - : 如果声明了该属性，浏览器将提供一个包含声音，播放进度，播放暂停的控制面板，让用户可以控制音频的播放。 - `crossorigin` @@ -32,9 +34,11 @@ slug: Web/HTML/Element/audio - `currentTime` - : 读取 `currentTime` 属性将返回一个双精度浮点值，用以标明以秒为单位的当前音频的播放位置。如果音频的元数据暂时无法访问——这意味着你无法的知道媒体的开始或持续时间。这时，`currentTime` 相对应的，能够被用于改变重播的时间。否则，设置 `currentTime` 将设置当前的播放位置，并且会自动搜寻到媒体的那个位置，如果媒体目前已经被加载的话。如果音频是以流的形式加载的，并且数据超出了媒体的缓冲区（buffer），{{Glossary("user agent")}} 可能无法获取资源的某些部分。另一些音频的时间轴可能并非从 0 秒开始，所以设置 `currentTime` 到一个开始时间之前的时间可能会失败。举个例子，如果音频媒体的时间轴从 12 小时开始，把 `currentTime` 设置到 3600 将会尝试把当前播放位置设置到媒体的开始位置之前，从而导致错误。{{domxref("HTMLMediaElement.getStartDate", "getStartDate()")}} 方法能够用于确定媒体时间轴的开始位置。 - `disableRemotePlayback` {{experimental_inline}} + - : 这是一个布尔值，用来禁用在远程设备上进行进度控制的能力。这些设备通过有线（比如 HDMI, DVI）或无线技术（比如 Miracast, Chromecast, DLNA, AirPlay,）来与 web 连接。请参考 [this proposed specification](https://www.w3.org/TR/remote-playback/#the-disableremoteplayback-attribute) 来获取更多信息。 > **备注：** 在 Safari 中，你能使用 [`x-webkit-airplay="deny"`](https://developer.apple.com/library/archive/documentation/AudioVideo/Conceptual/AirPlayGuide/OptingInorOutofAirPlay/OptingInorOutofAirPlay.html) 作为兜底方案。 + - `duration` {{ReadOnlyInline}} - : 这是一个双精度浮点数，指明了音频在时间轴中的持续时间（总长度），以秒为单位。如果元素上没有媒体，或者媒体是不可用的，那么会返回 `NaN`。如果媒体找不到确切的结尾（比如不确定长度的直播流，网络电台，或者是通过 [WebRTC](/zh-CN/docs/Web/API/WebRTC_API) 连接的流），那么这个值将返回 `+Infinity`。 - `loop` @@ -42,6 +46,7 @@ slug: Web/HTML/Element/audio - `muted` - : 表示是否静音的布尔值。默认值为 `false`，表示有声音。 - `preload` + - : 枚举属性，让开发者自行思考来示意浏览器使用何种加载方式以达到最好的用户体验。可以是以下属性之一： - `none`: 示意用户可能不会播放该音频，或者服务器希望节省带宽；换句话说，该音频不会被缓存； @@ -58,28 +63,28 @@ slug: Web/HTML/Element/audio ## 事件 -| 事件名称 | 触发时机 | -| -------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | -| [`audioprocess`](/zh-CN/docs/Web/API/ScriptProcessorNode/audioprocess_event) | 一个 {{DOMxRef("ScriptProcessorNode")}} 的输入缓冲区已经准备开始处理。 | -| {{domxref("HTMLMediaElement.canplay_event", 'canplay')}} | 浏览器已经可以播放媒体，但是预测已加载的数据不足以在不暂停的情况下顺利将其播放到结尾（即预测会在播放时暂停以获取更多的缓冲区内容） | -| {{domxref("HTMLMediaElement.canplaythrough_event", 'canplaythrough')}} | 浏览器预测已经可以在不暂停的前提下将媒体播放到结束。 | -| [`complete`](/zh-CN/docs/Web/API/OfflineAudioContext/complete_event) | 一个 {{DOMxRef("OfflineAudioContext")}} 的渲染已经中止。 | -| {{domxref("HTMLMediaElement.durationchange_event", 'durationchange')}} | `duration` 属性发生了变化。 | -| {{domxref("HTMLMediaElement.emptied_event", 'emptied')}} | 媒体置空。举个例子，当一个媒体已经加载（或部分加载）的情况下话调用 `load()` 方法，这个事件就将被触发。 | +| 事件名称 | 触发时机 | +| ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | +| [`audioprocess`](/zh-CN/docs/Web/API/ScriptProcessorNode/audioprocess_event) | 一个 {{DOMxRef("ScriptProcessorNode")}} 的输入缓冲区已经准备开始处理。 | +| {{domxref("HTMLMediaElement.canplay_event", 'canplay')}} | 浏览器已经可以播放媒体，但是预测已加载的数据不足以在不暂停的情况下顺利将其播放到结尾（即预测会在播放时暂停以获取更多的缓冲区内容） | +| {{domxref("HTMLMediaElement.canplaythrough_event", 'canplaythrough')}} | 浏览器预测已经可以在不暂停的前提下将媒体播放到结束。 | +| [`complete`](/zh-CN/docs/Web/API/OfflineAudioContext/complete_event) | 一个 {{DOMxRef("OfflineAudioContext")}} 的渲染已经中止。 | +| {{domxref("HTMLMediaElement.durationchange_event", 'durationchange')}} | `duration` 属性发生了变化。 | +| {{domxref("HTMLMediaElement.emptied_event", 'emptied')}} | 媒体置空。举个例子，当一个媒体已经加载（或部分加载）的情况下话调用 `load()` 方法，这个事件就将被触发。 | | {{domxref("HTMLMediaElement.ended_event", 'ended')}} | 播放到媒体的结束位置，播放停止。 | -| {{domxref("HTMLMediaElement.loadeddata_event", 'loadeddata')}} | 媒体的第一帧加载完成。 | -| {{domxref("HTMLMediaElement.loadedmetadata_event", 'loadedmetadata')}} | 元数据加载完成。 | +| {{domxref("HTMLMediaElement.loadeddata_event", 'loadeddata')}} | 媒体的第一帧加载完成。 | +| {{domxref("HTMLMediaElement.loadedmetadata_event", 'loadedmetadata')}} | 元数据加载完成。 | | {{domxref("HTMLMediaElement.pause_event", 'pause')}} | 播放暂停。 | -| {{domxref("HTMLMediaElement.play_event", 'play')}} | 播放开始。 | -| {{domxref("HTMLMediaElement.playing_event", 'playing ')}} | 因为缺少数据而暂停或延迟的状态结束，播放准备开始。 | -| {{domxref("HTMLMediaElement.ratechange_event", 'ratechange')}} | 播放速度变化。 | -| {{domxref("HTMLMediaElement.seeked_event", 'seeked')}} | 一次*获取* 操作结束。 | -| {{domxref("HTMLMediaElement.seeking_event", 'seeking')}} | 一次*获取* 操作开始。 | -| {{domxref("HTMLMediaElement.stalled_event", 'stalled')}} | 用户代理试图获取媒体数据，但数据意外地没有进入。 | -| {{domxref("HTMLMediaElement.suspend_event", 'suspend')}} | 媒体加载挂起。 | -| {{domxref("HTMLMediaElement.timeupdate_event", 'timeupdate')}} | 由 `currentTime` 指定的时间更新。 | -| {{domxref("HTMLMediaElement.volumechange_event", 'volumechange')}} | 音量变化。 | -| {{domxref("HTMLMediaElement.waiting_event", 'waiting')}} | 因为暂时性缺少数据，播放暂停。 | +| {{domxref("HTMLMediaElement.play_event", 'play')}} | 播放开始。 | +| {{domxref("HTMLMediaElement.playing_event", 'playing ')}} | 因为缺少数据而暂停或延迟的状态结束，播放准备开始。 | +| {{domxref("HTMLMediaElement.ratechange_event", 'ratechange')}} | 播放速度变化。 | +| {{domxref("HTMLMediaElement.seeked_event", 'seeked')}} | 一次*获取* 操作结束。 | +| {{domxref("HTMLMediaElement.seeking_event", 'seeking')}} | 一次*获取* 操作开始。 | +| {{domxref("HTMLMediaElement.stalled_event", 'stalled')}} | 用户代理试图获取媒体数据，但数据意外地没有进入。 | +| {{domxref("HTMLMediaElement.suspend_event", 'suspend')}} | 媒体加载挂起。 | +| {{domxref("HTMLMediaElement.timeupdate_event", 'timeupdate')}} | 由 `currentTime` 指定的时间更新。 | +| {{domxref("HTMLMediaElement.volumechange_event", 'volumechange')}} | 音量变化。 | +| {{domxref("HTMLMediaElement.waiting_event", 'waiting')}} | 因为暂时性缺少数据，播放暂停。 | ## 使用说明 @@ -87,10 +92,12 @@ slug: Web/HTML/Element/audio ```html ``` @@ -135,11 +142,11 @@ slug: Web/HTML/Element/audio ```js var elem = document.querySelector("audio"); -elem.audioTrackList.onaddtrack = function(event) { +elem.audioTrackList.onaddtrack = function (event) { trackEditor.addTrack(event.track); }; -elem.audioTrackList.onremovetrack = function(event) { +elem.audioTrackList.onremovetrack = function (event) { trackEditor.removeTrack(event.track); }; ``` @@ -156,9 +163,7 @@ elem.audioTrackList.onremovetrack = function(event) { ```html -
@@ -66,11 +67,11 @@ slug: Web/HTML/Element/fieldset Disabled fieldset
- +
- +
diff --git a/files/zh-cn/web/html/element/figure/index.md b/files/zh-cn/web/html/element/figure/index.md index e7fad1f17a0bed..81e03cf4d6180a 100644 --- a/files/zh-cn/web/html/element/figure/index.md +++ b/files/zh-cn/web/html/element/figure/index.md @@ -69,12 +69,16 @@ slug: Web/HTML/Element/figure ```html
- The beautiful MDN logo. + The beautiful MDN logo.
- The beautiful MDN logo. + The beautiful MDN logo.
MDN Logo
``` diff --git a/files/zh-cn/web/html/element/form/index.md b/files/zh-cn/web/html/element/form/index.md index 518075a5fa99bb..655ebda25ce9d7 100644 --- a/files/zh-cn/web/html/element/form/index.md +++ b/files/zh-cn/web/html/element/form/index.md @@ -49,24 +49,30 @@ slug: Web/HTML/Element/form 此元素拥有 [全局属性](/zh-CN/docs/HTML/Global_attributes)。 - `accept`{{Deprecated_Inline}} + - : 一个逗号分隔的列表，包括服务器能接受的内容类型。 > **备注：** **此属性已在 HTML5 中被移除并且不再被使用**。作为替代，可以使用 `` 元素中的 [`accept`](/zh-CN/docs/Web/HTML/Element/input#accept) 属性。 + - `accept-charset` - : 一个空格分隔或逗号分隔的列表，此列表包括了服务器支持的字符编码。浏览器以这些编码被列举的顺序使用它们。默认值是一个保留字符串 `"UNKNOWN"`。此字符串指的是，和包含此表单元素的文档相同的编码。 在之前版本的 HTML 中，不同的字符编码可以用空格或逗号分隔。在 HTML5 中，只有空格可以允许作为分隔符。 - `autocapitalize` {{non-standard_inline}} + - : 这是一个被 iOS Safari 使用的非标准属性。当用户在一些表单的文本后代控件中，输入/编辑一些文本值时，此属性控制了这些文本值的首字母是否大写或者使用其他的大写样式。如果 `autocapitalize` 属性在某个单独的表单后代控件被指定的话，那么此单独的设定会覆盖原来表单范围内的 `autocapitalize` 设定。默认值为 `sentences`。可以选择的值如下： - `none`：完全禁用自动首字母大写。 - `sentences`：自动对每句话首字母大写。 - `words`：自动对每个单词首字母大写。 - `characters`：自动大写所有的字母。 + - `autocomplete` + - : 用于指示 input 元素是否能够拥有一个默认值，此默认值是由浏览器自动补全的。此设定可以被属于此表单的子元素的 `autocomplete` 属性覆盖。可能的值有： - `off`：浏览器可能不会自动补全条目（在疑似登录表单中，浏览器倾向于忽略该值，而提供密码自动填充功能，参见 [自动填充属性和登录](/zh-CN/docs/Web/Security/Securing_your_site/Turning_off_form_autocompletion#禁用自动填充)） - `on`：浏览器可自动补全条目 + - `name` - : 表单的名称。HTML 4 中不推荐（应使用 `id`）。在 HTML 5 中，该值必须是所有表单中独一无二的，而且不能是空字符串。 - `rel` @@ -79,20 +85,25 @@ slug: Web/HTML/Element/form - `action` - : 处理表单提交的 URL。这个值可被 {{HTMLElement("button")}}、[``](/zh-CN/docs/Web/HTML/Element/input/submit) 或 [``](/zh-CN/docs/Web/HTML/Element/input/image) 元素上的 [`formaction`](/zh-CN/docs/Web/HTML/Element/button#formaction) 属性覆盖。 - `enctype` + - : 当 `method` 属性值为 `post` 时，`enctype` 就是将表单的内容提交给服务器的 [MIME 类型](http://en.wikipedia.org/wiki/Mime_type) 。可能的取值有： - `application/x-www-form-urlencoded`：未指定属性时的默认值。 - `multipart/form-data`：当表单包含 `type=file` 的 {{HTMLElement("input")}} 元素时使用此值。 - `text/plain`：出现于 HTML5，用于调试。这个值可被 {{HTMLElement("button")}}、[``](/zh-CN/docs/Web/HTML/Element/input/submit) 或 [``](/zh-CN/docs/Web/HTML/Element/input/image) 元素上的 [`formenctype`](/zh-CN/docs/Web/HTML/Element/button#formenctype) 属性覆盖。 + - `method` + - : 浏览器使用这种 [HTTP](/zh-CN/docs/HTTP) 方式来提交 表单。可能的值有： - `post`：指的是 HTTP [POST 方法](http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html#sec9.5)；表单数据会包含在表单体内然后发送给服务器。 - `get`：指的是 HTTP [GET 方法](http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html#sec9.3)；表单数据会附加在 `action` 属性的 URL 中，并以 '?' 作为分隔符，[没有副作用](/zh-CN/docs/Glossary/Idempotent) 时使用这个方法。 - `dialog`：如果表单在 {{HTMLElement("dialog")}} 元素中，提交时关闭对话框。此值可以被 {{HTMLElement("button")}}、[``](/zh-CN/docs/Web/HTML/Element/input/submit) 或 [``](/zh-CN/docs/Web/HTML/Element/input/image) 元素中的 [`formmethod`](/zh-CN/docs/Web/HTML/Element/button#formmethod) 属性覆盖。 + - `novalidate` - : 此布尔值属性表示提交表单时不需要验证表单。如果没有声明该属性（因此表单需要通过验证）。该属性可以被表单中的 {{HTMLElement("button")}}、[``](/zh-CN/docs/Web/HTML/Element/input/submit) 或 [``](/zh-CN/docs/Web/HTML/Element/input/image) 元素中的 [`formnovalidate`](/zh-CN/docs/Web/HTML/Element/button#formnovalidate) 属性覆盖。 - `target` + - : 表示在提交表单之后，在哪里显示响应信息。在 HTML 4 中，这是一个 frame 的名字/关键字对。在 HTML5 里，这是一个*浏览上下文* 的名字/关键字（如标签页、窗口或 iframe）。下述关键字有特别含义： - `_self`：默认值。在相同浏览上下文中加载。 @@ -107,16 +118,18 @@ slug: Web/HTML/Element/form ```html
-