Skip to content

Commit 07cc78b

Browse files
committed
doc: add <wbr> <video> <var> tag document.
1 parent 7ebeb3a commit 07cc78b

File tree

4 files changed

+176
-6
lines changed

4 files changed

+176
-6
lines changed

docs/tags/audio.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -65,6 +65,9 @@ HTML 支持三种音频格式:MP3、WAV 和 OGG。
6565

6666
`<audio>` 标签支持 HTML 中的[事件属性](../reference/eventattributes.md)
6767

68+
## 相关页面
69+
70+
HTML Audio/Video DOM 参考: [HTML Audio/Video DOM Reference](../reference/av_dom.md)
6871

6972
[1]: ../assets/chrome.svg
7073
[2]: ../assets/edge.svg

docs/tags/var.md

Lines changed: 57 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,59 @@
1-
var.md
1+
HTML \<var> Tag
22
===
33

4-
欢迎您编辑 <a target="__blank" href="https://github.com/jaywcjlove/html-tutorial/blob/main/docs/tags/var.md">docs/tags/var.md</a> 文件,共建 HTML Tutorial 文档。
4+
## 示例
5+
6+
将一些文本定义为文档中的变量:
7+
8+
```html idoc:preview:iframe
9+
<p>The area of a triangle is: 1/2 x <var>b</var> x <var>h</var>, where <var>b</var> is the base, and <var>h</var> is the vertical height.</p>
10+
```
11+
12+
## 定义和用法
13+
14+
`<var>` 标签用于在编程或数学表达式中定义变量。 里面的内容通常以*斜体*显示。
15+
16+
**提示:** 此标签未被弃用。 但是,使用 CSS 可以实现更丰富的效果。
17+
18+
还请看:
19+
20+
| 标签 Tag | 描述 Description |
21+
| ---- | ---- |
22+
| [\<code>](./code.md) | 定义一段计算机代码 |
23+
| [\<samp>](./samp.md) | 定义计算机程序的样本输出 |
24+
| [\<kbd>](./kbd.md) | 定义键盘输入 |
25+
| [\<pre>](./pre.md) | 定义预格式化文本 |
26+
27+
## 浏览器支持
28+
29+
| Element | ![chrome][1] | ![edge][2] | ![firefox][3] | ![safari][4] | ![opera][5] |
30+
| ------- | --- | --- | --- | --- | --- |
31+
| \<var> | Yes | Yes | Yes | Yes | Yes |
32+
33+
## 全局属性
34+
35+
`<var>` 标签支持 HTML 中的[全局属性](../reference/standardattributes.md)
36+
37+
## 事件属性
38+
39+
`<var>` 标签支持 HTML 中的[事件属性](../reference/eventattributes.md)
40+
41+
## 相关页面
42+
43+
HTML 教程: [HTML Text Formatting](../tutorial/formatting.md)
44+
45+
## 默认 CSS 设置
46+
47+
大多数浏览器将显示具有以下默认值的 `<var>` 元素:
48+
49+
```css
50+
var {
51+
  font-style: italic;
52+
}
53+
```
54+
55+
[1]: ../assets/chrome.svg
56+
[2]: ../assets/edge.svg
57+
[3]: ../assets/firefox.svg
58+
[4]: ../assets/safari.svg
59+
[5]: ../assets/opera.svg

docs/tags/video.md

Lines changed: 80 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,82 @@
1-
video.md
1+
HTML \<video> Tag
22
===
33

