Skip to content

Commit ddf1aba

Browse files
committed
doc: add autocomplete,autofocus attribute document.
1 parent a213d30 commit ddf1aba

File tree

7 files changed

+197
-10
lines changed

7 files changed

+197
-10
lines changed

docs/attribute/alt.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,7 @@ HTML alt 属性
5959

6060
`alt` 属性对每个元素都有以下浏览器支持:
6161

62-
| Element | ![chrome][1] | ![edge][2] | ![firefox][3] | ![safari][4] | ![opera][5] |
62+
| 标签 Element | ![chrome][1] | ![edge][2] | ![firefox][3] | ![safari][4] | ![opera][5] |
6363
| ------- | --- | --- | --- | --- | --- |
6464
| area | Yes | Yes | Yes | Yes | Yes |
6565
| img | Yes | Yes | Yes | Yes | Yes |

docs/attribute/async.md

Lines changed: 45 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,47 @@
1-
async.md
1+
HTML async 属性
22
===
33

4-
欢迎您编辑 <a target="__blank" href="https://github.com/jaywcjlove/html-tutorial/blob/main/docs/attribute/async.md">docs/attribute/async.md</a> 文件,共建 HTML Tutorial 文档。
4+
## 定义和用法
5+
6+
`async` 属性是一个布尔属性。
7+
8+
如果存在,它指定脚本将在可用时立即异步执行。
9+
10+
**注意:** `async` 属性仅适用于外部脚本(并且仅应在存在 `src` 属性时使用)。
11+
12+
**注意:** 有几种方法可以执行外部脚本:
13+
14+
* 如果 `async` 存在:脚本与页面的其余部分异步执行(脚本将在页面继续解析时执行)
15+
* 如果 `async` 不存在且 [`defer`](../tags/script_defer.md) 存在:脚本在页面完成解析后执行
16+
* 如果 `async`[`defer`](../tags/script_defer.md) 都不存在:在浏览器继续解析页面之前立即获取并执行脚本
17+
18+
## 适用于
19+
20+
`async` 属性可用于以下元素:
21+
22+
| 标签 Element | 属性 Attribute |
23+
| ----- | ----- |
24+
| [\<script>](../tags/script.md) | [async](../tags/script_async.md) |
25+
26+
## Script 示例
27+
28+
一个将在可用时立即异步运行的脚本:
29+
30+
```html
31+
<script src="demo_async.js" async></script>
32+
```
33+
34+
## 浏览器支持
35+
36+
表中的数字指定了完全支持该属性的第一个浏览器版本。
37+
38+
| Element | ![chrome][1] | ![edge][2] | ![firefox][3] | ![safari][4] | ![opera][5] |
39+
| ------- | --- | --- | --- | --- | --- |
40+
| async | Yes | 10.0 | 3.6 | Yes | Yes |
41+
42+
43+
[1]: ../assets/chrome.svg
44+
[2]: ../assets/edge.svg
45+
[3]: ../assets/firefox.svg
46+
[4]: ../assets/safari.svg
47+
[5]: ../assets/opera.svg

docs/attribute/autocomplete.md

Lines changed: 61 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,63 @@
1-
autocomplete.md
1+
HTML autocomplete 属性
22
===
33

4-
欢迎您编辑 <a target="__blank" href="https://github.com/jaywcjlove/html-tutorial/blob/main/docs/attribute/autocomplete.md">docs/attribute/autocomplete.md</a> 文件,共建 HTML Tutorial 文档。
4+
## 定义和用法
5+
6+
`autocomplete` 属性指定表单或输入字段是否应该打开或关闭自动完成功能。
7+
8+
自动完成允许浏览器预测值。 当用户开始输入字段时,浏览器应根据之前输入的值显示填充字段的选项。
9+
10+
**提示:** 可以为表单设置“开启”自动完成功能,为特定输入字段设置“关闭”功能,反之亦然。
11+
12+
**注意:** `autocomplete` 属性适用于以下 [`<input>`](../tags/input.md) 类型:[文本](../tags/input_type_text.md)[搜索](../tags/input_type_search.md)[url](../tags/input_type_url.md)[电话](../tags/input_type_tel.md)[电子邮件](../tags/input_type_email.md)[密码](../tags/input_type_password.md)[日期选择器](../tags/input_type_date.md)[范围](../tags/input_type_range.md)[颜色](../tags/input_type_color.md)
13+
14+
## 适用于
15+
16+
`autocomplete` 属性可用于以下元素:
17+
18+
| 标签 Element | 属性 Attribute |
19+
| ----- | ----- |
20+
| [\<form>](../tags/form.md) | [autocomplete](../tags/form_autocomplete.md) |
21+
| [\<input>](../tags/input.md) | [autocomplete](../tags/input_autocomplete.md) |
22+
23+
## 示例
24+
25+
### Form 示例
26+
27+
具有自动完成功能的表单:
28+
29+
```html idoc:preview:iframe
30+
<form action="/action\_page.php" method="get" autocomplete="on">
31+
  First name:<input type="text" name="fname"><br>
32+
  E-mail: <input type="email" name="email"><br>
33+
  <input type="submit">
34+
</form>
35+
```
36+
37+
### Input 示例
38+
39+
具有自动完成功能的 HTML 表单(一个输入字段关闭):
40+
41+
```html idoc:preview:iframe
42+
<form action="/action_page.php" autocomplete="on">
43+
  First name:<input type="text" name="fname"><br>
44+
  Last name: <input type="text" name="lname"><br>
45+
  E-mail: <input type="email" name="email" autocomplete="off"><br>
46+
  <input type="submit">
47+
</form>
48+
```
49+
50+
## 浏览器支持
51+
52+
`autocomplete` 属性对每个元素都有以下浏览器支持:
53+
54+
| 标签 Element | ![chrome][1] | ![edge][2] | ![firefox][3] | ![safari][4] | ![opera][5] |
55+
| ------- | --- | --- | --- | --- | --- |
56+
| [form](../tags/form.md) | Yes | Yes | 4.0 | 5.2 | 15.0 |
57+
| [input](../tags/input.md) | 17.0 | 5.0 | 4.0 | 5.2 | 9.6 |
58+
59+
[1]: ../assets/chrome.svg
60+
[2]: ../assets/edge.svg
61+
[3]: ../assets/firefox.svg
62+
[4]: ../assets/safari.svg
63+
[5]: ../assets/opera.svg

docs/attribute/autofocus.md

Lines changed: 66 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,68 @@
1-
autofocus.md
1+
HTML autofocus 属性
22
===
33

4-
欢迎您编辑 <a target="__blank" href="https://github.com/jaywcjlove/html-tutorial/blob/main/docs/attribute/autofocus.md">docs/attribute/autofocus.md</a> 文件,共建 HTML Tutorial 文档。
4+
## 定义和用法
5+
6+
`autofocus` 属性是一个布尔属性。
7+
8+
当存在时,它指定元素在页面加载时应该自动获得焦点。
9+
10+
## 适用于
11+
12+
`autofocus` 属性可用于以下元素:
13+
14+
| 标签 Element | 属性 Attribute |
15+
| ----- | ----- |
16+
| [\<button>](../tags/button.md) | [autofocus](../tags/button_autofocus.md) |
17+
| [\<input>](../tags/input.md) | [autofocus](../tags/input_autofocus.md) |
18+
| [\<select>](../tags/select.md) | [autofocus](../tags/select_autofocus.md) |
19+
| [\<textarea>](../tags/textarea.md) | [autofocus](../tags/textarea_autofocus.md) |
20+
21+
## 示例
22+
23+
### Button 示例
24+
25+
带自动对焦的按钮:
26+
27+
```html idoc:preview:iframe
28+
<button type="button" autofocus>Click Me!</button>
29+
```
30+
31+
### Input 示例
32+
33+
让 “名” 输入字段在页面加载时自动获得焦点:
34+
35+
```html idoc:preview:iframe
36+
<form action="/action_page.php">
37+
名: <input type="text" name="fname" autofocus><br>
38+
姓: <input type="text" name="lname"><br>
39+
<input type="submit">
40+
</form>
41+
```
42+
43+
### Textarea 示例
44+
45+
具有自动对焦的文本区域:
46+
47+
```html idoc:preview:iframe
48+
<textarea autofocus>
49+
我们提供所有 Web 开发技术的免费教程。
50+
</textarea>
51+
```
52+
53+
## 浏览器支持
54+
55+
`autofocus` 属性对每个元素都有以下浏览器支持:
56+
57+
| 标签 Element | ![chrome][1] | ![edge][2] | ![firefox][3] | ![safari][4] | ![opera][5] |
58+
| ------- | --- | --- | --- | --- | --- |
59+
| form | 5.0 | 10.0 | 4.0 | 5.0 | 9.6 |
60+
| input | 5.0 | 10.0 | 4.0 | 5.0 | 9.6 |
61+
| textarea | Yes | 10.0 | 4.0 | Yes | Yes |
62+
63+
64+
[1]: ../assets/chrome.svg
65+
[2]: ../assets/edge.svg
66+
[3]: ../assets/firefox.svg
67+
[4]: ../assets/safari.svg
68+
[5]: ../assets/opera.svg

docs/tags/blockquote.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -73,4 +73,11 @@ blockquote {
7373
margin-left: 40px;
7474
margin-right: 40px;
7575
}
76-
```
76+
```
77+
78+
79+
[1]: ../assets/chrome.svg
80+
[2]: ../assets/edge.svg
81+
[3]: ../assets/firefox.svg
82+
[4]: ../assets/safari.svg
83+
[5]: ../assets/opera.svg

docs/tags/embed.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -75,4 +75,11 @@ HTML \<embed> 标签
7575
embed:focus {
7676
  outline: none;
7777
}
78-
```
78+
```
79+
80+
81+
[1]: ../assets/chrome.svg
82+
[2]: ../assets/edge.svg
83+
[3]: ../assets/firefox.svg
84+
[4]: ../assets/safari.svg
85+
[5]: ../assets/opera.svg

docs/tags/head.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -105,4 +105,11 @@ HTML tutorial: [HTML Head](../tutorial/head.md)
105105
head {
106106
display: none;
107107
}
108-
```
108+
```
109+
110+
111+
[1]: ../assets/chrome.svg
112+
[2]: ../assets/edge.svg
113+
[3]: ../assets/firefox.svg
114+
[4]: ../assets/safari.svg
115+
[5]: ../assets/opera.svg

0 commit comments

Comments
 (0)