4-
欢迎您编辑 <a target="__blank" href="https://github.com/jaywcjlove/html-tutorial/blob/main/docs/tags/video.md">docs/tags/video.md</a> 文件,共建 HTML Tutorial 文档。
4+
## 示例
5+
6+
播放视频:
7+
8+
```html idoc:preview:iframe
9+
<video width="320" controls>
10+
<source
11+
type="video/mp4"
12+
src="https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4">
13+
<source
14+
type="video/webm"
15+
src="https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.webm">
16+
Your browser does not support the video tag.
17+
</video>
18+
```
19+
20+
## 定义和用法
21+
22+
`<video>` 标签用于在文档中嵌入视频内容,例如电影剪辑或其他视频流。
23+
24+
`<video>` 标签包含一个或多个具有不同视频源的 [`<source>`](./source.md) 标签。 浏览器将选择它支持的第一个来源。
25+
26+
`<video>``</video>` 标签之间的文本只会在不支持 \<video> 元素的浏览器中显示。
27+
28+
HTML 支持三种视频格式:MP4、WebM 和 OGG。
29+
30+
| 浏览器 | MP4 | WebM | Ogg |
31+
| ------- | --- | ---- | --- |
32+
| ![edge][2] | YES | YES | YES |
33+
| ![chrome][1] | YES | YES | YES |
34+
| ![firefox][3] | YES | YES | YES |
35+
| ![safari][4] | YES | YES ||
36+
| ![opera][5] | YES | YES | YES |
37+
38+
## 提示和注意事项
39+
40+
**提示:** 对于音频文件,请查看 [`<audio>`](./audio.md) 标签。
41+
42+
## Browser Support
43+
44+
表中的数字指定了完全支持该元素的第一个浏览器版本。
45+
46+
| Element | ![chrome][1] | ![edge][2] | ![firefox][3] | ![safari][4] | ![opera][5] |
47+
| ------- | --- | --- | --- | --- | --- |
48+
| \<video> | 4.0 | 9.0 | 3.5 | 3.1 | 11.5 |
49+
50+
## 可选属性
51+
52+
| 属性 Attribute | 值 Value | 描述 Description |
53+
| -------- | -------- | -------- |
54+
| [autoplay](./video_autoplay.md) | autoplay | 指定视频一准备好就开始播放 |
55+
| [controls](./video_controls.md) | controls | 指定应显示视频控件(例如播放/暂停按钮等) |
56+
| [height](./video_height.md) | *pixels* | 设置视频播放器的高度 |
57+
| [loop](./video_loop.md) | loop | 指定视频将在每次结束时重新开始 |
58+
| [muted](./video_muted.md) | muted | 指定视频的音频输出应静音 |
59+
| [poster](./video_poster.md) | *URL* | 指定在视频下载时或用户点击播放按钮之前显示的图像 |
60+
| [preload](./video_preload.md) | auto<br>metadata<br>none | 指定当页面加载时作者是否以及如何认为应该加载视频 |
61+
| [src](./video_src.md) | *URL* | 指定视频文件的 URL |
62+
| [width](./video_width.md) | *pixels* | 设置视频播放器的宽度 |
63+
64+
## 全局属性
65+
66+
`<video>` 标签支持 HTML 中的[全局属性](../reference/standardattributes.md)
67+
68+
## 事件属性
69+
70+
`<video>` 标签支持 HTML 中的[事件属性](../reference/eventattributes.md)
71+
72+
73+
## 相关页面
74+
75+
HTML Audio/Video DOM 参考: [HTML Audio/Video DOM Reference](../reference/av_dom.md)
76+
77+
78+
[1]: ../assets/chrome.svg
79+
[2]: ../assets/edge.svg
80+
[3]: ../assets/firefox.svg
81+
[4]: ../assets/safari.svg
82+
[5]: ../assets/opera.svg

docs/tags/wbr.md

Lines changed: 36 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,38 @@
1-
wbr.md
1+
HTML \<wbr> Tag
22
===
33

4-
欢迎您编辑 <a target="__blank" href="https://github.com/jaywcjlove/html-tutorial/blob/main/docs/tags/wbr.md">docs/tags/wbr.md</a> 文件,共建 HTML Tutorial 文档。
4+
## 示例
5+
6+
有断词机会的文本:
7+
8+
```html idoc:preview:iframe
9+
<p>To learn AJAX, you must be familiar with the XML<wbr>Http<wbr>Request Object.​</p>
10+
```
11+
12+
## 定义和用法
13+
14+
`<wbr>`(分词机会)标签指定在文本中可以添加换行符的位置。
15+
16+
**提示:** 当一个词太长时,浏览器可能会在错误的地方打断它。 您可以使用 `<wbr>` 元素添加分词机会。
17+
18+
## Browser Support
19+
20+
表中的数字指定了完全支持该元素的第一个浏览器版本。
21+
22+
| Element | ![chrome][1] | ![edge][2] | ![firefox][3] | ![safari][4] | ![opera][5] |
23+
| ------- | --- | --- | --- | --- | --- |
24+
| \<wbr> | 1.0 | 12.0 | 3.0 | 4.0 | 11.7 |
25+
26+
## 全局属性
27+
28+
`<wbr>` 标签支持 HTML 中的[全局属性](../reference/standardattributes.md)
29+
30+
## 事件属性
31+
32+
`<wbr>` 标签支持 HTML 中的[事件属性](../reference/eventattributes.md)
33+
34+
[1]: ../assets/chrome.svg
35+
[2]: ../assets/edge.svg
36+
[3]: ../assets/firefox.svg
37+
[4]: ../assets/safari.svg
38+
[5]: ../assets/opera.svg

0 commit comments

Comments
 (0)