├── .github
    └── workflows
    │   └── wangdoc.yml
├── .gitignore
├── .travis.yml.bak
├── README.md
├── chapters.yml
├── deploy.sh
├── docs
    ├── a.md
    ├── attribute.md
    ├── elements.md
    ├── encode.md
    ├── form.md
    ├── iframe.md
    ├── image.md
    ├── intro.md
    ├── link.md
    ├── list.md
    ├── mobile.md
    ├── multimedia.md
    ├── script.md
    ├── semantic.md
    ├── table.md
    ├── text.md
    └── url.md
├── loppo.yml
├── package.json
└── wangdoc-deploy-rsa.enc


/.github/workflows/wangdoc.yml:
--------------------------------------------------------------------------------
 1 | name: HTML tutorial CI
 2 | on:
 3 |   push:
 4 |     branches:
 5 |       - master
 6 | 
 7 | jobs:
 8 |   page-generator:
 9 |     name: Generating pages
10 |     runs-on: ubuntu-latest
11 |     steps:
12 |       - name: Checkout
13 |         uses: actions/checkout@v2
14 |         with:
15 |           persist-credentials: false
16 |       - name: Setup Node.js
17 |         uses: actions/setup-node@main
18 |         with:
19 |           node-version: '14'
20 |       - name: Install dependencies
21 |         run: npm install
22 |       - name: Build pages
23 |         run: npm run build
24 |       - name: Deploy to website
25 |         uses: JamesIves/github-pages-deploy-action@3.7.1
26 |         with:
27 |           GIT_CONFIG_NAME: wangdoc-bot
28 |           GIT_CONFIG_EMAIL: yifeng.ruan@gmail.com
29 |           REPOSITORY_NAME: wangdoc/website
30 |           ACCESS_TOKEN: ${{ secrets.WANGDOC_BOT_TOKEN }}
31 |           BASE_BRANCH: master
32 |           BRANCH: master # The branch the action should deploy to.
33 |           FOLDER: dist # The folder the action should deploy.
34 |           TARGET_FOLDER: dist/html
35 |           CLEAN: true # Automatically remove deleted files from the deploy branch
36 |           COMMIT_MESSAGE: update from HTML tutorial
37 | 
38 | 


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | node_modules/
2 | dist/
3 | package-lock.json
4 | pnpm-lock.yaml
5 | 


--------------------------------------------------------------------------------
/.travis.yml.bak:
--------------------------------------------------------------------------------
 1 | language: node_js
 2 | node_js:
 3 | - 'node'
 4 | 
 5 | branches:
 6 |   only:
 7 |   - master
 8 | 
 9 | install:
10 | - npm ci
11 | # keep the npm cache around to speed up installs
12 | cache:
13 |   directories:
14 |   - "$HOME/.npm"
15 | 
16 | script: bash ./deploy.sh
17 | env:
18 |   global:
19 |   - ENCRYPTION_LABEL: fcf2c626dda7
20 |   - COMMIT_AUTHOR_EMAIL: yifeng.ruan@gmail.com
21 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | HTML 语言是互联网开发的基础。
2 | 
3 | 本教程完整介绍 HTML 语言的所有内容，既可以当作初学者的入门教程，也可以用作参考手册查阅语法。
4 | 


--------------------------------------------------------------------------------
/chapters.yml:
--------------------------------------------------------------------------------
 1 | - intro.md: HTML 简介
 2 | - url.md: URL 简介
 3 | - attribute.md: 元素的属性
 4 | - encode.md: 字符编码
 5 | - semantic.md: 语义结构
 6 | - text.md: 文本标签
 7 | - list.md: 列表标签
 8 | - image.md: 图像标签
 9 | - a.md: <a>
10 | - link.md: <link>
11 | - script.md: <script>，<noscript>
12 | - multimedia.md: 多媒体标签
13 | - iframe.md: iframe
14 | - table.md: 表格
15 | - form.md: 表单
16 | - elements.md: 其他标签
17 | 


--------------------------------------------------------------------------------
/deploy.sh:
--------------------------------------------------------------------------------
 1 | #!/bin/bash
 2 | set -e # Exit with nonzero exit code if anything fails
 3 | 
 4 | # Get the deploy key by using Travis's stored variables to decrypt deploy_key.enc
 5 | ENCRYPTED_KEY_VAR="encrypted_${ENCRYPTION_LABEL}_key"
 6 | ENCRYPTED_IV_VAR="encrypted_${ENCRYPTION_LABEL}_iv"
 7 | ENCRYPTED_KEY=${!ENCRYPTED_KEY_VAR}
 8 | ENCRYPTED_IV=${!ENCRYPTED_IV_VAR}
 9 | openssl aes-256-cbc -K $ENCRYPTED_KEY -iv $ENCRYPTED_IV -in wangdoc-deploy-rsa.enc -out wangdoc-deploy-rsa -d
10 | chmod 600 wangdoc-deploy-rsa
11 | eval `ssh-agent -s`
12 | ssh-add wangdoc-deploy-rsa
13 | 
14 | # Now that we're all set up, we can push.
15 | # git push $SSH_REPO $TARGET_BRANCH
16 | npm run build-and-commit
17 | 


--------------------------------------------------------------------------------
/docs/a.md:
--------------------------------------------------------------------------------
  1 | # <a>
  2 | 
  3 | ## 简介
  4 | 
  5 | 链接（hyperlink）是互联网的核心。它允许用户在页面上，从一个网址跳转到另一个网址，从而把所有资源联系在一起。
  6 | 
  7 | `<a>`标签就代表一个可以跳转的链接。它不仅可以跳转到其他页面，也可以跳转到文本、图像、文件等资源，甚至当前页面的某个位置。可以这样说，所有互联网上的资源，都可以通过`<a>`访问。
  8 | 
  9 | 下面就是一个典型的链接。
 10 | 
 11 | ```html
 12 | <a href="https://wikipedia.org/">维基百科</a>
 13 | ```
 14 | 
 15 | 上面代码就定义了一个超级链接。浏览器显示“维基百科”，文字下面默认会有下划线，表示这是一个链接。用户点击后，浏览器跳转到`href`属性指定的网址。
 16 | 
 17 | `<a>`标签内部不仅可以放置文字，也可以放置其他元素，比如段落、图像、多媒体等等。
 18 | 
 19 | ```html
 20 | <a href="https://www.example.com/">
 21 |   <img src="https://www.example.com/foo.jpg">
 22 | </a>
 23 | ```
 24 | 
 25 | 上面代码中，`<a>`标签内部就是一个图像。用户点击图像，就会跳转到指定网址。
 26 | 
 27 | ## 属性
 28 | 
 29 | `<a>`标签有如下属性。
 30 | 
 31 | ### href
 32 | 
 33 | `href`属性给出链接指向的网址。它的值应该是一个 URL 或者锚点。
 34 | 
 35 | 上文已经给出了完整 URL 的例子，下面是锚点的例子。
 36 | 
 37 | ```html
 38 | <a href="#demo">示例</a>
 39 | ```
 40 | 
 41 | 上面代码中，`href`属性的值是`#`加上锚点名称。点击后，浏览器会自动滚动，停在当前页面里面`demo`锚点所在的位置。
 42 | 
 43 | ### hreflang
 44 | 
 45 | `hreflang`属性给出链接指向的网址所使用的语言，纯粹是提示性的，没有实际功能，主要供搜索引擎使用。
 46 | 
 47 | ```html
 48 | <a
 49 |   href="https://www.example.com"
 50 |   hreflang="en"
 51 | >示例网址</a>
 52 | ```
 53 | 
 54 | 上面代码表明，`href`属性指向的网址的语言是英语。
 55 | 
 56 | 如果某个资源有多种语言的不同版本，可以将`hreflang`设为`x-default`，表示哪一个链接是默认版本。
 57 | 
 58 | ```html
 59 | <a href="https://example.com" hreflang="x-default">English</a>
 60 | <a href="https://example.com/de" hreflang="de">German</a>
 61 | ```
 62 | 
 63 | 上面示例中，`hreflang`设为`x-defalut`表示该链接为默认版本。
 64 | 
 65 | `hreflang`属性所用的语言代码，跟通用的`lang`属性一样，可以参考《属性》一章的`lang`属性的介绍。
 66 | 
 67 | ### title
 68 | 
 69 | `title`属性给出链接的说明信息。鼠标悬停在链接上方时，浏览器会将这个属性的值，以提示块的形式显示出来。
 70 | 
 71 | ```html
 72 | <a
 73 |   href="https://www.example.com/"
 74 |   title="hello"
 75 | >示例</a>。
 76 | ```
 77 | 
 78 | 上面代码中，用户鼠标停留在链接上面，会出现文字提示`hello`。
 79 | 
 80 | ### target
 81 | 
 82 | `target`属性指定如何展示打开的链接。它可以是在指定的窗口打开，也可以在`<iframe>`里面打开。
 83 | 
 84 | ```html
 85 | <p><a href="http://foo.com" target="test">foo</a></p>
 86 | <p><a href="http://bar.com" target="test">bar</a></p>
 87 | ```
 88 | 
 89 | 上面代码中，两个链接都在名叫`test`的窗口打开。首先点击链接`foo`，浏览器发现没有叫做`test`的窗口，就新建一个窗口，起名为`test`，在该窗口打开`foo.com`。然后，用户又点击链接`bar`，由于已经存在`test`窗口，浏览器就在该窗口打开`bar.com`，取代里面已经打开的`foo.com`。
 90 | 
 91 | `target`属性的值也可以是以下四个关键字之一。
 92 | 
 93 | - `_self`：当前窗口打开，这是默认值。
 94 | - `_blank`：新窗口打开。
 95 | - `_parent`：上层窗口打开，这通常用于从父窗口打开的子窗口，或者`<iframe>`里面的链接。如果当前窗口没有上层窗口，这个值等同于`_self`。
 96 | - `_top`：顶层窗口打开。如果当前窗口就是顶层窗口，这个值等同于`_self`。
 97 | 
 98 | ```html
 99 | <a
100 |   href="https://www.example.com"
101 |   target="_blank"
102 | >示例链接</a>
103 | ```
104 | 
105 | 上面代码点击后，浏览器会新建一个窗口，在该窗口打开链接，并且新窗口没有名字。
106 | 
107 | 注意，使用`target`属性的时候，最好跟`rel="noreferrer"`一起使用，这样可以避免安全风险。
108 | 
109 | ### rel
110 | 
111 | `rel`属性说明链接与当前页面的关系。
112 | 
113 | ```html
114 | <a href="help.html" rel="help">帮助</a>
115 | ```
116 | 
117 | 上面代码的`rel`属性，说明链接是当前页面的帮助文档。
118 | 
119 | 下面是一些常见的`rel`属性的值。
120 | 
121 | - `alternate`：当前文档的另一种形式，比如翻译。
122 | - `author`：作者链接。
123 | - `bookmark`：用作书签的永久地址。
124 | - `external`：当前文档的外部参考文档。
125 | - `help`：帮助链接。
126 | - `license`：许可证链接。
127 | - `next`：系列文档的下一篇。
128 | - `nofollow`：告诉搜索引擎忽略该链接，主要用于用户提交的内容，防止有人企图通过添加链接，提高该链接的搜索排名。
129 | - `noreferrer`：告诉浏览器打开链接时，不要将当前网址作为 HTTP 头信息的`Referer`字段发送出去，这样可以隐藏点击的来源。
130 | - `noopener`：告诉浏览器打开链接时，不让链接窗口通过 JavaScript 的`window.opener`属性引用原始窗口，这样就提高了安全性。
131 | - `prev`：系列文档的上一篇。
132 | - `search`：文档的搜索链接。
133 | - `tag`：文档的标签链接。
134 | 
135 | ### referrerpolicy
136 | 
137 | `referrerpolicy`属性用于精确设定点击链接时，浏览器发送 HTTP 头信息的`Referer`字段的行为。
138 | 
139 | 该属性可以取下面八个值：`no-referrer`、`no-referrer-when-downgrade`、`origin`、`origin-when-cross-origin`、`unsafe-url`、`same-origin`、`strict-origin`、`strict-origin-when-cross-origin`。
140 | 
141 | 其中，`no-referrer`表示不发送`Referer`字段，`same-origin`表示同源时才发送`Referer`字段，`origin`表示只发送源信息（协议+域名+端口）。其他几项的解释，请查阅 HTTP 文档。
142 | 
143 | ### ping
144 | 
145 | `ping`属性指定一个网址，用户点击的时候，会向该网址发出一个 POST 请求，通常用于跟踪用户的行为。
146 | 
147 | ```html
148 | <a href="http://localhost:3000/other" ping="http://localhost:3000/log">
149 |   Go to Other Page
150 | </a>
151 | ```
152 | 
153 | 上面示例中，用户点击链接时，除了发生跳转，还会向`http://localhost:3000/log`发送一个 POST 请求。服务端收到这个请求以后，就会知道用户点击了这个链接。
154 | 
155 | 这个请求的 HTTP 标头，包含了`ping-from`属性（点击行为发生的页面）和`ping-to`属性（`href`属性所指向的页面）。
156 | 
157 | ```http
158 | headers: {
159 |   'ping-from': 'http://localhost:3000/',
160 |   'ping-to': 'http://localhost:3000/other'
161 |   'content-type': 'text/ping'
162 |   // ...other headers
163 | },
164 | ```
165 | 
166 | 注意，`ping`属性只对链接有效，对其他的交互行为无效，比如按钮点击或表单提交。另外，Firefox 浏览器不支持该属性。并且，也无法让它发送任何的自定义数据。
167 | 
168 | ### type
169 | 
170 | `type`属性给出链接 URL 的 MIME 类型，比如到底是网页，还是图像或文件。它也是纯粹提示性的属性，没有实际功能。
171 | 
172 | ```html
173 | <a
174 |   href="smile.jpg"
175 |   type="image/jpeg"
176 | >示例图片</a>
177 | ```
178 | 
179 | 上面代码中，`type`属性提示这是一张图片。
180 | 
181 | ### download
182 | 
183 | `download`属性表明当前链接用于下载，而不是跳转到另一个 URL。
184 | 
185 | ```html
186 | <a href="demo.txt" download>下载</a>
187 | ```
188 | 
189 | 上面代码点击后，会出现下载对话框。
190 | 
191 | 注意，`download`属性只在链接与网址同源时，才会生效。也就是说，链接应该与网址属于同一个网站。
192 | 
193 | 如果`download`属性设置了值，那么这个值就是下载的文件名。
194 | 
195 | ```html
196 | <a
197 |   href="foo.exe"
198 |   download="bar.exe"
199 | >点击下载</a>
200 | ```
201 | 
202 | 上面代码中，下载文件的原始文件名是`foo.exe`。点击后，下载对话框提示的文件名是`bar.exe`。
203 | 
204 | 注意，如果链接点击后，服务器的 HTTP 回应的头信息设置了`Content-Disposition`字段，并且该字段的值与`download`属性不一致，那么该字段优先，下载时将显示其设置的文件名。
205 | 
206 | `download`属性还有一个用途，就是有些地址不是真实网址，而是数据网址，比如`data:`开头的网址。这时，`download`属性可以为虚拟网址指定下载的文件名。
207 | 
208 | ```html
209 | <a href="data:,Hello%2C%20World!">点击</a>
210 | ```
211 | 
212 | 上面链接点击后，会打开一个虚拟网页，上面显示`Hello World!`。
213 | 
214 | 
215 | ```html
216 | <a
217 |   href="data:,Hello%2C%20World!"
218 |   download="hello.txt"
219 | >点击</a>
220 | ```
221 | 
222 | 上面链接点击后，下载的`hello.txt`文件内容就是“Hello, World!”。
223 | 
224 | ## 邮件链接
225 | 
226 | 链接也可以指向一个邮件地址，使用`mailto`协议。用户点击后，浏览器会打开本机默认的邮件程序，让用户向指定的地址发送邮件。
227 | 
228 | ```html
229 | <a href="mailto:contact@example.com">联系我们</a>
230 | ```
231 | 
232 | 上面代码中，链接就指向邮件地址。点击后，浏览器会打开一个邮件地址，让你可以向`contact@example.com`发送邮件。
233 | 
234 | 除了邮箱，邮件协议还允许指定其他几个邮件要素。
235 | 
236 | - `subject`：主题
237 | - `cc`：抄送
238 | - `bcc`：密送
239 | - `body`：邮件内容
240 | 
241 | 使用方法是将这些邮件要素，以查询字符串的方式，附加在邮箱地址后面。
242 | 
243 | ```html
244 | <a
245 |   href="mailto:foo@bar.com?cc=test@test.com&subject=The%20subject&body=The%20body"
246 | >发送邮件</a>
247 | ```
248 | 
249 | 上面代码中，邮件链接里面不仅包含了邮箱地址，还包含了`cc`、`subject`、`body`等邮件要素。这些要素的值需要经过 URL 转义，比如空格转成`%20`。
250 | 
251 | 不指定邮箱也是允许的，就像下面这样。这时用户自己在邮件程序里面，填写想要发送的邮箱，通常用于邮件分享网页。
252 | 
253 | ```html
254 | <a href="mailto:">告诉朋友</a>
255 | ```
256 | 
257 | ## 电话链接
258 | 
259 | 如果是手机浏览的页面，还可以使用`tel`协议，创建电话链接。用户点击该链接，会唤起电话，可以进行拨号。
260 | 
261 | ```html
262 | <a href="tel:13312345678">13312345678</a>
263 | ```
264 | 
265 | 上面代码在手机中，点击链接会唤起拨号界面，可以直接拨打指定号码。
266 | 
267 | 


--------------------------------------------------------------------------------
/docs/attribute.md:
--------------------------------------------------------------------------------
  1 | # 网页元素的属性
  2 | 
  3 | ## 简介
  4 | 
  5 | 网页元素的属性（attribute）可以定制元素的行为，不同的属性会导致元素有不同的行为。元素属性的写法是 HTML 标签内部的“键值对”。
  6 | 
  7 | ```html
  8 | <html lang="en">
  9 | ```
 10 | 
 11 | 上面代码中，`<html>`标签内部的键值对`lang="en"`，就称为`html`元素的属性。属性名为`lang`，属性值为`en`。
 12 | 
 13 | 属性名与标签名一样，不区分大小写，`lang`和`LANG`是同一个属性。
 14 | 
 15 | 属性名与属性值之间，通过等号`=`连接。属性值可以放在单引号或双引号之中，建议统一使用双引号。某些属性值可以不使用引号，但是建议不要这样写。
 16 | 
 17 | 有些属性是布尔属性，即属性值是一个布尔值，只有“打开”和“关闭”两种情况。这时属性值可以省略，只要添加了属性名，就表示打开该属性。
 18 | 
 19 | ```html
 20 | <input type="text" required>
 21 | ```
 22 | 
 23 | 上面代码中，`required`就是`<input>`标签的布尔属性。如果加上这个属性，就表示打开，没有就是关闭。
 24 | 
 25 | ## 全局属性
 26 | 
 27 | 全局属性（global attributes）是所有元素都可以使用的属性。也就是说，你可以把下面的属性，加在任意一个网页元素上面，不过有些属性对某些元素可能不产生意义。
 28 | 
 29 | 下面是一些常见的全局属性。
 30 | 
 31 | ### id
 32 | 
 33 | `id`属性是元素在网页内的唯一标识符。比如，网页可能包含多个`<p>`标签，`id`属性可以指定每个`<p>`标签的唯一标识符。
 34 | 
 35 | ```html
 36 | <p id="p1"></p>
 37 | <p id="p2"></p>
 38 | <p id="p3"></p>
 39 | ```
 40 | 
 41 | 上面代码中，三个`<p>`标签具有不同的`id`属性，因此可以区分。
 42 | 
 43 | `id`属性的值必须是全局唯一的，同一个页面不能有两个相同的`id`属性。另外，`id`属性的值不得包含空格。
 44 | 
 45 | `id`属性的值还可以在最前面加上`#`，放到 URL 中作为锚点，定位到该元素在网页内部的位置。比如，用户访问网址`https://foo.com/index.html#bar`的时候，浏览器会自动将页面滚动到`bar`的位置，让用户第一眼就看到这部分内容。
 46 | 
 47 | ### class
 48 | 
 49 | `class`属性用来对网页元素进行分类。如果不同元素的`class`属性值相同，就表示它们是一类的。
 50 | 
 51 | ```html
 52 | <p class="para"></p>
 53 | <p></p>
 54 | <p class="para"></p>
 55 | ```
 56 | 
 57 | 上面代码中，第一个`<p>`和第三个`<p>`是一类，因为它们的`class`属性相同。
 58 | 
 59 | 元素可以同时具有多个 class，它们之间使用空格分隔。
 60 | 
 61 | ```html
 62 | <p class="p1 p2 p3"></p>
 63 | ```
 64 | 
 65 | 上面的`p`元素同时具有`p1`、`p2`、`p3`三个 class。
 66 | 
 67 | ### title
 68 | 
 69 | `title`属性用来为元素添加附加说明。大多数浏览器中，鼠标悬浮在元素上面时，会将`title`属性值作为浮动提示，显示出来。
 70 | 
 71 | ```html
 72 | <div title="版权说明">
 73 |   <p>本站内容使用创意共享许可证，可以自由使用。</p>
 74 | </div>
 75 | ```
 76 | 
 77 | 上面代码中，`title`属性解释了这一块内容的目的。鼠标悬停在上面时，浏览器会显示一个浮动提示。一旦鼠标移开，提示就会消失。
 78 | 
 79 | ### tabindex
 80 | 
 81 | 网页通常使用鼠标操作，但是某些情况下，用户可能希望使用键盘，或者只有键盘可以用。因此，浏览器允许使用 Tab 键，遍历网页元素。也就是说，只要不停按下 Tab 键，网页的焦点就会从一个元素转移到另一个元素，选定焦点元素以后，就可以进行下一步操作，比如按下回车键访问某个链接，或者直接在某个输入框输入文字。
 82 | 
 83 | 这里就有一个问题，按下 Tab 键的时候，浏览器怎么知道跳到哪一个元素。HTML 提供了`tabindex`属性，解决这个问题。它的名字的含义，就是 Tab 的顺序（index）。
 84 | 
 85 | `tabindex`属性的值是一个整数，表示用户按下 Tab 键的时候，网页焦点转移的顺序。不同的属性值有不同的含义。
 86 | 
 87 | - 负整数：该元素可以获得焦点（比如使用 JavaScript 的`focus()`方法），但不参与 Tab 键对网页元素的遍历。这个值通常是`-1`。
 88 | - `0`：该元素参与 Tab 键的遍历，顺序由浏览器指定，通常是按照其在网页里面出现的位置。
 89 | - 正整数：网页元素按照从小到大的顺序（1、2、3、……），参与 Tab 键的遍历。如果多个元素的`tabindex`属性相同，则按照在网页源码里面出现的顺序遍历。
 90 | 
 91 | ```html
 92 | <p tabindex="0">这段文字可以获得焦点。</p>
 93 | ```
 94 | 
 95 | 上面代码中，`<p>`标签的`tabindex`为`0`，意味着该元素可以获得焦点，并且也可以被 Tab 键遍历，顺序由其在源码里面的位置决定。
 96 | 
 97 | 一般来说，`tabindex`属性最好都设成`0`，按照自然顺序进行遍历，这样比较符合用户的预期，除非网页有特殊布局。如果网页所有元素都没有设置`tabindex`，那么只有那些默认可以遍历的元素（比如链接、输入框等）才能参与 Tab 键的遍历，顺序由其在源码的位置决定。因此实际上，只有那些无法获得焦点的元素（比如`<span>`、`<div>`）需要参与遍历，才有必要设置`tabindex`属性。
 98 | 
 99 | ### accesskey
100 | 
101 | `accesskey`属性指定网页元素获得焦点的快捷键，该属性的值必须是单个的可打印字符。只要按下快捷键，该元素就会得到焦点。
102 | 
103 | ```html
104 | <button accesskey="s">提交</button>
105 | ```
106 | 
107 | 上面代码中，`<button>`的快捷键是`s`，按下快捷键，该元素就得到了焦点。
108 | 
109 | `accesskey`属性的字符键，必须配合功能键，一起按下才会生效。也就是说，快捷键是“功能键 + 字符键”的组合。不同的浏览器与不同的操作系统，功能键都不一样。比如，Chrome 浏览器在 Windows 系统和 Linux 系统的快捷键是`Alt + 字符键`，在 Mac 系统的快捷键是`Ctrl + Alt + 字符键`。
110 | 
111 | 注意，`accesskey`如果跟操作系统或浏览器级别的快捷键有冲突，这时不会生效。
112 | 
113 | ### style
114 | 
115 | `style`属性用来指定当前元素的 CSS 样式。具体的设置，请看 CSS 教程。
116 | 
117 | ```html
118 | <p style="color: red;">hello</p>
119 | ```
120 | 
121 | 上面代码指定文字颜色为红色。
122 | 
123 | ### hidden
124 | 
125 | `hidden`是一个布尔属性，表示当前的网页元素不再跟页面相关，因此浏览器不会渲染这个元素，所以就不会在网页中看到它。
126 | 
127 | ```html
128 | <p hidden>本句不会显示在页面上。</p>
129 | ```
130 | 
131 | 上面代码中，这个`p`元素不会出现在网页上。
132 | 
133 | 注意，CSS 的可见性设置，高于`hidden`属性。如果 CSS 设为该元素可见，`hidden`属性将无效。
134 | 
135 | ### lang，dir
136 | 
137 | `lang`属性指定网页元素使用的语言。
138 | 
139 | ```html
140 | <p lang="en">hello</p>
141 | <p lang="zh">你好</p>
142 | ```
143 | 
144 | 上面代码中，第一个`<p>`的`lang`属性，表示使用英语，第二个`<p>`的`lang`属性，表示使用中文。
145 | 
146 | `lang`属性的值，必须符合 [BCP47](https://www.ietf.org/rfc/bcp/bcp47.txt) 的标准。下面是一些常见的语言代码。
147 | 
148 | - zh：中文
149 | - zh-Hans：简体中文
150 | - zh-Hant：繁体中文
151 | - en：英语
152 | - en-US：美国英语
153 | - en-GB：英国英语
154 | - es：西班牙语
155 | - fr：法语
156 | 
157 | `dir`属性表示文字的阅读方向，有三个可能的值。
158 | 
159 | - `ltr`：从左到右阅读，比如英语。
160 | - `rtl`：从右到左阅读，阿拉伯语、波斯语、希伯来语都属于这一类。
161 | - `auto`：浏览器根据内容的解析结果，自行决定。
162 | 
163 | ### translate
164 | 
165 | `translate`属性只用于文本元素，用来指示翻译软件，不翻译该文本。
166 | 
167 | ```html
168 | <p>
169 |   <span translate="no">Wien<span>
170 |   named world's most liveable city (again)!
171 | </p>
172 | ```
173 | 
174 | 上面示例中，`translate="no"`用来告诉翻译软件，不要翻译`<span>`元素内的文本。
175 | 
176 | 如果`translate`设为`yes`，就告诉翻译软件应该翻译该文本。
177 | 
178 | ### contenteditable
179 | 
180 | HTML 网页的内容默认是用户不能编辑，`contenteditable`属性允许用户修改内容。它有两个可能的值。
181 | 
182 | - `true`或空字符串：内容可以编辑
183 | - `false`：不可以编辑
184 | 
185 | ```html
186 | <p contenteditable="true">
187 | 鼠标点击，本句内容可修改。
188 | </p>
189 | ```
190 | 
191 | 上面代码中，鼠标单击句子，就可以进入编辑状态，用户可以改变句子的内容。当然，除非提交到服务器，否则刷新页面还是显示原来的内容。
192 | 
193 | 该属性是枚举属性，不是布尔属性，规范的写法是最好带上属性值。
194 | 
195 | ### spellcheck
196 | 
197 | 浏览器一般会自带拼写检查功能，编辑内容时，拼错的单词下面会显示红色的波浪线。`spellcheck`属性就表示，是否打开拼写检查。
198 | 
199 | 它有两个可能的值。
200 | 
201 | - `true`：打开拼写检查
202 | - `false`：关闭拼写检查
203 | 
204 | ```html
205 | <p contenteditable="true" spellcheck="true">
206 | 英语单词 separate 容易写错成 seperate。
207 | </p>
208 | ```
209 | 
210 | 上面代码中，`seperate`下面会有提示，表示拼错了。
211 | 
212 | 注意，由于该属性只在编辑时生效，所以这个例子必须加上`contenteditable`属性，表示本段内容可编辑。鼠标单击就可以进入编辑状态，这时才会看到拼写提示。不可编辑的状态下，拼写错误是不提示显示的。对于那些不可编辑的元素，该属性无效。
213 | 
214 | 这个属性看上去像布尔属性，但是其实是枚举属性，所以最好不要省略它的值。如果没有指定这个属性，浏览器将自行决定是否打开拼写检查。
215 | 
216 | ### `data-`属性
217 | 
218 | `data-`属性用于放置自定义数据。如果没有其他属性或元素合适放置数据，就可以放在`data-`属性。
219 | 
220 | ```html
221 | <a href="#" class="tooltip" data-tip="this is the tip!">链接</a>
222 | ```
223 | 
224 | 上面代码中，`data-tip`用于放置链接的提示文字。
225 | 
226 | 由于`data-`属性只能通过 CSS 或 JavaScript 利用，所以这里不做详细介绍了。下面是 CSS 的例子。
227 | 
228 | ```css
229 | /* HTML 代码如下
230 | <div data-role="mobile">
231 | Mobile only content
232 | </div>
233 | */
234 | div[data-role="mobile"] {
235 |   display:none;
236 | }
237 | 
238 | /* HTML 代码如下
239 | <div class="test" data-content="This is the div content">test</div>​
240 | */
241 | .test {
242 |   display: inline-block;
243 | }
244 | .test:after {
245 |   content: attr(data-content);
246 | }
247 | ```
248 | 
249 | ### 事件处理属性
250 | 
251 | 除了上面这些属性，全局属性还包括事件处理属性（event handler），用来响应用户的动作。这些属性的值都是 JavaScript 代码，请参考 JavaScript 教程，这里只列出这些属性的名单。
252 | 
253 | > onabort, onautocomplete, onautocompleteerror, onblur, oncancel, oncanplay, oncanplaythrough, onchange, onclick, onclose, oncontextmenu, oncuechange, ondblclick, ondrag, ondragend, ondragenter, ondragexit, ondragleave, ondragover, ondragstart, ondrop, ondurationchange, onemptied, onended, onerror, onfocus, oninput, oninvalid, onkeydown, onkeypress, onkeyup, onload, onloadeddata, onloadedmetadata, onloadstart, onmousedown, onmouseenter, onmouseleave, onmousemove, onmouseout, onmouseover, onmouseup, onmousewheel, onpause, onplay, onplaying, onprogress, onratechange, onreset, onresize, onscroll, onseeked, onseeking, onselect, onshow, onsort, onstalled, onsubmit, onsuspend, ontimeupdate, ontoggle, onvolumechange, onwaiting
254 | 
255 | 


--------------------------------------------------------------------------------
/docs/elements.md:
--------------------------------------------------------------------------------
  1 | # 其他标签
  2 | 
  3 | 本章介绍一些最新引入标准的标签。
  4 | 
  5 | ## `<dialog>`
  6 | 
  7 | ### 基本用法
  8 | 
  9 | `<dialog>`标签表示一个可以关闭的对话框。
 10 | 
 11 | ```html
 12 | <dialog>
 13 |   Hello world
 14 | </dialog>
 15 | ```
 16 | 
 17 | 上面就是一个最简单的对话框。
 18 | 
 19 | 默认情况下，对话框是隐藏的，不会在网页上显示。如果要让对话框显示，必须加上`open`属性。
 20 | 
 21 | ```html
 22 | <dialog open>
 23 |   Hello world
 24 | </dialog>
 25 | ```
 26 | 
 27 | 上面代码会在网页显示一个方框，内容是`Hello world`。
 28 | 
 29 | `<dialog>`元素里面，可以放入其他 HTML 元素。
 30 | 
 31 | ```html
 32 | <dialog open>
 33 |   <form method="dialog">
 34 |     <input type="text">
 35 |     <button type="submit" value="foo">提交</button>
 36 |   </form>
 37 | </dialog>
 38 | ```
 39 | 
 40 | 上面的对话框里面，有一个输入框和提交按钮。
 41 | 
 42 | 注意，上例中`<form>`的`method`属性设为`dialog`，这时点击提交按钮，对话框就会消失。但是，表单不会提交到服务器，浏览器会将表单元素的`returnValue`属性设为 Submit 按钮的`value`属性（上例是`foo`）。
 43 | 
 44 | ### JavaScript API
 45 | 
 46 | `<dialog>`元素的 JavaScript API 提供`Dialog.showModal()`和`Dialog.close()`两个方法，用于打开/关闭对话框。
 47 | 
 48 | ```javascript
 49 | const modal = document.querySelector('dialog');
 50 | 
 51 | // 对话框显示，相当于增加 open 属性
 52 | modal.showModal();
 53 | 
 54 | // 对话框关闭，相当于移除 open 属性
 55 | modal.close();
 56 | ```
 57 | 
 58 | 开发者可以提供关闭按钮，让其调用`Dialog.close()`方法，关闭对话框。
 59 | 
 60 | `Dialog.close()`方法可以接受一个字符串作为参数，用于传递信息。`<dialog>`接口的`returnValue`属性可以读取这个字符串，否则`returnValue`属性等于提交按钮的`value`属性。
 61 | 
 62 | ```javascript
 63 | modal.close('Accepted');
 64 | modal.returnValue // "Accepted"
 65 | ```
 66 | 
 67 | `Dialog.showModal()`方法唤起对话框时，会有一个透明层，阻止用户与对话框外部的内容互动。CSS 提供了一个 Dialog 元素的`::backdrop`伪类，用于选中这个透明层，因此可以编写样式让透明层变得可见。
 68 | 
 69 | ```css
 70 | dialog {
 71 |   padding: 0;
 72 |   border: 0;
 73 |   border-radius: 0.6rem;
 74 |   box-shadow: 0 0 1em black;
 75 | }
 76 | 
 77 | dialog::backdrop {
 78 |   /* make the backdrop a semi-transparent black */
 79 |   background-color: rgba(0, 0, 0, 0.4);
 80 | }
 81 | ```
 82 | 
 83 | 上面代码不仅为`<dialog>`指定了样式，还将对话框的透明层变成了灰色透明。
 84 | 
 85 | `<dialog>`元素还有一个`Dialog.show()`方法，也能唤起对话框，但是没有透明层，用户可以与对话框外部的内容互动。
 86 | 
 87 | ### 事件
 88 | 
 89 | `<dialog>`元素有两个事件，可以监听。
 90 | 
 91 | - `close`：对话框关闭时触发
 92 | - `cancel`：用户按下`esc`键关闭对话框时触发
 93 | 
 94 | 如果希望用户点击透明层，就关闭对话框，可以用下面的代码。
 95 | 
 96 | ```javascript
 97 | modal.addEventListener('click', (event) => {
 98 |   if (event.target === modal) {
 99 |     modal.close('cancelled');
100 |   }
101 | });
102 | ```
103 | 
104 | ## `<details>`，`<summary>`
105 | 
106 | ### 基本用法
107 | 
108 | `<details>`标签用来折叠内容，浏览器会折叠显示该标签的内容。
109 | 
110 | ```html
111 | <details>
112 | 这是一段解释文本。
113 | </details>
114 | ```
115 | 
116 | 上面的代码在浏览器里面，会折叠起来，显示`Details`，前面有一个三角形，就像下面这样。
117 | 
118 | ```html
119 | ▶ Details
120 | ```
121 | 
122 | 用户点击这段文本，折叠的文本就会展开，显示详细内容。
123 | 
124 | ```html
125 | ▼ Details
126 | 这是一段解释文本。
127 | ```
128 | 
129 | 再点击一下，展开的文本又会重新折叠起来。
130 | 
131 | `<details>`标签的`open`属性，用于默认打开折叠。
132 | 
133 | ```html
134 | <details open>
135 | 这是一段解释文本。
136 | </details>
137 | ```
138 | 
139 | 上面代码默认打开折叠。
140 | 
141 | `<summary>`标签用来定制折叠内容的标题。
142 | 
143 | ```html
144 | <details>
145 |   <summary>这是标题</summary>
146 |   这是一段解释文本。
147 | </details>
148 | ```
149 | 
150 | 上面的代码显示结果如下。
151 | 
152 | ```html
153 | ▶ 这是标题
154 | ```
155 | 
156 | 点击后，展示的效果如下。
157 | 
158 | ```html
159 | ▼ 这是标题
160 | 这是一段解释文本。
161 | ```
162 | 
163 | 通过 CSS 设置`summary::-webkit-details-marker`，可以改变标题前面的三角箭头。
164 | 
165 | ```css
166 | summary::-webkit-details-marker {
167 |   background: url(https://example.com/foo.svg);
168 |   color: transparent;
169 | }
170 | ```
171 | 
172 | 下面的样式是另一种替换箭头的方法。
173 | 
174 | ```css
175 | summary::-webkit-details-marker {
176 |   display: none;
177 | }
178 | summary:before {
179 |   content: "\2714";
180 |   color: #696f7c;
181 |   margin-right: 5px;
182 | }
183 | ```
184 | 
185 | 
186 | ### JavaScript API
187 | 
188 | `Details`元素的`open`属性返回`<details>`当前是打开还是关闭。
189 | 
190 | ```javascript
191 | const details = document.querySelector('details');
192 | 
193 | if (detail.open === true) {
194 |   // 展开状态
195 | } else {
196 |   // 折叠状态
197 | }
198 | ```
199 | 
200 | `Details`元素有一个`toggle`事件，打开或关闭折叠时，都会触发这个事件。
201 | 
202 | ```javascript
203 | details.addEventListener('toggle', event => {
204 |   if (details.open) {
205 |     /* 展开状况 */
206 |   } else {
207 |     /* 折叠状态 */
208 |   }
209 | });
210 | ```
211 | 
212 | ## 参考链接
213 | 
214 | - [Meet the New Dialog Element](https://keithjgrant.com/posts/2018/meet-the-new-dialog-element/), Keith J. Grant
215 | - [The dialog element: The way to create tomorrow’s modal windows](https://blog.logrocket.com/the-dialog-element-the-way-to-create-tomorrows-modal-windows-f1d4ab14380b), Abhishek Jakhar
216 | - [Details/Summary is the Easiest Way Ever to Make an Accordion](https://css-tricks.com/quick-reminder-that-details-summary-is-the-easiest-way-ever-to-make-an-accordion/), Chris Coyier
217 | 
218 | 


--------------------------------------------------------------------------------
/docs/encode.md:
--------------------------------------------------------------------------------
 1 | # HTML 字符编码
 2 | 
 3 | ## 简介
 4 | 
 5 | 网页包含了大量的文字，浏览器必须知道这些文字的编码方法，才能把文字还原出来。
 6 | 
 7 | 一般情况下，服务器向浏览器发送 HTML 网页文件时，会通过 HTTP 头信息，声明网页的编码方式。
 8 | 
 9 | ```http
10 | Content-Type: text/html; charset=UTF-8
11 | ```
12 | 
13 | 上面代码中，HTTP 头信息的`Content-Type`字段先声明，服务器发送的数据类型是`text/html`（即 HTML 网页），然后声明网页的文字编码是`UTF-8`。
14 | 
15 | 网页内部也会再用`<meta>`标签，再次声明网页的编码。
16 | 
17 | ```html
18 | <meta charset="UTF-8">
19 | ```
20 | 
21 | ## 字符的数字表示法
22 | 
23 | 网页可以使用不同语言的编码方式，但是最常用的编码是 UTF-8。UTF-8 编码是 Unicode 字符集的一种表达方式。这个字符集的设计目标是包含世界上的所有字符，目前已经收入了十多万个字符。
24 | 
25 | 每个字符有一个 Unicode 号码，称为码点（code point）。如果知道码点，就能查到这是什么字符。举例来说，英文字母`a`的码点是十进制的`97`（十六进制的`61`），汉字“中”的码点是十进制的`20013`（十六进制的`4e2d`）。
26 | 
27 | 由于下面的原因，不是每一个 Unicode 字符都能直接在 HTML 语言里面显示。
28 | 
29 | （1）不是每个 Unicode 字符都可以打印出来，有些没有可打印形式，比如换行符的码点是十进制的`10`（十六进制的`A`），就没有对应的字面形式。
30 | 
31 | （2）小于号（`<`）和大于号（`>`）用来定义 HTML 标签，其他需要用到这两个符号的场合，必须防止它们被解释成标签。
32 | 
33 | （3）由于 Unicode 字符太多，无法找到一种输入法，可以直接输入所有这些字符。换言之，没有一种键盘，有办法输入所有符号。
34 | 
35 | （4）网页不允许混合使用多种编码，如果使用 UTF-8 编码的同时，又想插入其他编码的字符，就会很困难。
36 | 
37 | HTML 为了解决上面这些问题，允许使用 Unicode 码点表示字符，浏览器会自动将码点转成对应的字符。
38 | 
39 | 字符的码点表示法是`&#N;`（十进制，`N`代表码点）或者`&#xN;`（十六进制，`N`代表码点），比如，字符`a`可以写成`&#97;`（十进制）或者`&#x61;`（十六进制），字符`中`可以写成`&#20013;`（十进制）或者`&#x4e2d;`（十六进制），浏览器会自动转换它们。
40 | 
41 | ```html
42 | <p>hello</p>
43 | <!-- 等同于 -->
44 | <p>&#104;&#101;&#108;&#108;&#111;</p>
45 | <!-- 等同于 -->
46 | <p>&#x68;&#x65;&#x6c;&#x6c;&#x6f;</p>
47 | ```
48 | 
49 | 上面代码中，字符可以直接表示，也可以使用十进制码点或十六进制码点表示。
50 | 
51 | 注意，HTML 标签本身不能使用码点表示，否则浏览器会认为这是所要显示的文本内容，而不是标签。比如，`<p>`一旦写成`<&#112;>`或者`&#60;&#112;&#62;`，浏览器就不再认为这是标签了，而会当作文本内容将其显示为`<p>`。
52 | 
53 | ## 字符的实体表示法
54 | 
55 | 数字表示法的不方便之处，在于必须知道每个字符的码点，很难记忆。为了能够快速输入，HTML 为一些特殊字符，规定了容易记忆的名字，允许通过名字来表示它们，这称为实体表示法（entity）。
56 | 
57 | 实体的写法是`&name;`，其中的`name`是字符的名字。下面是其中一些特殊字符，及其对应的实体。
58 | 
59 | - `<`：`&lt;`
60 | - `>`：`&gt;`
61 | - `"`：`&quot;`
62 | - `'`：`&apos;`
63 | - `&`：`&amp;`
64 | - `©`：`&copy;`
65 | - `#`：`&num;`
66 | - `§`：`&sect;`
67 | - `¥`：`&yen;`
68 | - `$`：`&dollar;`
69 | - `£`：`&pound;`
70 | - `¢`：`&cent;`
71 | - `%`：`&percnt;`
72 | - `*`：`$ast;`
73 | - `@`：`&commat;`
74 | - `^`：`&Hat;`
75 | - `±`：`&plusmn;`
76 | - 空格：`&nbsp;`
77 | 
78 | 注意，上面最后一个特殊字符是空格，它也有对应的实体表示法。
79 | 
80 | 字符的数字表示法和实体表示法，都可以表示正常情况无法输入的字符，逃脱了浏览器的限制，所以英语里面称为“escape”，中文翻译为“字符的转义”。
81 | 
82 | 


--------------------------------------------------------------------------------
/docs/form.md:
--------------------------------------------------------------------------------
  1 | # 表单标签
  2 | 
  3 | 表单（form）是用户输入信息与网页互动的一种形式。大多数情况下，用户提交的信息会发给服务器，比如网站的搜索栏就是表单。
  4 | 
  5 | 表单由一种或多种的小部件组成，比如输入框、按钮、单选框或复选框。这些小部件称为控件（controls）。
  6 | 
  7 | ## `<form>`
  8 | 
  9 | ### 简介
 10 | 
 11 | `<form>`标签用来定义一个表单，所有表单内容放到这个容器元素之中。
 12 | 
 13 | ```html
 14 | <form>
 15 |   <!-- 各种表单控件-->
 16 | </form>
 17 | ```
 18 | 
 19 | 上面代码就是表单的基本形式。
 20 | 
 21 | 下面是一个比较常见的例子。
 22 | 
 23 | ```html
 24 | <form action="https://example.com/api" method="post">
 25 |   <label for="POST-name">用户名：</label>
 26 |   <input id="POST-name" type="text" name="user">
 27 |   <input type="submit" value="提交">
 28 | </form>
 29 | ```
 30 | 
 31 | 上面代码就是一个表单，一共包含三个控件：一个`<label>`标签，一个文本输入框，一个提交按钮。其中，文本输入框的`name`属性是`user`，表示将向服务器发送一个键名为`user`的键值对，键值就是这个控件的`value`属性，等于用户输入的值。
 32 | 
 33 | 用户在文本输入框里面，输入用户名，比如`foobar`，然后点击提交按钮，浏览器就会向服务器`https://example.com/api`发送一个 POST 请求，发送`user=foobar`这样一段数据。
 34 | 
 35 | `<form>`有以下属性。
 36 | 
 37 | - `accept-charset`：服务器接受的字符编码列表，使用空格分隔，默认与网页编码相同。
 38 | - `action`：服务器接收数据的 URL。
 39 | - `autocomplete`：如果用户没有填写某个控件，浏览器是否可以自动填写该值。它的可能取值分别为`off`（不自动填写）和`on`（自动填写）。
 40 | - `method`：提交数据的 HTTP 方法，可能的值有`post`（表单数据作为 HTTP 数据体发送），`get`（表单数据作为 URL 的查询字符串发送），`dialog`（表单位于`<dialog>`内部使用）。
 41 | - `enctype`：当`method`属性等于`post`时，该属性指定提交给服务器的 MIME 类型。可能的值为`application/x-www-form-urlencoded`（默认值），`multipart/form-data`（文件上传的情况），`text/plain`。
 42 | - `name`：表单的名称，应该在网页中是唯一的。注意，如果一个控件没有设置`name`属性，那么这个控件的值就不会作为键值对，向服务器发送。
 43 | - `novalidate`：布尔属性，表单提交时是否取消验证。
 44 | - `target`：在哪个窗口展示服务器返回的数据，可能的值有`_self`（当前窗口），`_blank`（新建窗口），`_parent`（父窗口），`_top`（顶层窗口），`<iframe>`标签的`name`属性（即表单返回结果展示在`<iframe>`窗口）。
 45 | 
 46 | ### enctype 属性
 47 | 
 48 | `<form>`表单的`enctype`属性，指定了采用 POST 方法提交数据时，浏览器给出的数据的 MIME 类型。该属性可以取以下值。
 49 | 
 50 | （1）`application/x-www-form-urlencoded`
 51 | 
 52 | `application/x-www-form-urlencoded`是默认类型，控件名和控件值都要转义（空格转为`+`号，非数字和非字母转为`%HH`的形式，换行转为CR LF），控件名和控件值之间用`=`分隔。控件按照出现顺序排列，控件之间用`&`分隔。
 53 | 
 54 | （2）`multipart/form-data`
 55 | 
 56 | `multipart/form-data`主要用于文件上传。这个类型上传大文件时，会将文件分成多块传送，每一块的 HTTP 头信息都有`Content-Disposition`属性，值为`form-data`，以及一个`name`属性，值为控件名。
 57 | 
 58 | ```bash
 59 | Content-Disposition: form-data; name="mycontrol"
 60 | ```
 61 | 
 62 | 下面是上传文件的表单。
 63 | 
 64 | ```html
 65 | <form action="https://example.com/api"
 66 |       enctype="multipart/form-data"
 67 |       method="post">
 68 |   用户名：<input type="text" name="submit-name"><br>
 69 |   文件：<input type="file" name="files"><br>
 70 |   <input type="submit" value="上传"> <input type="reset" value="清除">
 71 | </form>
 72 | ```
 73 | 
 74 | 上面代码中，输入用户名`Larry`，选中一个`file1.txt`文件，然后点击“上传”。浏览器发送的实际数据如下。
 75 | 
 76 | ```http
 77 | Content-Type: multipart/form-data; boundary=--AaB03x
 78 | 
 79 | --AaB03x
 80 | Content-Disposition: form-data; name="submit-name"
 81 | 
 82 | Larry
 83 | --AaB03x
 84 | Content-Disposition: form-data; name="files"; filename="file1.txt"
 85 | Content-Type: text/plain
 86 | 
 87 | ... contents of file1.txt ...
 88 | --AaB03x--
 89 | ```
 90 | 
 91 | 上面代码中，浏览器将这个表单发成多个数据块。最上面使用`Content-Type`字段告诉服务器，数据格式是`multipart/form-data`（即多个数据块），每个数据块的分隔标志是`--AaB03x`。每个数据块的第一行是`Content-Disposition`，其中的`name`字段表示这个数据块的控件名，数据体则是该控件的数据值，比如第一个数据块的`name`属性是`submit-name`控件，数据体是该控件的值`Larry`。第二个数据块是控件`files`，由于该控件是上传文件，所以还要用`filename`属性给出文件名`file1.txt`，数据体是`file1.txt`的内容。
 92 | 
 93 | ## `<fieldset>`，`<legend>`
 94 | 
 95 | `<fieldset>`标签是一个块级容器标签，表示控件的集合，用于将一组相关控件组合成一组。
 96 | 
 97 | ```html
 98 | <form>
 99 |   <fieldset>
100 |     <p>年龄：<input type="text" name="age"></p>
101 |     <p>性别：<input type="text" name="gender"></p>
102 |   </fieldset>
103 | </form>
104 | ```
105 | 
106 | 上面代码中，两个输入框是一组，它们的外面会显示一个方框。
107 | 
108 | `<fieldset>`有以下属性。
109 | 
110 | - `disabled`：布尔属性，一旦设置会使得`<fieldset>`内部包含的控件都不可用，都变成灰色状态。
111 | - `form`：指定控件组所属的`<form>`，它的值等于`<form>`的`id`属性。
112 | - `name`：该控件组的名称。
113 | 
114 | `<legend>`标签用来设置`<fieldset>`控件组的标题，通常是`<fieldset>`内部的第一个元素，会嵌入显示在控件组的上边框里面。
115 | 
116 | ```html
117 | <fieldset>
118 |   <legend>学生情况登记</legend>
119 |   <p>年龄：<input type="text" name="age"></p>
120 |   <p>性别：<input type="text" name="gender"></p>
121 | </fieldset>
122 | ```
123 | 
124 | 上面代码中，这个控件组的标题会，嵌入显示在`<fieldset>`的上边框。
125 | 
126 | ## `<label>`
127 | 
128 | `<label>`标签是一个行内元素，提供控件的文字说明，帮助用户理解控件的目的。
129 | 
130 | ```html
131 | <label for="user">用户名：</label>
132 | <input type="text" name="user" id="user">
133 | ```
134 | 
135 | 上面代码中，输入框前面会有文字说明“用户名：”。
136 | 
137 | `<label>`的一大优势是增加了控件的可用性。有些控件比较小（比如单选框），不容易点击，那么点击对应的`<label>`标签，也能选中该控件。点击`<label>`，就相当于控件本身的`click`事件。
138 | 
139 | `<label>`的`for`属性关联相对应的控件，它的值是对应控件的`id`属性。所以，控件最好设置`id`属性。
140 | 
141 | 控件也可以放在`<label>`之中，这时不需要`for`属性和`id`属性。
142 | 
143 | ```html
144 | <label>用户名：
145 |   <input type="text" name="user">
146 | </label>
147 | ```
148 | 
149 | `<label>`的属性如下。
150 | 
151 | - `for`：关联控件的`id`属性。
152 | - `form`：关联表单的`id`属性。设置了该属性后，`<label>`可以放置在页面的任何位置，否则只能放在`<form>`内部。
153 | 
154 | 一个控件可以有多个关联的`<label>`标签。
155 | 
156 | ```html
157 | <label for="username">用户名：</label>
158 | <input type="text" id="username" name="username">
159 | <label for="username"><abbr title="required">*</abbr></label>
160 | ```
161 | 
162 | 上面代码中，`<input>`有两个关联的`<label>`。
163 | 
164 | ## `<input>`
165 | 
166 | ### 简介
167 | 
168 | `<input>`标签是一个行内元素，用来接收用户的输入。它是一个单独使用的标签，没有结束标志。
169 | 
170 | 它有多种类型，取决于`type`属性的值，默认值是`text`，表示一个输入框。
171 | 
172 | ```html
173 | <input>
174 | <!-- 等同于 -->
175 | <input type="text">
176 | ```
177 | 
178 | 上面代码会生成一个单行的输入框，用户可以在里面输入文本。
179 | 
180 | `<input>`的属性非常多，有些属性是某个类型专用的，放在下文的“类型”部分介绍。这里介绍一些所有类型的共同属性。
181 | 
182 | - `autofocus`：布尔属性，是否在页面加载时自动获得焦点。
183 | - `disabled`：布尔属性，是否禁用该控件。一旦设置，该控件将变灰，用户可以看到，但是无法操作。
184 | - `form`：关联表单的`id`属性。设置了该属性后，控件可以放置在页面的任何位置，否则只能放在`<form>`内部。
185 | - `list`：关联的`<datalist>`的`id`属性，设置该控件相关的数据列表，详见后文。
186 | - `name`：控件的名称，主要用于向服务器提交数据时，控件键值对的键名。注意，只有设置了`name`属性的控件，才会向服务器提交，不设置就不会提交。
187 | - `readonly`：布尔属性，是否为只读。
188 | - `required`：布尔属性，是否为必填。
189 | - `type`：控件类型，详见下文。
190 | - `value`：控件的值。
191 | 
192 | ### 类型
193 | 
194 | `type`属性决定了`<input>`的形式。该属性可以取以下值。
195 | 
196 | **（1）text**
197 | 
198 | `type="text"`是普通的文本输入框，用来输入单行文本。如果用户输入换行符，换行符会自动从输入中删除。
199 | 
200 | ```html
201 | <input type="text" id="name" name="name" required
202 |        minlength="4" maxlength="8" size="10">
203 | ```
204 | 
205 | `text`输入框有以下配套属性。
206 | 
207 | - `maxlength`：可以输入的最大字符数，值为一个非负整数。
208 | - `minlength`：可以输入的最小字符数，值为一个非负整数，且必须小于`maxlength`。
209 | - `pattern`：用户输入必须匹配的正则表达式，比如要求用户输入4个～8个英文字符，可以写成`pattern="[a-z]{4,8}"`。如果用户输入不符合要求，浏览器会弹出提示，不会提交表单。
210 | - `placeholder`：输入字段为空时，用于提示的示例值。只要用户没有任何字符，该提示就会出现，否则会消失。
211 | - `readonly`：布尔属性，表示该输入框是只读的，用户只能看，不能输入。
212 | - `size`：表示输入框的显示长度有多少个字符宽，它的值是一个正整数，默认等于20。超过这个数字的字符，必须移动光标才能看到。
213 | - `spellcheck`：是否对用户输入启用拼写检查，可能的值为`true`或`false`。
214 | 
215 | **（2）search**
216 | 
217 | `type="search"`是一个用于搜索的文本输入框，基本等同于`type="text"`。某些浏览器会在输入的时候，在输入框的尾部显示一个删除按钮，点击就会删除所有输入，让用户从头开始输入。
218 | 
219 | 下面是一个例子。
220 | 
221 | ```html
222 | <form>
223 |   <input type="search" id="mySearch" name="q"
224 |     placeholder="输入搜索词……" required>
225 |   <input type="submit" value="搜索">
226 | </form>
227 | ```
228 | 
229 | **（3）button**
230 | 
231 | `type="button"`是没有默认行为的按钮，通常脚本指定`click`事件的监听函数来使用。
232 | 
233 | ```html
234 | <input type="button" value="点击">
235 | ```
236 | 
237 | 建议尽量不使用这个类型，而使用`<button>`标签代替，一则语义更清晰，二则`<button>`标签内部可以插入图片或其他 HTML 代码。
238 | 
239 | **（4）submit**
240 | 
241 | `type="submit"`是表单的提交按钮。用户点击这个按钮，就会把表单提交给服务器。
242 | 
243 | ```html
244 | <input type="submit" value="提交">
245 | ```
246 | 
247 | 如果不指定`value`属性，浏览器会在提交按钮上显示默认的文字，通常是`Submit`。
248 | 
249 | 该类型有以下配套属性，用来覆盖`<form>`标签的相应设置。
250 | 
251 | - `formaction`：提交表单数据的服务器 URL。
252 | - `formenctype`：表单数据的编码类型。
253 | - `formmethod`：提交表单使用的 HTTP 方法（`get`或`post`）。
254 | - `formnovalidate`：一个布尔值，表示数据提交给服务器之前，是否要忽略表单验证。
255 | - `formtarget`：收到服务器返回的数据后，在哪一个窗口显示。
256 | 
257 | **（5）image**
258 | 
259 | `type="image"`表示将一个图像文件作为提交按钮，行为和用法与`type="submit"`完全一致。
260 | 
261 | ```html
262 | <input type="image" alt="登陆" src="login-button.png">
263 | ```
264 | 
265 | 上面代码中，图像文件是一个可以点击的按钮，点击后会提交数据到服务器。
266 | 
267 | 该类型有以下配套属性。
268 | 
269 | - `alt`：图像无法加载时显示的替代字符串。
270 | - `src`：加载的图像 URL。
271 | - `height`：图像的显示高度，单位为像素。
272 | - `width`：图像的显示宽度，单位为像素。
273 | - `formaction`：提交表单数据的服务器 URL。
274 | - `formenctype`：表单数据的编码类型。
275 | - `formmethod`：提交表单使用的 HTTP 方法（`get`或`post`）。
276 | - `formnovalidate`：一个布尔值，表示数据提交给服务器之前，是否要忽略表单验证。
277 | - `formtarget`：收到服务器返回的数据后，在哪一个窗口显示。
278 | 
279 | 用户点击图像按钮提交时，会额外提交两个参数`x`和`y`到服务器，表示鼠标的点击位置，比如`x=52&y=55`。`x`是横坐标，`y`是纵坐标，都以图像左上角作为原点`(0, 0)`。如果图像按钮设置了`name`属性，比如`name="position"`，那么将以该值作为坐标的前缀，比如`position.x=52&position.y=55`。这个功能通常用来地图类型的操作，让服务器知道用户点击了地图的哪个部分。
280 | 
281 | **（6）reset**
282 | 
283 | `type="reset"`是一个重置按钮，用户点击以后，所有表格控件重置为初始值。
284 | 
285 | ```html
286 | <input type="reset" value="重置">
287 | ```
288 | 
289 | 如果不设置`value`属性，浏览器会在按钮上面加上默认文字，通常是`Reset`。
290 | 
291 | 这个控件用处不大，用户点错了还会使得所有已经输入的值都被重置，建议不要使用。
292 | 
293 | **（7）checkbox**
294 | 
295 | `type="checkbox"`是复选框，允许选择或取消选择该选项。
296 | 
297 | ```html
298 | <input type="checkbox" id="agreement" name="agreement" checked>
299 | <label for="agreement">是否同意</label>
300 | ```
301 | 
302 | 上面代码会在文字前面，显示一个可以点击的选择框，点击可以选中，再次点击可以取消。上面代码中，`checked`属性表示默认选中。
303 | 
304 | `value`属性的默认值是`on`。也就是说，如果没有设置`value`属性，以上例来说，选中复选框时，会提交`agreement=on`。如果没有选中，提交时不会有该项。
305 | 
306 | 多个相关的复选框，可以放在`<fieldset>`里面。
307 | 
308 | ```html
309 | <fieldset>
310 |   <legend>你的兴趣</legend>
311 |   <div>
312 |     <input type="checkbox" id="coding" name="interest" value="coding">
313 |     <label for="coding">编码</label>
314 |   </div>
315 |   <div>
316 |     <input type="checkbox" id="music" name="interest" value="music">
317 |     <label for="music">音乐</label>
318 |   </div>
319 | </fieldset>
320 | ```
321 | 
322 | 上面代码中，如果用户同时选中两个复选框，提交的时候就会有两个`name`属性，比如`interest=coding&interest=music`。
323 | 
324 | **（8）radio**
325 | 
326 | `type="radio"`是单选框，表示一组选择之中，只能选中一项。单选框通常为一个小圆圈，选中时会被填充或突出显示。
327 | 
328 | ```html
329 | <fieldset>
330 |   <legend>性别</legend>
331 |   <div>
332 |     <input type="radio" id="male" name="gender" value="male">
333 |     <label for="male">男</label>
334 |   </div>
335 |   <div>
336 |     <input type="radio" id="female" name="gender" value="female">
337 |     <label for="female">女</label>
338 |   </div>
339 | </fieldset>
340 | ```
341 | 
342 | 上面代码中，性别只能在两个选项之中，选择一项。
343 | 
344 | 注意，多个单选框的`name`属性的值，应该都是一致的。提交到服务器的就是选中的那个值。
345 | 
346 | 该类型的配套属性如下。
347 | 
348 | - `checked`：布尔属性，表示是否默认选中当前项。
349 | - `value`：用户选中该项时，提交到服务器的值，默认为`on`。
350 | 
351 | **（9）email**
352 | 
353 | `type="email"`是一个只能输入电子邮箱的文本输入框。表单提交之前，浏览器会自动验证是否符合电子邮箱的格式，如果不符合就会显示提示，无法提交到服务器。
354 | 
355 | ```html
356 | <input type="email" pattern=".+@foobar.com" size="30" required>
357 | ```
358 | 
359 | 上面代码会生成一个必填的文本框，只能输入后缀为`foobar.com`的邮箱地址。
360 | 
361 | 该类型有一个`multiple`的布尔属性，一旦设置，就表示该输入框可以输入多个逗号分隔的电子邮箱。
362 | 
363 | ```html
364 | <input id="emailAddress" type="email" multiple required>
365 | ```
366 | 
367 | 注意，如果同时设置了`multiple`属性和`required`属性，零个电子邮箱是允许的，也就是该输入框允许为空。
368 | 
369 | 该类型的配套属性如下。
370 | 
371 | - `maxlength`：可以输入的最大字符数。
372 | - `minlength`：可以输入的最少字符数。
373 | - `multiple`：布尔属性，是否允许输入多个以逗号分隔的电子邮箱。
374 | - `pattern`：输入必须匹配的正则表达式。
375 | - `placeholder`：输入为空时的显示文本。
376 | - `readonly`：布尔属性，该输入框是否只读。
377 | - `size`：一个非负整数，表示输入框的显示长度为多少个字符。
378 | - `spellcheck`：是否对输入内容启用拼写检查，可能的值为`true`或`false`。
379 | 
380 | 该类型还可以搭配`<datalist>`标签，提供输入的备选项。
381 | 
382 | ```html
383 | <input type="email" size="40" list="defaultEmails">
384 | 
385 | <datalist id="defaultEmails">
386 |   <option value="jbond007@mi6.defence.gov.uk">
387 |   <option value="jbourne@unknown.net">
388 |   <option value="nfury@shield.org">
389 |   <option value="tony@starkindustries.com">
390 |   <option value="hulk@grrrrrrrr.arg">
391 | </datalist>
392 | ```
393 | 
394 | 上面代码中，输入焦点进入输入框以后，会显示一个下拉列表，里面有五个参考项，供用户参考。
395 | 
396 | **（10）password**
397 | 
398 | `type="password"`是一个密码输入框。用户的输入会被遮挡，字符通常显示星号（`*`）或点（`·`）。
399 | 
400 | ```html
401 | <input type="password" id="pass" name="password"
402 |            minlength="8" required>
403 | ```
404 | 
405 | 浏览器对该类型输入框的显示，会有所差异。一种常见的处理方法是，用户每输入一个字符，先在输入框里面显示一秒钟，然后再遮挡该字符。
406 | 
407 | 如果用户输入内容包含换行符（`U+000A`）和回车符（`U+000D`），浏览器会自动将这两个字符过滤掉。
408 | 
409 | 该类型的配套属性如下。
410 | 
411 | - `maxlength`：可以输入的最大字符数。
412 | - `minlength`：可以输入的最少字符数。
413 | - `pattern`：输入必须匹配的正则表达式。
414 | - `placeholder`：输入为空时的显示文本。
415 | - `readonly`：布尔属性，该输入框是否只读。
416 | - `size`：一个非负整数，表示输入框的显示长度为多少个字符。
417 | - `autocomplete`：是否允许自动填充，可能的值有`on`（允许自动填充）、`off`（不允许自动填充）、`current-password`（填入当前网站保存的密码）、`new-password`（自动生成一个随机密码）。
418 | - `inputmode`：允许用户输入的数据类型，可能的值有`none`（不使用系统输入法）、`text`（标准文本输入）、`decimal`（数字，包含小数）、`numeric`（数字0-9）等。
419 | 
420 | **（11）file**
421 | 
422 | `type="file"`是一个文件选择框，允许用户选择一个或多个文件，常用于文件上传功能。
423 | 
424 | ```html
425 | <input type="file"
426 |        id="avatar" name="avatar"
427 |        accept="image/png, image/jpeg">
428 | ```
429 | 
430 | 该类型有以下属性。
431 | 
432 | - `accept`：允许选择的文件类型，使用逗号分隔，可以使用 MIME 类型（比如`image/jpeg`），也可以使用后缀名（比如`.doc`），还可以使用`audio/*`（任何音频文件）、`video/*`（任何视频文件）、`image/*`（任何图像文件）等表示法。
433 | - `capture`：用于捕获图像或视频数据的源，可能的值有`user`（面向用户的摄像头或麦克风），`environment`（外接的摄像头或麦克风）。
434 | - `multiple`：布尔属性，是否允许用户选择多个文件。
435 | 
436 | **（12）hidden**
437 | 
438 | `type="hidden"`是一个不显示在页面的控件，用户无法输入它的值，主要用来向服务器传递一些隐藏信息。比如，CSRF 攻击会伪造表单数据，那么使用这个控件，可以为每个表单生成一个独一无二的隐藏编号，防止伪造表单提交。
439 | 
440 | ```html
441 | <input id="prodId" name="prodId" type="hidden" value="xm234jq">
442 | ```
443 | 
444 | 上面这个控件，页面上是看不见的。用户提交表单的时候，浏览器会将`prodId=xm234jq`发给服务器。
445 | 
446 | **（13）number**
447 | 
448 | `type="number"`是一个数字输入框，只能输入数字。浏览器通常会在输入框的最右侧，显示一个可以点击的上下箭头，点击向上箭头，数字会递增，点击向下箭头，数字会递减。
449 | 
450 | ```html
451 | <input type="number" id="tentacles" name="tentacles"
452 |        min="10" max="100">
453 | ```
454 | 
455 | 上面代码指定数字输入框，最小可以输入10，最大可以输入100。
456 | 
457 | 该类型可以接受任何数值，包括小数和整数。可以通过`step`属性，限定只接受整数。
458 | 
459 | 该类型有以下配套属性。
460 | 
461 | - `max`：允许输入的最大数值。
462 | - `min`：允许输入的最小数值。
463 | - `placeholder`：用户输入为空时，显示的示例值。
464 | - `readonly`：布尔属性，表示该控件是否为只读。
465 | - `step`：点击向上和向下箭头时，数值每次递减的步长值。如果用户输入的值，不符合步长值的设定，浏览器会自动四舍五入到最近似的值。默认的步长值是`1`，如果初始的`value`属性设为`1.5`，那么点击向上箭头得到`2.5`，点击向下箭头得到`0.5`。
466 | 
467 | **（14）range**
468 | 
469 | `type="range"`是一个滑块，用户拖动滑块，选择给定范围之中的一个数值。因为拖动产生的值是不精确的，如果需要精确数值，不建议使用这个控件。常见的例子是调节音量。
470 | 
471 | ```html
472 | <input type="range" id="start" name="volume"
473 |          min="0" max="11">
474 | ```
475 | 
476 | 上面代码会产生一个最小值为`0`、最大值为`11`的滑块区域。用户拖动滑块，选择想要的音量。
477 | 
478 | 该类型的配套属性如下，用法与`type="number"`一致。
479 | 
480 | - `max`：允许的最大值，默认为100。
481 | - `min`：允许的最小值，默认为0。
482 | - `step`：步长值，默认为1。
483 | 
484 | `value`属性的初始值就是滑块的默认位置。如果没有设置`value`属性，滑块默认就会停在最大值和最小值中间。如果`max`属性、`min`属性、`value`属性都没有设置，那么`value`属性为50。
485 | 
486 | 该类型与`<datalist>`标签配合使用，可以在滑动区域产生刻度。
487 | 
488 | ```html
489 | <input type="range" list="tickmarks">
490 | 
491 | <datalist id="tickmarks">
492 |   <option value="0" label="0%">
493 |   <option value="10">
494 |   <option value="20">
495 |   <option value="30">
496 |   <option value="40">
497 |   <option value="50" label="50%">
498 |   <option value="60">
499 |   <option value="70">
500 |   <option value="80">
501 |   <option value="90">
502 |   <option value="100" label="100%">
503 | </datalist>
504 | ```
505 | 
506 | 上面代码会在0～100之间产生11个刻度。其中，`0%`、`50%`和`100%`三个位置会有文字提示，不过浏览器很可能不支持。
507 | 
508 | 注意，浏览器生成的都是水平滑块。如果想要生成垂直滑块，可以使用 CSS 改变滑块区域的方向。
509 | 
510 | **（15）url**
511 | 
512 | `type="url"`是一个只能输入网址的文本框。提交表单之前，浏览器会自动检查网址格式是否正确，如果不正确，就会无法提交。
513 | 
514 | ```html
515 | <input type="url" name="url" id="url"
516 |        placeholder="https://example.com"
517 |        pattern="https://.*" size="30"
518 |        required>
519 | ```
520 | 
521 | 上面代码的`pattern`属性指定输入的网址只能使用 HTTPS 协议。
522 | 
523 | 注意，该类型规定，不带有协议的网址是无效的，比如`foo.com`是无效的，`http://foo.com`是有效的。
524 | 
525 | 该类型的配套属性如下。
526 | 
527 | - `maxlength`：允许的最大字符数。
528 | - `minlength`：允许的最少字符串。
529 | - `pattern`：输入内容必须匹配的正则表达式。
530 | - `placeholder`：输入为空时显示的示例文本。
531 | - `readonly`：布尔属性，表示该控件的内容是否只读。
532 | - `size`：一个非负整数，表示该输入框显示宽度为多少个字符。
533 | - `spellcheck`：是否启动拼写检查，可能的值为`true`（启用）和`false`（不启用）。
534 | 
535 | 该类型与`<datalist>`标签搭配使用，可以形成下拉列表供用户选择。随着用户不断键入，会缩小显示范围，只显示匹配的备选项。
536 | 
537 | ```html
538 | <input id="myURL" name="myURL" type="url"
539 |        list="defaultURLs">
540 | 
541 | <datalist id="defaultURLs">
542 |   <option value="https://developer.mozilla.org/" label="MDN Web Docs">
543 |   <option value="http://www.google.com/" label="Google">
544 |   <option value="http://www.microsoft.com/" label="Microsoft">
545 |   <option value="https://www.mozilla.org/" label="Mozilla">
546 |   <option value="http://w3.org/" label="W3C">
547 | </datalist>
548 | ```
549 | 
550 | 上面代码中，`<option>`的`label`属性表示文本标签，显示在备选下拉框的右侧，网址显示在左侧。
551 | 
552 | **（16）tel**
553 | 
554 | `type="tel"`是一个只能输入电话号码的输入框。由于全世界的电话号码格式都不相同，因此浏览器没有默认的验证模式，大多数时候需要自定义验证。
555 | 
556 | ```html
557 | <input type="tel" id="phone" name="phone"
558 |        pattern="[0-9]{3}-[0-9]{3}-[0-9]{4}"
559 |        required>
560 | 
561 | <small>Format: 123-456-7890</small>
562 | ```
563 | 
564 | 上面代码定义了一个只能输入10位电话号码的输入框。
565 | 
566 | 该类型的配套属性如下。
567 | 
568 | - `maxlength`：允许的最大字符数。
569 | - `minlength`：允许的最少字符串。
570 | - `pattern`：输入内容必须匹配的正则表达式。
571 | - `placeholder`：输入为空时显示的示例文本。
572 | - `readonly`：布尔属性，表示该控件的内容是否只读。
573 | - `size`：一个非负整数，表示该输入框显示宽度为多少个字符。
574 | 
575 | **（17）color**
576 | 
577 | `type="color"`是一个选择颜色的控件，它的值一律都是`#rrggbb`格式。
578 | 
579 | ```html
580 | <input type="color" id="background" name="background"
581 |            value="#e66465">
582 | ```
583 | 
584 | 上面代码在 Chrome 浏览器中，会显示一个`#e66465`的色块。点击色块，就会出现一个拾色器，供用户选择颜色。
585 | 
586 | 如果没有指定`value`属性的初始值，默认值为`#000000`（黑色）。
587 | 
588 | **（18）date**
589 | 
590 | `type="date"`是一个只能输入日期的输入框，用户可以输入年月日，但是不能输入时分秒。输入格式是`YYYY-MM-DD`。
591 | 
592 | ```html
593 | <input type="date" id="start" name="start"
594 |        value="2018-07-22"
595 |        min="2018-01-01" max="2018-12-31">
596 | ```
597 | 
598 | 上面代码会显示一个输入框，默认日期是2018年7月22日。用户点击以后，会日期选择器，供用户选择新的日期。
599 | 
600 | 该类型有以下配套属性。
601 | 
602 | - `max`：可以允许的最晚日期，格式为`yyyy-MM-dd`。
603 | - `min`：可以允许的最早日期，格式为`yyyy-MM-dd`。
604 | - `step`：步长值，一个数字，以天为单位。
605 | 
606 | **（19）time**
607 | 
608 | `type="time"`是一个只能输入时间的输入框，可以输入时分秒，不能输入年月日。日期格式是24小时制的`hh:mm`，如果包括秒数，格式则是`hh:mm:ss`。日期选择器的形式则随浏览器不同而不同。
609 | 
610 | ```html
611 | <input type="time" id="appt" name="appt"
612 |        min="9:00" max="18:00" required>
613 | 
614 | <small>营业时间上午9点到下午6点</small>
615 | ```
616 | 
617 | 该类型有以下配套属性。
618 | 
619 | - `max`：允许的最晚时间。
620 | - `min`：允许的最早时间。
621 | - `readonly`：布尔属性，表示用户是否不可以编辑时间。
622 | - `step`：步长值，单位为秒。
623 | 
624 | ```html
625 | <input id="appt" type="time" name="appt" step="2">
626 | ```
627 | 
628 | 上面代码中，调节控件的话，时间每次改变的幅度是2秒钟。
629 | 
630 | **（20）month**
631 | 
632 | `type="month"`是一个只能输入年份和月份的输入框，格式为`YYYY-MM`。
633 | 
634 | ```html
635 | <input type="month" id="start" name="start"
636 |        min="2018-03" value="2018-05">
637 | ```
638 | 
639 | 该类型有以下配套属性。
640 | 
641 | - `max`：允许的最晚时间，格式为`yyyy-MM`。
642 | - `min`：允许的最早时间，格式为`yyyy-MM`。
643 | - `readonly`：布尔属性，表示用户是否不可以编辑时间。
644 | - `step`：步长值，单位为月。
645 | 
646 | **（21）week**
647 | 
648 | `type="week"`是一个输入一年中第几周的输入框。格式为`yyyy-Www`，比如`2018-W18`表示2018年第18周。
649 | 
650 | ```html
651 | <input type="week" name="week" id="camp-week"
652 |        min="2018-W18" max="2018-W26" required>
653 | ```
654 | 
655 | 该类型有以下配套属性。
656 | 
657 | - `max`：允许的最晚时间，格式为`yyyy-Www`。
658 | - `min`：允许的最早时间，格式为`yyyy-Www`。
659 | - `readonly`：布尔属性，表示用户是否不可以编辑时间。
660 | - `step`：步长值，单位为周。
661 | 
662 | **（22）datetime-local**
663 | 
664 | `type="datetime-local"`是一个时间输入框，让用户输入年月日和时分，格式为`yyyy-MM-ddThh:mm`。注意，该控件不支持秒。
665 | 
666 | ```html
667 | <input type="datetime-local" id="meeting-time"
668 |        name="meeting-time" value="2018-06-12T19:30"
669 |        min="2018-06-07T00:00" max="2018-06-14T00:00">
670 | ```
671 | 
672 | 该类型有以下配套属性。
673 | 
674 | - `max`：允许的最晚时间，格式为`yyyy-MM-ddThh:mm`。
675 | - `min`：允许的最早时间，格式为`yyyy-MM-ddThh:mm`。
676 | - `step`：步长值，单位为秒，默认值是60。
677 | 
678 | ## `<button>`
679 | 
680 | `<button>`标签会生成一个可以点击的按钮，没有默认行为，通常需要用`type`属性或脚本指定按钮的功能。
681 | 
682 | ```html
683 | <button>点击</button>
684 | ```
685 | 
686 | 上面代码会产生一个按钮，上面的文字就是“点击”。
687 | 
688 | `<button>`内部不仅放置文字，还可以放置图像，这可以形成图像按钮。
689 | 
690 | ```html
691 | <button name="search" type="submit">
692 |   <img src="search.gif">搜索
693 | </button>
694 | ```
695 | 
696 | `<button>`具有以下属性。
697 | 
698 | - `autofocus`：布尔属性，表示网页加载时，焦点就在这个按钮。网页里面只能有一个元素，具有这个属性。
699 | - `disabled`：布尔属性，表示按钮不可用，会导致按钮变灰，不可点击。
700 | - `name`：按钮的名称（与`value`属性配合使用），将以`name=value`的形式，随表单一起提交到服务器。
701 | - `value`：按钮的值（与`name`属性配合使用），将以`name=value`的形式，随表单一起提交到服务器。
702 | - `type`：按钮的类型，可能的值有三种：`submit`（点击后将数据提交给服务器），`reset`（将所有控件的值重置为初始值），`button`（没有默认行为，由脚本指定按钮的行为）。
703 | - `form`：指定按钮关联的`<form>`表单，值为`<form>`的`id`属性。如果省略该属性，默认关联按钮所在父表单。
704 | - `formaction`：数据提交到服务器的目标 URL，会覆盖`<form>`元素的`action`属性。
705 | - `formenctype`：数据提交到服务器的编码方式，会覆盖`<form>`元素的`enctype`属性。可能的值有三种：`application/x-www-form-urlencoded`（默认值），`multipart/form-data`（只用于文件上传），`text/plain`。
706 | - `formmethod`：数据提交到服务器使用的 HTTP 方法，会覆盖`<form>`元素的`method`属性，可能的值为`post`或`get`。
707 | - `formnovalidate`：布尔属性，数据提交到服务器时关闭本地验证，会覆盖`<form>`元素的`novalidate`属性。
708 | - `formtarget`：数据提交到服务器后，展示服务器返回数据的窗口，会覆盖`<form>`元素的`target`属性。可能的值有`_self`（当前窗口），`_blank`（新的空窗口）、`_parent`（父窗口）、`_top`（顶层窗口）。
709 | 
710 | ## `<select>`
711 | 
712 | `<select>`标签用于生成一个下拉菜单。
713 | 
714 | ```html
715 | <label for="pet-select">宠物：</label>
716 | 
717 | <select id="pet-select" name="pet-select">
718 |   <option value="">--请选择一项--</option>
719 |   <option value="dog">狗</option>
720 |   <option value="cat">猫</option>
721 |   <option value="others">其他</option>
722 | </select>
723 | ```
724 | 
725 | 上面代码中，`<select>`生成一个下拉菜单，菜单标题是“--请选择一项--”，最右侧有一个下拉箭头。点击下拉箭头，会显示三个菜单项，供用户点击选择。
726 | 
727 | 下拉菜单的菜单项由`<option>`标签给出，每个`<option>`代表可以选择的一个值。选中的`<option>`的`value`属性，就是`<select>`控件发送的服务器的值。
728 | 
729 | `<option>`有一个布尔属性`selected`，一旦设置，就表示该项是默认选中的菜单项。
730 | 
731 | ```html
732 | <select name="choice">
733 |   <option value="first">First Value</option>
734 |   <option value="second" selected>Second Value</option>
735 |   <option value="third">Third Value</option>
736 | </select>
737 | ```
738 | 
739 | 上面代码中，第二项`Second Value`是默认选中的。页面加载的时候，会直接显示在下拉菜单上。
740 | 
741 | `<select>`有如下属性。
742 | 
743 | - `autofocus`：布尔属性，页面加载时是否自动获得焦点。
744 | - `disabled`：布尔属性，是否禁用当前控件。
745 | - `form`：关联表单的`id`属性。
746 | - `multiple`：布尔属性，是否可以选择多个菜单项。默认情况下，只能选择一项。一旦设置，多数浏览器会显示一个滚动列表框。用户可能需要按住`Shift`或其他功能键，选中多项。
747 | - `name`：控件名。
748 | - `required`：布尔属性，是否为必填控件。
749 | - `size`：设置了`multiple`属性时，页面显示时一次可见的行数，其他行需要滚动查看。
750 | 
751 | ## `<option>`，`<optgroup>`
752 | 
753 | `<option>`标签用在`<select>`、`<optgroup>`、`<datalist>`里面，表示一个菜单项，参见`<select>`的示例。
754 | 
755 | 它有如下属性。
756 | 
757 | - `disabled`：布尔属性，是否禁用该项。
758 | - `label`：该项的说明。如果省略，则等于该项的文本内容。
759 | - `selected`：布尔属性，是否为默认值。显然，一组菜单中，只能有一个菜单项设置该属性。
760 | - `value`：该项提交到服务器的值。如果省略，则等于该项的文本内容。
761 | 
762 | `<optgroup>`表示菜单项的分组，通常用在`<select>`内部。
763 | 
764 | ```html
765 | <label>宠物：
766 |   <select name="pets" multiple size="4">
767 |     <optgroup label="四条腿的宠物">
768 |       <option value="dog">狗</option>
769 |       <option value="cat">猫</option>
770 |     </optgroup>
771 |     <optgroup label="鸟类">
772 |       <option value="parrot">鹦鹉</option>
773 |       <option value="thrush">画眉</option>
774 |     </optgroup>
775 |   </select>
776 | </label>
777 | ```
778 | 
779 | 上面代码中，`<select>`是一个下拉菜单，它的内部使用`<optgroup>`将菜单项分成两组。每组有自己的标题，会加粗显示，但是用户无法选中。
780 | 
781 | 它的属性如下。
782 | 
783 | - `disabled`：布尔设置，是否禁用该组。一旦设置，该组所有的菜单项都不可选。
784 | - `label`：菜单项分组的标题。
785 | 
786 | ## `<datalist>`
787 | 
788 | `<datalist>`标签是一个容器标签，用于为指定控件提供一组相关数据，通常用于生成输入提示。它的内部使用`<option>`，生成每个菜单项。
789 | 
790 | ```html
791 | <label for="ice-cream-choice">冰淇淋：</label>
792 | <input type="text" list="ice-cream-flavors" id="ice-cream-choice" name="ice-cream-choice">
793 | 
794 | <datalist id="ice-cream-flavors">
795 |   <option value="巧克力">
796 |   <option value="椰子">
797 |   <option value="薄荷">
798 |   <option value="草莓">
799 |   <option value="香草">
800 | </datalist>
801 | ```
802 | 
803 | 上面代码中，`<input>`生成一个文本输入框，用户可以输入文本。`<input>`的`list`属性指定关联的`<datalist>`的`id`属性。`<datalist>`的数据列表用于输入建议，用户点击输入框的时候，会显示一个下拉菜单，里面是建议的输入项。并且还会自动匹配用户已经输入的字符，缩小可选的范围，比如用户输入“香”，则只会显示“香草”这一项。
804 | 
805 | 注意，`<option>`在这里可以不需要闭合标签。
806 | 
807 | `<option>`标签还可以加入`label`属性，作为说明文字。Chrome 浏览器会将其显示在`value`的下一行。
808 | 
809 | ```html
810 | <datalist id="ide">
811 |   <option value="Brackets" label="by Adobe">
812 |   <option value="Coda" label="by Panic">
813 | </datalist>
814 | ```
815 | 
816 | 上面代码的渲染结果是，Chrome 浏览器会在下拉列表显示`value`值（比如`Brackets`），然后在其下方以小字显示`label`值（比如`by Adobe`）。
817 | 
818 | ## `<textarea>`
819 | 
820 | `<textarea>`是一个块级元素，用来生成多行的文本框。
821 | 
822 | ```html
823 | <textarea id="story" name="story"
824 |           rows="5" cols="33">
825 | 这是一个很长的故事。
826 | </textarea>
827 | ```
828 | 
829 | 上面代码会生成一个长度为5行，宽度为33个字符的文本框。
830 | 
831 | 该标签有如下属性。
832 | 
833 | - `autofocus`：布尔属性，是否自动获得焦点。
834 | - `cols`：文本框的宽度，单位为字符，默认值为20。
835 | - `dir`：设定文本方向，默认为从左到右（`dir="ltr"`），也可以设为从右到左（`dir="rtl"`），或者让浏览器根据用户输入自动调整（`dir="auto"`）。
836 | - `disabled`：布尔属性，是否禁用该控件。
837 | - `form`：关联表单的`id`属性。
838 | - `maxlength`：允许输入的最大字符数。如果未指定此值，用户可以输入无限数量的字符。
839 | - `minlength`：允许输入的最小字符数。
840 | - `name`：控件的名称。
841 | - `placeholder`：输入为空时显示的提示文本。
842 | - `readonly`：布尔属性，控件是否为只读。
843 | - `required`：布尔属性，控件是否为必填。
844 | - `rows`：文本框的高度，单位为行。
845 | - `spellcheck`：是否打开浏览器的拼写检查。可能的值有`true`（打开），`default`（由父元素或网页设置决定），`false`（关闭）。
846 | - `wrap`：输入的文本是否自动换行。可能的值有`hard`（浏览器自动插入换行符`CR + LF`，使得每行不超过控件的宽度），`soft`（输入内容超过宽度时自动换行，但不会加入新的换行符，并且浏览器保证所有换行符都是`CR + LR`，这是默认值），`off`（关闭自动换行，单行长度超过宽度时，会出现水平滚动条）。
847 | 
848 | ## `<output>`
849 | 
850 | `<output>`标签是一个行内元素，用于显示用户操作的结果。
851 | 
852 | ```html
853 | <input type="number" name="a" value="10"> +
854 | <input type="number" name="b" value="10"> =
855 | <output name="result">20</output>
856 | ```
857 | 
858 | 该标签有如下属性。
859 | 
860 | - `for`：关联控件的`id`属性，表示为该控件的操作结果。
861 | - `form`：关联表单的`id`属性。
862 | - `name`：控件的名称。
863 | 
864 | ## `<progress>`
865 | 
866 | `<progress>`标签是一个行内元素，表示任务的完成进度。浏览器通常会将显示为进度条。
867 | 
868 | ```html
869 | <progress id="file" max="100" value="70"> 70% </progress>
870 | ```
871 | 
872 | 该标签有如下属性。
873 | 
874 | - `max`：进度条的最大值，应该是一个大于`0`的浮点数。默认值为1。
875 | - `value`：进度条的当前值。它必须是`0`和`max`属性之间的一个有效浮点数。如果省略了`max`属性，该值则必须在`0`和`1`之间。如果省略了`value`属性，则进度条会出现滚动，表明正在进行中，无法知道完成的进度。
876 | 
877 | ## `<meter>`
878 | 
879 | `<meter>`标签是一个行内元素，表示指示器，用来显示已知范围内的一个值，很适合用于任务的当前进度、磁盘已用空间、充电量等带有比例性质的场合。浏览器通常会将其显示为一个不会滚动的指示条。
880 | 
881 | ```html
882 | <p>烤箱的当前温度是<meter min="200" max="500"
883 |   value="350"> 350 度</meter>。</p>
884 | ```
885 | 
886 | 上面代码会显示一个指示条，左侧表示`200`，右侧表示`500`，当前位置停留在`350`。
887 | 
888 | 注意，`<meter>`元素的子元素，正常情况下不会显示。只有在浏览器不支持`<meter>`时才会显示。
889 | 
890 | 该标签有如下属性。
891 | 
892 | - `min`：范围的下限，必须小于`max`属性。如果省略，则默认为`0`。
893 | - `max`：范围的上限，必须大于`min`属性。如果省略，则默认为`1`。
894 | - `value`：当前值，必须在`min`属性和`max`属性之间。如果省略，则默认为`0`。
895 | - `low`：表示“低端”的上限门槛值，必须大于`min`属性，小于`high`属性和`max`属性。如果省略，则等于`min`属性。
896 | - `high`：表示“高端”的下限门槛值，必须小于`max`属性，大于`low`属性和`min`属性。如果省略，则等于`max`属性。
897 | - `optimum`：指定最佳值，必须在`min`属性和`max`属性之间。它应该与`low`属性和`high`属性一起使用，表示最佳范围。如果`optimum`小于`low`属性，则表示“低端”是最佳范围；如果大于`high`属性，则表示“高端”是最佳范围；如果在`low`和`high`之间，则表示“中间地带”是最佳范围。如果省略，则等于`min`和`max`的中间值。
898 | - `form`：关联表单的`id`属性。
899 | 
900 | Chrome 浏览器使用三种颜色，表示指示条所处的位置。较好情况时，当前位置为绿色；一般情况时，当前位置为黄色；较差情况时，当前位置为红色。
901 | 
902 | ```html
903 | <meter id="fuel" name="fuel"
904 |        min="0" max="100"
905 |        low="33" high="66" optimum="80"
906 |        value="50">
907 |     at 50/100
908 | </meter>
909 | ```
910 | 
911 | 上面代码中，指示条可以分成三段：0 ～ 32，33 ～ 65，66 ～ 100。由于`optimum`属性是`80`，因此`66 ～ 100`是较好情况，`33 ～ 65`是一般情况，`0 ～ 32`是较差情况。浏览器因此会根据`value`属性，将当前位置显示为不同颜色，小于`33`时显示红色，大于`65`时显示绿色，两者之间显示黄色。
912 | 
913 | ## 参考链接
914 | 
915 | - [HTML Interactive Form Validation](https://webkit.org/blog/7099/html-interactive-form-validation/), by Chris Dumez
916 | 
917 | 


--------------------------------------------------------------------------------
/docs/iframe.md:
--------------------------------------------------------------------------------
 1 | # iframe
 2 | 
 3 | `<iframe>`标签用于在网页里面嵌入其他网页。
 4 | 
 5 | ## 基本用法
 6 | 
 7 | `<iframe>`标签生成一个指定区域，在该区域中嵌入其他网页。它是一个容器元素，如果浏览器不支持`<iframe>`，就会显示内部的子元素。
 8 | 
 9 | ```html
10 | <iframe src="https://www.example.com"
11 |         width="100%" height="500" frameborder="0"
12 |         allowfullscreen sandbox>
13 |   <p><a href="https://www.example.com">点击打开嵌入页面</a></p>
14 | </iframe>
15 | ```
16 | 
17 | 上面的代码在当前网页嵌入`https://www.example.com`，显示区域的宽度是`100%`，高度是`500`像素。如果当前浏览器不支持`<iframe>`，则会显示一个链接，让用户点击。
18 | 
19 | 浏览器普遍支持`<iframe>`，所以内部的子元素可以不写。
20 | 
21 | `<iframe>`的属性如下。
22 | 
23 | - `allowfullscreen`：允许嵌入的网页全屏显示，需要全屏 API 的支持，请参考相关的 JavaScript 教程。
24 | - `frameborder`：是否绘制边框，`0`为不绘制，`1`为绘制（默认值）。建议尽量少用这个属性，而是在 CSS 里面设置样式。
25 | - `src`：嵌入的网页的 URL。
26 | - `width`：显示区域的宽度。
27 | - `height`：显示区域的高度。
28 | - `sandbox`：设置嵌入的网页的权限，详见下文。
29 | - `importance`：浏览器下载嵌入的网页的优先级，可以设置三个值。`high`表示高优先级，`low`表示低优先级，`auto`表示由浏览器自行决定。
30 | - `name`：内嵌窗口的名称，可以用于`<a>`、`<form>`、`<base>`的`target`属性。
31 | - `referrerpolicy`：请求嵌入网页时，HTTP 请求的`Referer`字段的设置。参见`<a>`标签的介绍。
32 | 
33 | ## sandbox 属性
34 | 
35 | 嵌入的网页默认具有正常权限，比如执行脚本、提交表单、弹出窗口等。如果嵌入的网页是其他网站的页面，你不了解对方会执行什么操作，因此就存在安全风险。为了限制`<iframe>`的风险，HTML 提供了`sandbox`属性，允许设置嵌入的网页的权限，等同于提供了一个隔离层，即“沙箱”。
36 | 
37 | `sandbox`可以当作布尔属性使用，表示打开所有限制。
38 | 
39 | ```html
40 | <iframe src="https://www.example.com" sandbox>
41 | </iframe>
42 | ```
43 | 
44 | `sandbox`属性可以设置具体的值，表示逐项打开限制。未设置某一项，就表示不具有该权限。
45 | 
46 | - `allow-forms`：允许提交表单。
47 | - `allow-modals`：允许提示框，即允许执行`window.alert()`等会产生弹出提示框的 JavaScript 方法。
48 | - `allow-popups`：允许嵌入的网页使用`window.open()`方法弹出窗口。
49 | - `allow-popups-to-escape-sandbox`：允许弹出窗口不受沙箱的限制。
50 | - `allow-orientation-lock`：允许嵌入的网页用脚本锁定屏幕的方向，即横屏或竖屏。
51 | - `allow-pointer-lock`：允许嵌入的网页使用 Pointer Lock API，锁定鼠标的移动。
52 | - `allow-presentation`：允许嵌入的网页使用 Presentation API。
53 | - `allow-same-origin`：不打开该项限制，将使得所有加载的网页都视为跨域。
54 | - `allow-scripts`：允许嵌入的网页运行脚本（但不创建弹出窗口）。
55 | - `allow-storage-access-by-user-activation`：`sandbox`属性同时设置了这个值和`allow-same-origin`的情况下，允许`<iframe>`嵌入的第三方网页通过用户发起`document.requestStorageAccess()`请求，经由 Storage Access API 访问父窗口的 Cookie。
56 | - `allow-top-navigation`：允许嵌入的网页对顶级窗口进行导航。
57 | - `allow-top-navigation-by-user-activation`：允许嵌入的网页对顶级窗口进行导航，但必须由用户激活。
58 | - `allow-downloads-without-user-activation`：允许在没有用户激活的情况下，嵌入的网页启动下载。
59 | 
60 | 注意，不要同时设置`allow-scripts`和`allow-same-origin`属性，这将使得嵌入的网页可以改变或删除`sandbox`属性。
61 | 
62 | ## loading 属性
63 | 
64 | `<iframe>`指定的网页会立即加载，有时这不是希望的行为。`<iframe>`滚动进入视口以后再加载，这样会比较节省带宽。
65 | 
66 | `loading`属性可以触发`<iframe>`网页的懒加载。该属性可以取以下三个值。
67 | 
68 | - `auto`：浏览器的默认行为，与不使用`loading`属性效果相同。
69 | - `lazy`：`<iframe>`的懒加载，即将滚动进入视口时开始加载。
70 | - `eager`：立即加载资源，无论在页面上的位置如何。
71 | 
72 | ```html
73 | <iframe src="https://example.com" loading="lazy"></iframe>
74 | ```
75 | 
76 | 上面代码会启用`<iframe>`的懒加载。
77 | 
78 | 有一点需要注意，如果`<iframe>`是隐藏的，则`loading`属性无效，将会立即加载。只要满足以下任一个条件，Chrome 浏览器就会认为`<iframe>`是隐藏的。
79 | 
80 | > - `<iframe>`的宽度和高度为4像素或更小。
81 | > - 样式设为`display: none`或`visibility: hidden`。
82 | > - 使用定位坐标为负`X`或负`Y`，将`<iframe`>放置在屏幕外。
83 | 
84 | 


--------------------------------------------------------------------------------
/docs/image.md:
--------------------------------------------------------------------------------
  1 | # 图像标签
  2 | 
  3 | 图片是互联网的重要组成部分，让网页变得丰富多彩。本章介绍如何在网页插入图片。
  4 | 
  5 | ## `<img>`
  6 | 
  7 | `<img>`标签用于插入图片。它是单独使用的，没有闭合标签。
  8 | 
  9 | ```html
 10 | <img src="foo.jpg">
 11 | ```
 12 | 
 13 | 上面代码在网页插入一张图片`foo.jpg`。`src`属性指定图片的网址，上例是相对 URL，表示图片与网页在同一个目录。
 14 | 
 15 | `<img>`默认是一个行内元素，与前后的文字处在同一行。
 16 | 
 17 | ```html
 18 | <p>Hello<img src="foo.jpg">World</p>
 19 | ```
 20 | 
 21 | 上面代码的渲染结果是，文字和图片在同一行显示。
 22 | 
 23 | 图像默认以原始大小显示。如果图片很大，又与文字处在同一行，那么图片将把当前行的行高撑高，并且图片的底边与文字的底边在同一条水平线上。
 24 | 
 25 | `<img>`可以放在`<a>`标签内部，使得图片变成一个可以点击的链接。
 26 | 
 27 | ```html
 28 | <a href="example.html">
 29 |   <img src="foo.jpg">
 30 | </a>
 31 | ```
 32 | 
 33 | 上面代码中，图片可以像链接那样点击，点击后会产生跳转。
 34 | 
 35 | **（1）alt 属性**
 36 | 
 37 | `alt`属性用来设定图片的文字说明。图片不显示时（比如下载失败，或用户关闭图片加载），图片的位置上会显示该文本。
 38 | 
 39 | ```html
 40 | <img src="foo.jpg" alt="示例图片">
 41 | ```
 42 | 
 43 | 上面代码中，`alt`是图片的说明。图片下载失败时，浏览器会在图片位置，显示文字“示例图片”。
 44 | 
 45 | **（2）width 属性，height 属性**
 46 | 
 47 | 图片默认以原始大小插入网页，`width`属性和`height`属性可以指定图片显示时的宽度和高度，单位是像素或百分比。
 48 | 
 49 | ```html
 50 | <img src="foo.jpg" width="400" height="300">
 51 | ```
 52 | 
 53 | 上面代码中，`width`属性指定图片显示的宽度为400像素，`height`属性指定显示高度为300像素。
 54 | 
 55 | 注意，一旦设置了这两个属性，浏览器会在网页中预先留出这个大小的空间，不管图片有没有加载成功。不过，由于图片的显示大小可以用 CSS 设置，所以不建议使用这两个属性。
 56 | 
 57 | 一种特殊情况是，`width`属性和`height`属性只设置了一个，另一个没有设置。这时，浏览器会根据图片的原始大小，自动设置对应比例的图片宽度或高度。举例来说，图片大小是 800像素 x 800像素，`width`属性设置成200，那么浏览器会自动将`height`设成200。
 58 | 
 59 | **（3）srcset，sizes**
 60 | 
 61 | 详见下文的《响应式图像》部分。
 62 | 
 63 | **（4）referrerpolicy**
 64 | 
 65 | `<img>`导致的图片加载的 HTTP 请求，默认会带有`Referer`的头信息。`referrerpolicy`属性对这个行为进行设置。
 66 | 
 67 | **（5）crossorigin**
 68 | 
 69 | 有时，图片和网页属于不同的网站，网页加载图片就会导致跨域请求，对方服务器可能要求跨域认证。`crossorigin`属性用来告诉浏览器，是否采用跨域的形式下载图片，默认是不采用。
 70 | 
 71 | 简单说，只要打开了这个属性，HTTP 请求的头信息里面，就会加入`origin`字段，给出请求发出的域名，不打开这个属性就不加。
 72 | 
 73 | 一旦打开该属性，它可以设为两个值。
 74 | 
 75 | - `anonymous`：跨域请求不带有用户凭证（通常是 Cookie）。
 76 | - `use-credentials`：跨域请求带有用户凭证。
 77 | 
 78 | 下面是一个例子。
 79 | 
 80 | ```html
 81 | <img src="foo.jpg" crossorigin="anonymous">
 82 | ```
 83 | 
 84 | `crossorigin`属性如果省略值的部分，则等同于`anonymous`。
 85 | 
 86 | ```html
 87 | <img src="foo.jpg" crossorigin>
 88 | ```
 89 | 
 90 | **（6）loading**
 91 | 
 92 | 浏览器的默认行为是，只要解析到`<img>`标签，就开始加载图片。对于很长的网页，这样做很浪费带宽，因为用户不一定会往下滚动，一直看到网页结束。用户很可能是点开网页，看了一会就关掉了，那些不在视口的图片加载的流量，就都浪费了。
 93 | 
 94 | `loading`属性改变了这个行为，可以指定图片的懒加载，即图片默认不加载，只有即将滚动进入视口，变成用户可见时才会加载，这样就节省了带宽。
 95 | 
 96 | `loading`属性可以取以下三个值。
 97 | 
 98 | > - `auto`：浏览器默认行为，等同于不使用`loading`属性。
 99 | > - `lazy`：启用懒加载。
100 | > - `eager`：立即加载资源，无论它在页面上的哪个位置。
101 | 
102 | ```html
103 | <img src="image.png" loading="lazy" alt="…" width="200" height="200">
104 | ```
105 | 
106 | 由于行内图片的懒加载，可能会导致页面布局重排，所以使用这个属性的时候，最好指定图片的高和宽。
107 | 
108 | ## `<figure>`，`<figcaption>`
109 | 
110 | `<figure>`标签可以理解为一个图像区块，将图像和相关信息封装在一起。`<figcaption>`是它的可选子元素，表示图像的文本描述，通常用于放置标题，可以出现多个。
111 | 
112 | ```html
113 | <figure>
114 |   <img src="https://example.com/foo.jpg">
115 |   <figcaption>示例图片</figcaption>
116 | </figure>
117 | ```
118 | 
119 | 除了图像，`<figure>`还可以封装引言、代码、诗歌等等。它等于是一个将主体内容与附加信息，封装在一起的语义容器。
120 | 
121 | ```html
122 | <figure>
123 |   <figcaption>JavaScript 代码示例</figcaption>
124 |   <p><code>const foo = 'hello';</code></p>
125 | </figure>
126 | ```
127 | 
128 | ## 响应式图像
129 | 
130 | 网页在不同尺寸的设备上，都能产生良好的显示效果，叫做[“响应式设计”](http://www.ruanyifeng.com/blog/2012/05/responsive_web_design.html)（responsive web design）。响应式设计的网页图像，就是“响应式图像”（responsive image）。
131 | 
132 | 响应式图像的解决方案有很多，JavaScript 和 CSS 都可以实现。这里只介绍语义性最好的 HTML 方法，浏览器原生支持。
133 | 
134 | ### 问题的由来
135 | 
136 | 我们知道，`<img>`标签用于插入网页图像，所有情况默认插入的都是同一张图像。
137 | 
138 | ```html
139 | <img src="foo.jpg">
140 | ```
141 | 
142 | 上面代码在桌面端和手机上，插入的都是图像文件`foo.jpg`。
143 | 
144 | 这种处理方法固然简单，但是有三大弊端。
145 | 
146 | **（1）体积**
147 | 
148 | 一般来说，桌面端显示的是大尺寸的图像，文件体积较大。手机的屏幕较小，只需要小尺寸的图像，可以节省带宽，加速网页渲染。
149 | 
150 | **（2）像素密度**
151 | 
152 | 桌面显示器一般是单倍像素密度，而手机的显示屏往往是多倍像素密度，即显示时多个像素合成为一个像素，这种屏幕称为 Retina 屏幕。图像文件很可能在桌面端很清晰，放到手机上会有点模糊，因为图像没有那么高的像素密度，浏览器自动把图像的每个像素复制到周围像素，满足像素密度的要求，导致图像的锐利度有所下降。
153 | 
154 | **（3）视觉风格**
155 | 
156 | 桌面显示器的面积较大，图像可以容纳更多细节。手机的屏幕较小，许多细节是看不清的，需要突出重点。
157 | 
158 | ![](https://www.wangbase.com/blogimg/asset/201906/bg2019061002.jpg)
159 | 
160 | ![](https://www.wangbase.com/blogimg/asset/201906/bg2019061003.jpg)
161 | 
162 | 上面两张图片，下方的手机图片经过裁剪以后，更突出图像重点，明显效果更好。
163 | 
164 | ### `srcset`属性
165 | 
166 | 为了解决上面这些问题，HTML 语言提供了一套完整的解决方案。首先，`<img>`标签引入了`srcset`属性。
167 | 
168 | `srcset`属性用来指定多张图像，适应不同像素密度的屏幕。它的值是一个逗号分隔的字符串，每个部分都是一张图像的 URL，后面接一个空格，然后是像素密度的描述符。请看下面的例子。
169 | 
170 | ```html
171 | <img srcset="foo-320w.jpg,
172 |              foo-480w.jpg 1.5x,
173 |              foo-640w.jpg 2x"
174 |      src="foo-640w.jpg">
175 |  ```
176 | 
177 | 上面代码中，`srcset`属性给出了三个图像 URL，适应三种不同的像素密度。
178 | 
179 | 图像 URL 后面的像素密度描述符，格式是像素密度倍数 + 字母`x`。`1x`表示单倍像素密度，可以省略。浏览器根据当前设备的像素密度，选择需要加载的图像。
180 | 
181 | 如果`srcset`属性都不满足条件，那么就加载`src`属性指定的默认图像。
182 | 
183 | ### `sizes`属性
184 | 
185 | 像素密度的适配，只适合显示区域一样大小的图像。如果希望不同尺寸的屏幕，显示不同大小的图像，`srcset`属性就不够用了，必须搭配`sizes`属性。
186 | 
187 | 第一步，`srcset`属性列出所有可用的图像。
188 | 
189 | ```html
190 | <img srcset="foo-160.jpg 160w,
191 |              foo-320.jpg 320w,
192 |              foo-640.jpg 640w,
193 |              foo-1280.jpg 1280w"
194 |      src="foo-1280.jpg">
195 | ```
196 | 
197 | 上面代码中，`srcset`属性列出四张可用的图像，每张图像的 URL 后面是一个空格，再加上宽度描述符。
198 | 
199 | 宽度描述符就是图像原始的宽度，加上字符`w`。上例的四种图片的原始宽度分别为160像素、320像素、640像素和1280像素。
200 | 
201 | 第二步，`sizes`属性列出不同设备的图像显示宽度。
202 | 
203 | `sizes`属性的值是一个逗号分隔的字符串，除了最后一部分，前面每个部分都是一个放在括号里面的媒体查询表达式，后面是一个空格，再加上图像的显示宽度。
204 | 
205 | ```html
206 | <img srcset="foo-160.jpg 160w,
207 |              foo-320.jpg 320w,
208 |              foo-640.jpg 640w,
209 |              foo-1280.jpg 1280w"
210 |      sizes="(max-width: 440px) 100vw,
211 |             (max-width: 900px) 33vw,
212 |             254px"
213 |      src="foo-1280.jpg">
214 | ```
215 | 
216 | 上面代码中，`sizes`属性给出了三种屏幕条件，以及对应的图像显示宽度。宽度不超过440像素的设备，图像显示宽度为100%；宽度441像素到900像素的设备，图像显示宽度为33%；宽度900像素以上的设备，图像显示宽度为`254px`。
217 | 
218 | 第三步，浏览器根据当前设备的宽度，从`sizes`属性获得图像的显示宽度，然后从`srcset`属性找出最接近该宽度的图像，进行加载。
219 | 
220 | 假定当前设备的屏幕宽度是`480px`，浏览器从`sizes`属性查询得到，图片的显示宽度是`33vw`（即33%），等于`160px`。`srcset`属性里面，正好有宽度等于`160px`的图片，于是加载`foo-160.jpg`。
221 | 
222 | 如果省略`sizes`属性，那么浏览器将根据实际的图像显示宽度，从`srcset`属性选择最接近的图片。一旦使用`sizes`属性，就必须与`srcset`属性搭配使用，单独使用`sizes`属性是无效的。
223 | 
224 | ## `<picture>`
225 | 
226 | ### 响应式用法
227 | 
228 | `<img>`标签的`srcset`属性和`sizes`属性分别解决了像素密度和屏幕大小的适配，但如果要同时适配不同像素密度、不同大小的屏幕，就要用到`<picture>`标签。
229 | 
230 | `<picture>`是一个容器标签，内部使用`<source>`和`<img>`，指定不同情况下加载的图像。
231 | 
232 | ```html
233 | <picture>
234 |   <source media="(max-width: 500px)" srcset="cat-vertical.jpg">
235 |   <source media="(min-width: 501px)" srcset="cat-horizontal.jpg">
236 |   <img src="cat.jpg" alt="cat">
237 | </picture>
238 | ```
239 | 
240 | 上面代码中，`<picture>`标签内部有两个`<source>`标签和一个`<img>`标签。
241 | 
242 | `<picture>`内部的`<source>`标签，主要使用`media`属性和`srcset`属性。`media`属性给出媒体查询表达式，`srcset`属性就是`<img>`标签的`srcset`属性，给出加载的图像文件。`sizes`属性其实这里也可以用，但由于有了`media`属性，就没有必要了。
243 | 
244 | 浏览器按照`<source>`标签出现的顺序，依次判断当前设备是否满足`media`属性的媒体查询表达式，如果满足就加载`srcset`属性指定的图片文件，并且不再执行后面的`<source>`标签和`<img>`标签。
245 | 
246 | `<img>`标签是默认情况下加载的图像，用来满足上面所有`<source>`都不匹配的情况，或者不支持`<picture>`的老式浏览器。
247 | 
248 | 上面例子中，设备宽度如果不超过`500px`，就加载竖屏的图像，否则加载横屏的图像。
249 | 
250 | 下面给出一个例子，同时考虑屏幕尺寸和像素密度的适配。
251 | 
252 | ```html
253 | <picture>
254 |   <source srcset="homepage-person@desktop.png,
255 |                   homepage-person@desktop-2x.png 2x"
256 |           media="(min-width: 990px)">
257 |   <source srcset="homepage-person@tablet.png,
258 |                   homepage-person@tablet-2x.png 2x"
259 |           media="(min-width: 750px)">
260 |   <img srcset="homepage-person@mobile.png,
261 |                homepage-person@mobile-2x.png 2x"
262 |        alt="Shopify Merchant, Corrine Anestopoulos">
263 | </picture>
264 | ```
265 | 
266 | 上面代码中，`<source>`标签的`media`属性给出屏幕尺寸的适配条件，每个条件都用`srcset`属性，再给出两种像素密度的图像 URL。
267 | 
268 | ### 图像格式的选择
269 | 
270 | 除了响应式图像，`<picture>`标签还可以用来选择不同格式的图像。比如，如果当前浏览器支持 Webp 格式，就加载这种格式的图像，否则加载 PNG 图像。
271 | 
272 | ```html
273 | <picture>
274 |   <source type="image/svg+xml" srcset="logo.xml">
275 |   <source type="image/webp" srcset="logo.webp"> 
276 |   <img src="logo.png" alt="ACME Corp">
277 | </picture>
278 | ```
279 | 
280 | 上面代码中，`<source>`标签的`type`属性给出图像的 MIME 类型，`srcset`是对应的图像 URL。
281 | 
282 | 浏览器按照`<source>`标签出现的顺序，依次检查是否支持`type`属性指定的图像格式，如果支持就加载图像，并且不再检查后面的`<source>`标签了。上面例子中，图像加载优先顺序依次为 svg 格式、webp 格式和 png 格式。
283 | 
284 | ## 参考链接
285 | 
286 | - [Responsive Images 101](https://cloudfour.com/thinks/responsive-images-101-definitions/), Jason Grigsby
287 | - [Responsive images](https://developer.mozilla.org/en-US/docs/Learn/HTML/Multimedia_and_embedding/Responsive_images), MDN
288 | - [Native lazy-loading for the web](https://web.dev/native-lazy-loading), Houssein Djirdeh
289 | 
290 | 


--------------------------------------------------------------------------------
/docs/intro.md:
--------------------------------------------------------------------------------
  1 | # HTML 语言简介
  2 | 
  3 | ## 概述
  4 | 
  5 | HTML 是网页使用的语言，定义了网页的结构和内容。浏览器访问网站，其实就是从服务器下载 HTML 代码，然后渲染出网页。
  6 | 
  7 | HTML 的全名是“超文本标记语言”（HyperText Markup Language），上个世纪90年代由欧洲核子研究中心的物理学家蒂姆·伯纳斯-李（Tim Berners-Lee）发明。它的最大特点就是支持超链接，点击链接就可以跳转到其他网页，从而构成了整个互联网。
  8 | 
  9 | 1999年，HTML 4.01 版发布，成为广泛接受的 HTML 标准。2014年，HTML 5 发布，这是目前正在使用的版本。
 10 | 
 11 | 浏览器的网页开发，涉及三种技术：HTML、CSS 和 JavaScript。HTML 语言定义网页的结构和内容，CSS 样式表定义网页的样式，JavaScript 语言定义网页与用户的互动行为。HTML 语言是网页开发的基础，CSS 和 JavaScript 都是基于 HTML 才能生效，即使没有这两者，HTML 本身也能使用，可以完成基本的内容展示。本教程只介绍 HTML 语言。
 12 | 
 13 | 下面就是一个简单网页的 HTML 源码。
 14 | 
 15 | ```html
 16 | <!DOCTYPE html>
 17 | <html lang="zh-CN">
 18 | <head>
 19 |   <meta charset="utf-8">
 20 |   <title>网页标题</title>
 21 | </head>
 22 | <body>
 23 |   <p>Hello World</p>
 24 | </body>
 25 | </html>
 26 | ```
 27 | 
 28 | 上面这段代码，可以保存成文件`hello.html`。浏览器打开这个本地文件，就能看到文字“Hello World”。
 29 | 
 30 | 浏览器右键菜单的“查看源码”（View page source），可以展示当前网页的 HTML 源码。
 31 | 
 32 | ## 网页的基本概念
 33 | 
 34 | ### 标签
 35 | 
 36 | 网页的 HTML 代码由许许多多不同的标签（tag）构成。学习 HTML 语言，就是学习各种标签的用法。
 37 | 
 38 | 下面就是标签的一个例子。
 39 | 
 40 | ```html
 41 | <title>网页标题</title>
 42 | ```
 43 | 
 44 | 上面代码中，`<title>`和`</title>`就是一对标签。
 45 | 
 46 | 标签用来告诉浏览器，如何处理这段代码。标签的内容就是浏览器所要渲染的、展示在网页上的内容。
 47 | 
 48 | 标签放在一对尖括号里面（比如`<title>`），大多数标签都是成对出现的，分成开始标签和结束标签，结束标签在标签名之前加斜杠（比如`</title>`）。但是，也有一些标签不是成对使用，而是只有开始标签，没有结束标签，比如上一节示例的`<meta>`标签。
 49 | 
 50 | ```html
 51 | <meta charset="utf-8">
 52 | ```
 53 | 
 54 | 上面代码中，`<meta>`标签就没有结束标签`</meta>`。
 55 | 
 56 | 这种单独使用的标签，通常是因为标签本身就足够完成功能了，不需要标签之间的内容。实际应用中，它们主要用来提示浏览器，做一些特别处理。
 57 | 
 58 | 标签可以嵌套。
 59 | 
 60 | ```html
 61 | <div><p>hello world</p></div>
 62 | ```
 63 | 
 64 | 上面代码中，`<div>`标签内部包含了一个`<p>`标签。
 65 | 
 66 | 嵌套时，必须保证正确的闭合顺序，不能跨层嵌套，否则会出现意想不到的渲染结果。
 67 | 
 68 | ```html
 69 | <div><p>hello world</div></p>
 70 | ```
 71 | 
 72 | 上面代码就是错误的嵌套，闭合顺序不正确。
 73 | 
 74 | HTML 标签名是大小写不敏感，比如`<title>`和`<TITLE>`是同一个标签。不过，一般习惯都是使用小写。
 75 | 
 76 | 另外，HTML 语言忽略缩进和换行。下面几种写法的渲染结果是一样的。
 77 | 
 78 | ```html
 79 | <title>网页标题</title>
 80 | 
 81 | <title>
 82 |   网页标题
 83 | </title>
 84 | 
 85 | <title>网页
 86 | 标题</title>
 87 | ```
 88 | 
 89 | 进一步说，整个网页的 HTML 代码完全可以写成一行，浏览器照样解析，结果完全一样。所以，正式发布网页之前，开发者有时会把源码压缩成一行，以减少传输的字节数。
 90 | 
 91 | 各种网页的样式效果，比如内容的缩进和换行，主要靠 CSS 来实现。
 92 | 
 93 | ### 元素
 94 | 
 95 | 浏览器渲染网页时，会把 HTML 源码解析成一个标签树，每个标签都是树的一个节点（node）。这种节点就称为网页元素（element）。所以，“标签”和“元素”基本上是同义词，只是使用的场合不一样：标签是从源码角度来看，元素是从编程角度来看，比如`<p>`标签对应网页的`p`元素。
 96 | 
 97 | 嵌套的标签就构成了网页元素的层级关系。
 98 | 
 99 | ```html
100 | <div><p>hello world</p></div>
101 | ```
102 | 
103 | 上面代码中，`div`元素内部包含了一个`p`元素。上层元素又称为“父元素”，下层元素又称为“子元素”，即`div`是`p`的父元素，`p`是`div`的子元素。
104 | 
105 | ### 块级元素，行内元素
106 | 
107 | 所有元素可以分成两大类：块级元素（block）和行内元素（inline）。
108 | 
109 | 块级元素默认占据一个独立的区域，在网页上会自动另起一行，占据 100% 的宽度。
110 | 
111 | ```html
112 | <p>hello</p>
113 | <p>world</p>
114 | ```
115 | 
116 | 上面代码中，`p`元素是块级元素，因此浏览器会将内容分成两行显示。
117 | 
118 | 行内元素默认与其他元素在同一行，不产生换行。比如，`span`就是行内元素，通常用来为某些文字指定特别的样式。
119 | 
120 | ```html
121 | <span>hello</span>
122 | <span>world</span>
123 | ```
124 | 
125 | 上面代码中，`span`元素是行内元素，因此浏览器会将两行内容放在一行显示。
126 | 
127 | ### 属性
128 | 
129 | 属性（attribute）是标签的额外信息，使用空格与标签名和其他属性分隔。
130 | 
131 | ```html
132 | <img src="demo.jpg" width="500">
133 | ```
134 | 
135 | 上面代码中，`<img>`标签有两个属性：`src`和`width`。
136 | 
137 | 属性可以用等号指定属性值，比如上例的`demo.jpg`就是`src`的属性值。属性值一般放在双引号里面，这不是必需的，但推荐总是使用双引号。
138 | 
139 | 注意，属性名是大小写不敏感的，`onclick`和`onClick`是同一个属性。
140 | 
141 | HTML 提供大量属性，用来定制标签的行为，详细介绍请看《元素的属性》一章。
142 | 
143 | ## 网页的基本标签
144 | 
145 | 符合 HTML 语法标准的网页，应该满足下面的基本结构。
146 | 
147 | ```html
148 | <!DOCTYPE html>
149 | <html lang="zh-CN">
150 | <head>
151 |   <meta charset="utf-8">
152 |   <title></title>
153 | </head>
154 | <body>
155 | </body>
156 | </html>
157 | ```
158 | 
159 | 不管多么复杂的网页，都是从上面这个基本结构衍生出来的。
160 | 
161 | 前面说过，HTML 代码的缩进和换行，对于浏览器不产生作用。所以，上面的代码完全可以写成一行，渲染结果不变。上面这样分行写，只是为了提高可读性。
162 | 
163 | 下面就依次介绍，这个基本结构的主要标签。它们构成了网页的骨架。
164 | 
165 | ### `<!doctype>`
166 | 
167 | 网页的第一个标签通常是`<!doctype>`，表示文档类型，告诉浏览器如何解析网页。
168 | 
169 | 一般来说，只要像下面这样，简单声明`doctype`为`html`即可。浏览器就会按照 HTML 5 的规则处理网页。
170 | 
171 | ```html
172 | <!doctype html>
173 | ```
174 | 
175 | 有时，该标签采用完全大写的形式，以便区别于正常的 HTML 标签。因为`<!doctype>`本质上不是标签，更像一个处理指令。
176 | 
177 | ```html
178 | <!DOCTYPE html>
179 | ```
180 | 
181 | ### `<html>`
182 | 
183 | `<html>`标签是网页的顶层容器，即标签树结构的顶层节点，也称为根元素（root element），其他元素都是它的子元素。一个网页只能有一个`<html>`标签。
184 | 
185 | 该标签的`lang`属性，表示网页内容默认的语言。
186 | 
187 | ```html
188 | <html lang="zh-CN">
189 | ```
190 | 
191 | 上面代码表示，网页是中文内容。如果是英文内容，`zh-CN`要改成`en`。更详细的介绍，参见《元素的属性》一章。
192 | 
193 | ### `<head>`
194 | 
195 | `<head>`标签是一个容器标签，用于放置网页的元信息。它的内容不会出现在网页上，而是为网页渲染提供额外信息。
196 | 
197 | ```html
198 | <!doctype html>
199 | <html>
200 |   <head>
201 |     <title>网页标题</title>
202 |   </head>
203 | </html>
204 | ```
205 | 
206 | `<head>`是`<html>`的第一个子元素。如果网页不包含`<head>`，浏览器会自动创建一个。
207 | 
208 | `<head>`的子元素一般有下面七个，后文会一一介绍。
209 | 
210 | - `<meta>`：设置网页的元数据。
211 | - `<link>`：连接外部样式表。
212 | - `<title>`：设置网页标题。
213 | - `<style>`：放置内嵌的样式表。
214 | - `<script>`：引入脚本。
215 | - `<noscript>`：浏览器不支持脚本时，所要显示的内容。
216 | - `<base>`：设置网页内部相对 URL 的计算基准。
217 | 
218 | ### `<meta>`
219 | 
220 | `<meta>`标签用于设置或说明网页的元数据，必须放在`<head>`里面。一个`<meta>`标签就是一项元数据，网页可以有多个`<meta>`。`<meta>`标签约定放在`<head>`内容的最前面。
221 | 
222 | 不管什么样的网页，一般都可以放置以下两个`<meta>`标签。
223 | 
224 | ```html
225 | <head>
226 |   <meta charset="utf-8">
227 |   <meta name="viewport" content="width=device-width, initial-scale=1">
228 |   <title>Page Title</title>
229 | </head>
230 | ```
231 | 
232 | 上面例子中，第一个`<meta>`标签表示网页采用 UTF-8 格式编码，第二个`<meta>`标签表示网页在手机端可以自动缩放。
233 | 
234 | `<meta>`标签有五个属性，下面依次介绍。
235 | 
236 | **（1）charset 属性**
237 | 
238 | `<meta>`标签的`charset`属性，用来指定网页的编码方式。该属性非常重要，如果设置得不正确，浏览器可能无法正确解码，就会显示乱码。
239 | 
240 | ```html
241 | <meta charset="utf-8">
242 | ```
243 | 
244 | 上面代码声明，网页为 UTF-8 编码。虽然开发者可以使用其他的编码方式，但正确的做法几乎总是应该采用 UTF-8。
245 | 
246 | 注意，这里声明的编码方式，应该与网页实际的编码方式一致，即声明了`utf-8`，网页就应该使用 UTF-8 编码保存。如果这里声明了`utf-8`，实际却是使用另一种编码（比如 GB2312），并不会导致浏览器的自动转码，网页可能会显示为乱码。
247 | 
248 | **（2）name 属性，content 属性**
249 | 
250 | `<meta>`标签的`name`属性表示元数据的名字，`content`属性表示元数据的值。它们合在一起使用，就可以为网页指定一项元数据。
251 | 
252 | ```html
253 | <head>
254 |   <meta name="description" content="HTML 语言入门">
255 |   <meta name="keywords" content="HTML,教程">
256 |   <meta name="author" content="张三">
257 | </head>
258 | ```
259 | 
260 | 上面代码包含了三个元数据：`description`是网页内容的描述，`keywords`是网页内容的关键字，`author`是网页作者。
261 | 
262 | 元数据有很多种，大部分涉及浏览器内部工作机制，或者特定的使用场景，这里就不一一介绍了。下面是一些例子。
263 | 
264 | ```html
265 | <meta name="viewport" content="width=device-width, initial-scale=1">
266 | <meta name="application-name" content="Application Name">
267 | <meta name="generator" content="program">
268 | <meta name="subject" content="your document's subject">
269 | <meta name="referrer" content="no-referrer">
270 | ```
271 | 
272 | **（3）http-equiv 属性，content 属性**
273 | 
274 | `<meta>`标签的`http-equiv`属性用来补充 HTTP 回应的头信息字段，如果服务器发回的 HTTP 回应缺少某个字段，就可以用它补充。`<meta>`标签的`content`属性是对应的字段内容。这两个属性与 HTTP 协议相关，属于高级用法，这里就不详细介绍了。
275 | 
276 | ```html
277 | <meta http-equiv="Content-Security-Policy" content="default-src 'self'">
278 | ```
279 | 
280 | 上面代码设定 HTTP 回应的`Content-Security-Policy`字段。
281 | 
282 | 下面是另一些例子。
283 | 
284 | ```html
285 | <meta http-equiv="Content-Type" content="Type=text/html; charset=utf-8">
286 | <meta http-equiv="refresh" content="30">
287 | <meta http-equiv="refresh" content="30;URL='http://website.com'">
288 | ```
289 | 
290 | ### `<title>`
291 | 
292 | `<title>`标签用于指定网页的标题，会显示在浏览器窗口的标题栏。
293 | 
294 | ```html
295 | <head>
296 |   <title>网页标题</title>
297 | </head>
298 | ```
299 | 
300 | 搜索引擎根据这个标签，显示每个网页的标题。它对于网页在搜索引擎的排序，有很大的影响，应该精心安排，反映网页的主题。
301 | 
302 | `<title>`标签的内部，不能再放置其他标签，只能放置无格式的纯文本。
303 | 
304 | ### `<body>`
305 | 
306 | `<body>`标签是一个容器标签，用于放置网页的主体内容。浏览器显示的页面内容，都放置在它的内部。它是`<html>`的第二个子元素，紧跟在`<head>`后面。
307 | 
308 | ```html
309 | <html>
310 |   <head>
311 |     <title>网页标题</title>
312 |   </head>
313 |   <body>
314 |     <p>hello world</p>
315 |   </body>
316 | </html>
317 | ```
318 | 
319 | ## 空格和换行
320 | 
321 | HTML 语言有自己的空格处理规则。标签内容的头部和尾部的空格，一律忽略不计。
322 | 
323 | ```html
324 | <p>  hello world   </p>
325 | ```
326 | 
327 | 上面代码中，`hello`前面的空格和`world`后面的空格，浏览器一律忽略不计。
328 | 
329 | 标签内容里面的多个连续空格（包含制表符`\t`），会被浏览器合并成一个。
330 | 
331 | ```html
332 | <p>hello      world</p>
333 | ```
334 | 
335 | 上面代码中，`hello`与`world`之间有多个连续空格，浏览器会将它们合并成一个。网页渲染的结果是，`hello`与`world`之间只有一个空格。
336 | 
337 | 浏览器还会将文本里面的换行符（`\n`）和回车符（`\r`），替换成空格。
338 | 
339 | ```html
340 | <p>hello
341 | 
342 | 
343 | 
344 | world
345 | </p>
346 | ```
347 | 
348 | 上面代码中，`hello`与`world`之间有多个换行，浏览器会将它们替换成空格，然后再将多个空格合并成一个。网页渲染的结果是，`hello`与`world`之间有一个空格。
349 | 
350 | 这意味着，HTML 源码里面的换行，不会产生换行效果。
351 | 
352 | ## 注释
353 | 
354 | HTML 代码可以包含注释，浏览器会自动忽略注释。注释以`<!--`开头，以`-->`结尾，下面就是一个注释的例子。
355 | 
356 | ```html
357 | <!-- 这是一个注释 -->
358 | ```
359 | 
360 | 注释可以是多行的，并且内部的 HTML 都不再生效了。
361 | 
362 | ```html
363 | <!--
364 |   <p>hello world</p>
365 | -->
366 | ```
367 | 
368 | 上面代码是一个注释的区块，内部的代码都是无效的，浏览器不会解析，更不会渲染它们。
369 | 
370 | 注释有助于理解代码的含义，复杂的代码块前面最好加上注释。
371 | 
372 | 


--------------------------------------------------------------------------------
/docs/link.md:
--------------------------------------------------------------------------------
  1 | # <link>
  2 | 
  3 | ## 简介
  4 | 
  5 | `<link>`标签主要用于将当前网页与相关的外部资源联系起来，通常放在`<head>`元素里面。最常见的用途就是加载 CSS 样式表。
  6 | 
  7 | ```html
  8 | <link rel="stylesheet" type="text/css" href="theme.css">
  9 | ```
 10 | 
 11 | 上面代码为网页加载样式表`theme.css`。
 12 | 
 13 | 除了默认样式表，网页还可以加载替代样式表，即默认不生效、需要用户手动切换的样式表。
 14 | 
 15 | ```html
 16 | <link href="default.css" rel="stylesheet" title="Default Style">
 17 | <link href="fancy.css" rel="alternate stylesheet" title="Fancy">
 18 | <link href="basic.css" rel="alternate stylesheet" title="Basic">
 19 | ```
 20 | 
 21 | 上面代码中，`default.css`是默认样式表，默认就会生效。`fancy.css`和`basic.css`是替换样式表（`rel="alternate stylesheet"`），默认不生效。`title`属性在这里是必需的，用来在浏览器菜单里面列出这些样式表的名字，供用户选择，以替代默认样式表。
 22 | 
 23 | `<link>`还可以加载网站的 favicon 图标文件。
 24 | 
 25 | ```html
 26 | <link rel="icon" href="/favicon.ico" type="image/x-icon">
 27 | ```
 28 | 
 29 | 手机访问时，网站通常需要提供不同分辨率的图标文件。
 30 | 
 31 | ```html
 32 | <link rel="apple-touch-icon-precomposed" sizes="114x114" href="favicon114.png">
 33 | <link rel="apple-touch-icon-precomposed" sizes="72x72" href="favicon72.png">
 34 | ```
 35 | 
 36 | 上面代码指定 iPhone 设备需要的114像素和72像素的图标。
 37 | 
 38 | `<link>`也用于提供文档的相关链接，比如下面是给出文档的 RSS Feed 地址。
 39 | 
 40 | ```html
 41 | <link rel="alternate" type="application/atom+xml" href="/blog/news/atom">
 42 | ```
 43 | 
 44 | ## href 属性
 45 | 
 46 | `href`属性表示`<link>`标签所链接的资源。
 47 | 
 48 | ## rel 属性
 49 | 
 50 | `rel`属性表示外部资源与当前文档之间的关系，是`<link>`标签的必需属性，可以视为对`href`属性所链接资源的说明。
 51 | 
 52 | 它可以但不限于取以下值。
 53 | 
 54 | - `alternate`：文档的另一种表现形式的链接，比如打印版。
 55 | - `author`：文档作者的链接。
 56 | - `dns-prefetch`：要求浏览器提前执行指定网址的 DNS 查询。
 57 | - `help`：帮助文档的链接。
 58 | - `icon`：加载文档的图标文件。
 59 | - `license`：许可证链接。
 60 | - `next`：系列文档下一篇的链接。
 61 | - `pingback`：接收当前文档 pingback 请求的网址。
 62 | - `preconnect`：要求浏览器提前与给定服务器，建立 HTTP 连接。
 63 | - `prefetch`：要求浏览器提前下载并缓存指定资源，供下一个页面使用。它的优先级较低，浏览器可以不下载。
 64 | - `preload`：要求浏览器提前下载并缓存指定资源，当前页面稍后就会用到。它的优先级较高，浏览器必须立即下载。
 65 | - `prerender`：要求浏览器提前渲染指定链接。这样的话，用户稍后打开该链接，就会立刻显示，感觉非常快。
 66 | - `prev`：表示当前文档是系列文档的一篇，这里给出上一篇文档的链接。
 67 | - `search`：提供当前网页的搜索链接。
 68 | - `stylesheet`：加载一张样式表。
 69 | 
 70 | 下面是一些示例。
 71 | 
 72 | ```html
 73 | <!-- 作者信息 -->
 74 | <link rel="author" href="humans.txt">
 75 | 
 76 | <!-- 版权信息 -->
 77 | <link rel="license" href="copyright.html">
 78 | 
 79 | <!-- 另一个语言的版本 -->
 80 | <link rel="alternate" href="https://es.example.com/" hreflang="es">
 81 | 
 82 | <!-- 联系方式 -->
 83 | <link rel="me" href="https://google.com/profiles/someone" type="text/html">
 84 | <link rel="me" href="mailto:name@example.com">
 85 | <link rel="me" href="sms:+15035550125">
 86 | 
 87 | <!-- 历史资料 -->
 88 | <link rel="archives" href="http://example.com/archives/">
 89 | 
 90 | <!-- 目录 -->
 91 | <link rel="index" href="http://example.com/article/">
 92 | 
 93 | <!-- 导航 -->
 94 | <link rel="first" href="http://example.com/article/">
 95 | <link rel="last" href="http://example.com/article/?page=42">
 96 | <link rel="prev" href="http://example.com/article/?page=1">
 97 | <link rel="next" href="http://example.com/article/?page=3">
 98 | ```
 99 | 
100 | ## hreflang 属性
101 | 
102 | `hreflang`属性用来表示`href`属性链接资源的所用语言，通常指当前页面的其他语言版本。
103 | 
104 | ```html
105 | <link href="https://example.com/de" rel="alternate" hreflang="de" />
106 | ```
107 | 
108 | 上面示例中，`hreflang`表示`href`属性所链接页面使用德语，即当前页面的德语版本。
109 | 
110 | 如果一个页面有多个语言的版本，`hreflang`属性可以设为`x-default`，表示哪一个页面是默认版本。
111 | 
112 | ```html
113 | <link href="https://example.com" rel="alternate" hreflang="x-default" />
114 | <link href="https://example.com/de" rel="alternate" hreflang="de" />
115 | ```
116 | 
117 | 上面示例中，`hreflang`设为`x-default`表示该页面为默认版本。
118 | 
119 | ## 资源的预加载
120 | 
121 | 某些情况下，你需要浏览器预加载某些资源，也就是先把资源缓存下来，等到使用的时候，就不用再从网上下载了，立即就能使用。预处理指令可以做到这一点。
122 | 
123 | 预加载主要有下面五种类型。
124 | 
125 | ### `<link rel="preload">`
126 | 
127 | `<link rel="preload">`告诉浏览器尽快下载并缓存资源（如脚本或样式表），该指令优先级较高，浏览器肯定会执行。当加载页面几秒钟后需要该资源时，它会很有用。下载后，浏览器不会对资源执行任何操作，脚本未执行，样式表未应用。它只是缓存，当其他东西需要它时，它立即可用。
128 | 
129 | ```html
130 | <link rel="preload" href="image.png" as="image">
131 | ```
132 | 
133 | `rel="preload"`除了优先级较高，还有两个优点：一是允许指定预加载资源的类型，二是允许`onload`事件的回调函数。下面是`rel="preload"`配合`as`属性，告诉浏览器预处理资源的类型，以便正确处理。
134 | 
135 | ```html
136 | <link rel="preload" href="style.css" as="style">
137 | <link rel="preload" href="main.js" as="script">
138 | ```
139 | 
140 | 上面代码要求浏览器提前下载并缓存`style.css`和`main.js`。
141 | 
142 | `as`属性指定加载资源的类型，它的值一般有下面几种。
143 | 
144 | - "script"
145 | - "style"
146 | - "image"
147 | - "media"
148 | - "document"
149 | 
150 | 如果不指定`as`属性，或者它的值是浏览器不认识的，那么浏览器会以较低的优先级下载这个资源。
151 | 
152 | 有时还需要`type`属性，进一步明确 MIME 类型。
153 | 
154 | ```html
155 | <link rel="preload" href="sintel-short.mp4" as="video" type="video/mp4">
156 | ```
157 | 
158 | 上面代码要求浏览器提前下载视频文件，并且说明这是 MP4 编码。
159 | 
160 | 下面是预下载字体文件的例子。
161 | 
162 | ```html
163 | <link rel="preload" href="font.woff2" as="font" type="font/woff2" crossorigin>
164 | ```
165 | 
166 | 注意，所有预下载的资源，只是下载到浏览器的缓存，并没有执行。如果希望资源预下载后立刻执行，可以参考下面的写法。
167 | 
168 | ```html
169 | <link rel="preload" as="style" href="async_style.css" onload="this.rel='stylesheet'">
170 | ```
171 | 
172 | 上面代码中，`onload`指定的回调函数会在脚本下载完成后执行，立即插入页面。
173 | 
174 | ### `<link rel="prefetch">`
175 | 
176 | `<link rel="prefetch">`的使用场合是，如果后续的页面需要某个资源，并且希望预加载该资源，以便加速页面渲染。该指令不是强制性的，优先级较低，浏览器不一定会执行。这意味着，浏览器可以不下载该资源，比如连接速度很慢时。
177 | 
178 | ```html
179 | <link rel="prefetch" href="https://www.example.com/">
180 | ```
181 | 
182 | ### `<link rel="preconnect">`
183 | 
184 | `<link rel="preconnect">`要求浏览器提前与某个域名建立 TCP 连接。当你知道，很快就会请求该域名时，这会很有帮助。
185 | 
186 | ```html
187 | <link rel="preconnect" href="https://www.example.com/">
188 | ```
189 | 
190 | ### `<link rel="dns-prefetch">`
191 | 
192 | `<link rel="dns-prefetch">`要求浏览器提前执行某个域名的 DNS 解析。
193 | 
194 | ```html
195 | <link rel="dns-prefetch" href="//example.com/">
196 | ```
197 | 
198 | ### `<link rel="prerender">`
199 | 
200 | `<link rel="prerender">`要求浏览器加载某个网页，并且提前渲染它。用户点击指向该网页的链接时，就会立即呈现该页面。如果确定用户下一步会访问该页面，这会很有帮助。
201 | 
202 | ```html
203 | <link rel="prerender" href="http://example.com/">
204 | ```
205 | 
206 | ## media 属性
207 | 
208 | `media`属性给出外部资源生效的媒介条件。
209 | 
210 | ```html
211 | <link href="print.css" rel="stylesheet" media="print">
212 | <link href="mobile.css" rel="stylesheet" media="screen and (max-width: 600px)">
213 | ```
214 | 
215 | 上面代码中，打印时加载`print.css`，移动设备访问时（设备宽度小于600像素）加载`mobile.css`。
216 | 
217 | 下面是使用`media`属性实现条件加载的例子。
218 | 
219 | ```html
220 | <link rel="preload" as="image" href="map.png" media="(max-width: 600px)">
221 | <link rel="preload" as="script" href="map.js" media="(min-width: 601px)">
222 | ```
223 | 
224 | 上面代码中，如果屏幕宽度在600像素以下，则只加载第一个资源，否则就加载第二个资源。
225 | 
226 | ## 其他属性
227 | 
228 | `<link>`标签的其他属性如下。
229 | 
230 | - `crossorigin`：加载外部资源的跨域设置。
231 | - `href`：外部资源的网址。
232 | - `referrerpolicy`：加载时`Referer`头信息字段的处理方法。
233 | - `as`：`rel="preload"`或`rel="prefetch"`时，设置外部资源的类型。
234 | - `type`：外部资源的 MIME 类型，目前仅用于`rel="preload"`或`rel="prefetch"`的情况。
235 | - `title`：加载样式表时，用来标识样式表的名称。
236 | - `sizes`：用来声明图标文件的尺寸，比如加载苹果手机的图标文件。
237 | 
238 | 


--------------------------------------------------------------------------------
/docs/list.md:
--------------------------------------------------------------------------------
  1 | # 列表标签
  2 | 
  3 | 列表是一系列排列好的项目，主要分成两类：有序列表和无序列表。
  4 | 
  5 | 有序列表是每个列表项前面有编号，呈现出顺序，就像下面这样。
  6 | 
  7 | ```html
  8 | 1. 列表项 A
  9 | 2. 列表项 B
 10 | 3. 列表项 C
 11 | ```
 12 | 
 13 | 无序列表则是列表项前面没有编号，只有一个列表符号，默认是一个圆点。
 14 | 
 15 | ```html
 16 | · 列表项 A
 17 | · 列表项 B
 18 | · 列表项 C
 19 | ```
 20 | 
 21 | ## `<ol>`
 22 | 
 23 | `<ol>`标签是一个有序列表容器（ordered list），会在内部的列表项前面产生数字编号。列表项的顺序有意义时，比如排名，就会采用这个标签。
 24 | 
 25 | ```html
 26 | <ol>
 27 |   <li>列表项 A</li>
 28 |   <li>列表项 B</li>
 29 |   <li>列表项 C</li>
 30 | </ol>
 31 | ```
 32 | 
 33 | 上面代码会在列表项 A、B、C 前面，分别产生1、2、3的编号。
 34 | 
 35 | `<ol>`标签内部可以嵌套`<ol>`标签或`<ul>`标签，形成多级列表。
 36 | 
 37 | ```html
 38 | <ol>
 39 |   <li>列表项 A</li>
 40 |   <li>列表项 B
 41 |     <ol>
 42 |       <li>列表项 B1</li>
 43 |       <li>列表项 B2</li>
 44 |       <li>列表项 B3</li>
 45 |     </ol>
 46 |   </li>
 47 |   <li>列表项 C</li>
 48 | </ol>
 49 | ```
 50 | 
 51 | 上面代码中，一个有序列表内部嵌套了另一个有序列表，渲染结果如下。
 52 | 
 53 | ```html
 54 | 1. 列表项 A
 55 | 2. 列表项 B
 56 |   1. 列表项 B1
 57 |   2. 列表项 B2
 58 |   3. 列表项 B3
 59 | 3. 列表项 C
 60 | ```
 61 | 
 62 | 该标签有以下属性。
 63 | 
 64 | **（1）reversed**
 65 | 
 66 | `reversed`属性产生倒序的数字列表。
 67 | 
 68 | ```html
 69 | <ol reversed>
 70 |   <li>列表项 A</li>
 71 |   <li>列表项 B</li>
 72 |   <li>列表项 C</li>
 73 | </ol>
 74 | ```
 75 | 
 76 | 上面代码中，列表项 A、B、C 前面，产生的编号是3、2、1。
 77 | 
 78 | **（2）start**
 79 | 
 80 | `start`属性的值是一个整数，表示数字列表的起始编号。
 81 | 
 82 | ```html
 83 | <ol start="5">
 84 |   <li>列表项 A</li>
 85 |   <li>列表项 B</li>
 86 |   <li>列表项 C</li>
 87 | </ol>
 88 | ```
 89 | 
 90 | 上面代码中，列表项 A、B、C 前面，产生的编号是5、6、7。
 91 | 
 92 | **（3）type**
 93 | 
 94 | `type`属性指定数字编号的样式。目前，浏览器支持以下样式。
 95 | 
 96 | - `a`：小写字母
 97 | - `A`：大写字母
 98 | - `i`：小写罗马数字
 99 | - `I`：大写罗马数字
100 | - `1`：整数（默认值）
101 | 
102 | ```html
103 | <ol type="a">
104 |   <li>列表项 A</li>
105 |   <li>列表项 B</li>
106 |   <li>列表项 C</li>
107 | </ol>
108 | ```
109 | 
110 | 上面代码中，列表项 A、B、C 前面的编号，分别是英文小写字母a、b、c。
111 | 
112 | 注意，即使编号是字母，`start`属性也依然使用整数。
113 | 
114 | ```html
115 | <ol type="a" start="3">
116 |   <li>列表项 A</li>
117 |   <li>列表项 B</li>
118 |   <li>列表项 C</li>
119 | </ol>
120 | ```
121 | 
122 | 上面代码中，`type`属性指定编号采用小写英文字母，`start`属性等于`3`，表示从`c`开始编号。
123 | 
124 | ## `<ul>`
125 | 
126 | `<ul>`标签是一个无序列表容器（unordered list），会在内部的列表项前面产生实心小圆点，作为列表符号。列表项的顺序无意义时，采用这个标签。
127 | 
128 | ```html
129 | <ul>
130 |   <li>列表项 A</li>
131 |   <li>列表项 B</li>
132 |   <li>列表项 C</li>
133 | </ul>
134 | ```
135 | 
136 | 上面代码的渲染结果是，列表项 A、B、C 前面，分别产生一个实心小圆点，作为列表符号。
137 | 
138 | `<ul>`标签内部可以嵌套`<ul>`或`<ol>`，形成多级列表。
139 | 
140 | ## `<li>`
141 | 
142 | `<li>`表示列表项，用在`<ol>`或`<ul>`容器之中。
143 | 
144 | 有序列表`<ol>`之中，`<li>`有一个`value`属性，定义当前列表项的编号，后面列表项会从这个值开始编号。
145 | 
146 | ```html
147 | <ol>
148 |   <li>列表项 A</li>
149 |   <li value="4">列表项 B</li>
150 |   <li>列表项 C</li>
151 | </ol>
152 | ```
153 | 
154 | 上面代码中，`value`属性指定第二个列表项的编号是`4`，因此三个列表项的编号，分别为1、4、5。
155 | 
156 | ## `<dl>`，`<dt>`，`<dd>`
157 | 
158 | `<dl>`标签是一个块级元素，表示一组术语的列表（description list）。术语名（description term）由`<dt>`标签定义，术语解释（description detail）由`<dd>`标签定义。`<dl>`常用来定义词汇表。
159 | 
160 | ```html
161 | <dl>
162 |   <dt>CPU</dt>
163 |   <dd>中央处理器</dd>
164 | 
165 |   <dt>Memory</dt>
166 |   <dd>内存</dd>
167 | 
168 |   <dt>Hard Disk</dt>
169 |   <dd>硬盘</dd>
170 | </dl>
171 | ```
172 | 
173 | `<dt>`和`<dd>`都是块级元素，`<dd>`默认会在`<dt>`下方缩进显示。上面代码的默认渲染结果如下。
174 | 
175 | ```html
176 | CPU
177 |   中央处理器
178 | 
179 | Memory
180 |   内存
181 | 
182 | Hard Disk
183 |   硬盘
184 | ```
185 | 
186 | 多个术语（`<dt>`）对应一个解释（`<dd>`），或者多个解释（`<dd>`）对应一个术语（`<dt>`），都是合法的。
187 | 
188 | ```html
189 | <dl>
190 |   <dt>A</dt>
191 |   <dt>B</dt>
192 |   <dd>C</dd>
193 | 
194 |   <dt>D</dt>
195 |   <dd>E</dd>
196 |   <dd>F</dd>
197 | </dl>
198 | ```
199 | 
200 | 上面代码中，`A`和`B`有共同的解释`C`，而`D`有两个解释`E`和`F`。
201 | 
202 | 


--------------------------------------------------------------------------------
/docs/mobile.md:
--------------------------------------------------------------------------------
 1 | # 移动设备网页设计
 2 | 
 3 | ## `<meta>`的 viewport 设置
 4 | 
 5 | `<meta>`的 viewport 设置用来控制网页的视觉大小。
 6 | 
 7 | ```html
 8 | <meta name="viewport" content="initial-scale=1">
 9 | ```
10 | 
11 | 这表示网页初始加载不进行放大或缩小。
12 | 
13 | 下面代码指定网页适配的视口宽度。
14 | 
15 | ```html
16 | <meta name="viewport" content="width=320">
17 | ```
18 | 
19 | 下面代码指定网页宽度为设备宽度。
20 | 
21 | ```html
22 | <meta name="viewport" content="width=device-width">
23 | ```
24 | 
25 | 下面代码指定用户不能放大网页。
26 | 
27 | ```html
28 | <meta name="viewport" content="maximum-scale=1">
29 | ```
30 | 
31 | 适用手机的网页，一般要写成下面这样。
32 | 
33 | ```html
34 | <meta name="viewport" content="width=device-width, initial-scale=1">
35 | ```
36 | 
37 | 
38 | 
39 | 


--------------------------------------------------------------------------------
/docs/multimedia.md:
--------------------------------------------------------------------------------
  1 | # 多媒体标签
  2 | 
  3 | 除了图像，网页还可以放置视频和音频。
  4 | 
  5 | ## `<video>`
  6 | 
  7 | `<video>`标签是一个块级元素，用于放置视频。如果浏览器支持加载的视频格式，就会显示一个播放器，否则显示`<video>`内部的子元素。
  8 | 
  9 | ```html
 10 | <video src="example.mp4" controls>
 11 |   <p>你的浏览器不支持 HTML5 视频，请下载<a href="example.mp4">视频文件</a>。</p>
 12 | </video>
 13 | ```
 14 | 
 15 | 上面代码中，如果浏览器不支持该种格式的视频，就会显示`<video>`内部的文字提示。
 16 | 
 17 | `<video>`有以下属性。
 18 | 
 19 | - `src`：视频文件的网址。
 20 | - `controls`：播放器是否显示控制栏。该属性是布尔属性，不用赋值，只要写上属性名，就表示打开。如果不想使用浏览器默认的播放器，而想使用自定义播放器，就不要使用该属性。
 21 | - `width`：视频播放器的宽度，单位像素。
 22 | - `height`：视频播放器的高度，单位像素。
 23 | - `autoplay`：视频是否自动播放，该属性为布尔属性。
 24 | - `loop`：视频是否循环播放，该属性为布尔属性。
 25 | - `muted`：是否默认静音，该属性为布尔属性。
 26 | - `poster`：视频播放器的封面图片的 URL。
 27 | - `preload`：视频播放之前，是否缓冲视频文件。这个属性仅适合没有设置`autoplay`的情况。它有三个值，分别是`none`（不缓冲）、`metadata`（仅仅缓冲视频文件的元数据）、`auto`（可以缓冲整个文件）。
 28 | - `playsinline`：iPhone 的 Safari 浏览器播放视频时，会自动全屏，该属性可以禁止这种行为。该属性为布尔属性。
 29 | - `crossorigin`：是否采用跨域的方式加载视频。它可以取两个值，分别是`anonymous`（跨域请求时，不发送用户凭证，主要是 Cookie），`use-credentials`（跨域时发送用户凭证）。
 30 | - `currentTime`：指定当前播放位置（双精度浮点数，单位为秒）。如果尚未开始播放，则会从这个属性指定的位置开始播放。
 31 | - `duration`：该属性只读，指示时间轴上的持续播放时间（总长度），值为双精度浮点数（单位为秒）。如果是流媒体，没有已知的结束时间，属性值为`+Infinity`。
 32 | 
 33 | 下面是一个例子。
 34 | 
 35 | ```html
 36 | <video width="400" height="400"
 37 |        autoplay loop muted
 38 |        poster="poster.png">
 39 | </video>
 40 | ```
 41 | 
 42 | 上面代码中，视频播放器的大小是 400 x 400，会自动播放和循环播放，并且静音，还带有封面图。这是网站首页背景视频的常见写法。
 43 | 
 44 | HTML 标准没有规定浏览器需要支持哪些视频格式，完全由浏览器厂商自己决定。为了避免浏览器不支持视频格式，可以使用`<source>`标签，放置同一个视频的多种格式。
 45 | 
 46 | ```html
 47 | <video controls>
 48 |   <source src="example.mp4" type="video/mp4">
 49 |   <source src="example.webm" type="video/webm">
 50 |   <p>你的浏览器不支持 HTML5 视频，请下载<a href="example.mp4">视频文件</a>。</p>
 51 | </video>
 52 | ```
 53 | 
 54 | 上面代码中，`<source>`标签的`type`属性的值是视频文件的 MIME 类型，上例指定了两种格式的视频文件：MP4 和 WebM。如果浏览器支持 MP4，就加载 MP4 格式的视频，不再往下执行了。如果不支持 MP4，就检查是否支持 WebM，如果还是不支持，则显示提示。
 55 | 
 56 | ## `<audio>`
 57 | 
 58 | `<audio>`标签是一个块级元素，用于放置音频，用法与`<video>`标签基本一致。
 59 | 
 60 | ```html
 61 | <audio controls>
 62 |   <source src="foo.mp3" type="audio/mp3">
 63 |   <source src="foo.ogg" type="audio/ogg">
 64 |   <p>你的浏览器不支持 HTML5 音频，请直接下载<a href="foo.mp3">音频文件</a>。</p>
 65 | </audio>
 66 | ```
 67 | 
 68 | 上面代码中，`<audio>`标签内部使用`<source>`标签，指定了两种音频格式：优先使用 MP3 格式，如果浏览器不支持则使用 Ogg 格式。如果浏览器不能播放音频，则提供下载链接。
 69 | 
 70 | `<audio>`标签的属性与`<video>`标签类似，参见上一节。
 71 | 
 72 | - `autoplay`：是否自动播放，布尔属性。
 73 | - `controls`：是否显示播放工具栏，布尔属性。如果不设置，浏览器不显示播放界面，通常用于背景音乐。
 74 | - `crossorigin`：是否使用跨域方式请求。
 75 | - `loop`：是否循环播放，布尔属性。
 76 | - `muted`：是否静音，布尔属性。
 77 | - `preload`：音频文件的缓冲设置。
 78 | - `src`：音频文件网址。
 79 | 
 80 | ## `<track>`
 81 | 
 82 | `<track>`标签用于指定视频的字幕，格式是 WebVTT （`.vtt`文件），放置在`<video>`标签内部。它是一个单独使用的标签，没有结束标签。
 83 | 
 84 | ```html
 85 | <video controls src="sample.mp4">
 86 |    <track label="英文" kind="subtitles" src="subtitles_en.vtt" srclang="en">
 87 |    <track label="中文" kind="subtitles" src="subtitles_cn.vtt" srclang="cn" default>
 88 | </video>
 89 | ```
 90 | 
 91 | 上面代码指定视频文件的英文字幕和中文字幕。
 92 | 
 93 | `<track>`标签有以下属性。
 94 | 
 95 | - `label`：播放器显示的字幕名称，供用户选择。
 96 | - `kind`：字幕的类型，默认是`subtitles`，表示将原始声音成翻译外国文字，比如英文视频提供中文字幕。另一个常见的值是`captions`，表示原始声音的文字描述，通常是视频原始使用的语言，比如英文视频提供英文字幕。
 97 | - `src`：vtt 字幕文件的网址。
 98 | - `srclang`：字幕的语言，必须是有效的语言代码。
 99 | - `default`：是否默认打开，布尔属性。
100 | 
101 | ## `<source>`
102 | 
103 | `<source>`标签用于`<picture>`、`<video>`、`<audio>`的内部，用于指定一项外部资源。单标签是单独使用的，没有结束标签。
104 | 
105 | 它有如下属性，具体示例请参见相应的容器标签。
106 | 
107 | - `type`：指定外部资源的 MIME 类型。
108 | - `src`：指定源文件，用于`<video>`和`<audio>`。
109 | - `srcset`：指定不同条件下加载的图像文件，用于`<picture>`。
110 | - `media`：指定媒体查询表达式，用于`<picture>`。
111 | - `sizes`：指定不同设备的显示大小，用于`<picture>`，必须跟`srcset`搭配使用。
112 | 
113 | ## `<embed>`
114 | 
115 | `<embed>`标签用于嵌入外部内容，这个外部内容通常由浏览器插件负责控制。由于浏览器的默认插件都不一致，很可能不是所有浏览器的用户都能访问这部分内容，建议谨慎使用。
116 | 
117 | 下面是嵌入视频播放器的例子。
118 | 
119 | ```html
120 | <embed type="video/webm"
121 |        src="/media/examples/flower.mp4"
122 |        width="250"
123 |        height="200">
124 | ```
125 | 
126 | 上面代码嵌入的视频，将由浏览器插件负责控制。如果浏览器没有安装 MP4 插件，视频就无法播放。
127 | 
128 | `<embed>`标签具有如下的通用属性。
129 | 
130 | - `height`：显示高度，单位为像素，不允许百分比。
131 | - `width`：显示宽度，单位为像素，不允许百分比。
132 | - `src`：嵌入的资源的 URL。
133 | - `type`：嵌入资源的 MIME 类型。
134 | 
135 | 浏览器通过`type`属性得到嵌入资源的 MIME 类型，一旦该种类型已经被某个插件注册了，就会启动该插件，负责处理嵌入的资源。
136 | 
137 | 下面是 QuickTime 插件播放 MOV 视频文件的例子。
138 | 
139 | ```html
140 | <embed type="video/quicktime" src="movie.mov" width="640" height="480">
141 | ```
142 | 
143 | 下面是启动 Flash 插件的例子。
144 | 
145 | ```html
146 | <embed src="whoosh.swf" quality="medium"
147 |        bgcolor="#ffffff" width="550" height="400"
148 |        name="whoosh" align="middle" allowScriptAccess="sameDomain"
149 |        allowFullScreen="false" type="application/x-shockwave-flash"
150 |        pluginspage="http://www.macromedia.com/go/getflashplayer">
151 | ```
152 | 
153 | 上面代码中，如果浏览器没有安装 Flash 插件，就会提示去`pluginspage`属性指定的网址下载。
154 | 
155 | ## `<object>`，`<param>`
156 | 
157 | `<object>`标签作用跟`<embed>`相似，也是插入外部资源，由浏览器插件处理。它可以视为`<embed>`的替代品，有标准化行为，只限于插入少数几种通用资源，没有历史遗留问题，因此更推荐使用。
158 | 
159 | 下面是插入 PDF 文件的例子。
160 | 
161 | ```html
162 | <object type="application/pdf"
163 |     data="/media/examples/In-CC0.pdf"
164 |     width="250"
165 |     height="200">
166 | </object>
167 | ```
168 | 
169 | 上面代码中，如果浏览器安装了 PDF 插件，就会在网页显示 PDF 浏览窗口。
170 | 
171 | `<object>`具有如下的通用属性。
172 | 
173 | - `data`：嵌入的资源的 URL。
174 | - `form`：当前网页中相关联表单的`id`属性（如果有的话）。
175 | - `height`：资源的显示高度，单位为像素，不能使用百分比。
176 | - `width`：资源的显示宽度，单位为像素，不能使用百分比。
177 | - `type`：资源的 MIME 类型。
178 | - `typemustmatch`：布尔属性，表示`data`属性与`type`属性是否必须匹配。
179 | 
180 | 下面是插入 Flash 影片的例子。
181 | 
182 | ```html
183 | <object data="movie.swf"
184 |   type="application/x-shockwave-flash"></object>
185 | ```
186 | 
187 | `<object>`标签是一个容器元素，内部可以使用`<param>`标签，给出插件所需要的运行参数。
188 | 
189 | ```html
190 | <object data="movie.swf" type="application/x-shockwave-flash">
191 |   <param name="foo" value="bar">
192 | </object>
193 | ```
194 | 
195 | 


--------------------------------------------------------------------------------
/docs/script.md:
--------------------------------------------------------------------------------
 1 | # <script>，<noscript>
 2 | 
 3 | `<script>`标签用于在网页插入脚本，`<noscript>`标签用于指定浏览器不支持脚本时的显示内容。
 4 | 
 5 | ## `<script>`
 6 | 
 7 | `<script>`用于加载脚本代码，目前主要是加载 JavaScript 代码。
 8 | 
 9 | ```html
10 | <script>
11 | console.log('hello world');
12 | </script>
13 | ```
14 | 
15 | 上面代码嵌入网页，会立即执行。
16 | 
17 | `<script>`也可以加载外部脚本，`src`属性给出外部脚本的地址。
18 | 
19 | ```html
20 | <script src="javascript.js"></script>
21 | ```
22 | 
23 | 上面代码会加载`javascript.js`脚本文件，并执行。
24 | 
25 | `type`属性给出脚本的类型，默认是 JavaScript 代码，所以可省略。完整的写法其实是下面这样。
26 | 
27 | ```html
28 | <script type="text/javascript" src="javascript.js"></script>
29 | ```
30 | 
31 | `type`属性也可以设成`module`，表示这是一个 ES6 模块，不是传统脚本。
32 | 
33 | ```html
34 | <script type="module" src="main.js"></script>
35 | ```
36 | 
37 | 对于那些不支持 ES6 模块的浏览器，可以设置`nomodule`属性。支持 ES6 模块的浏览器，会不加载指定的脚本。这个属性通常与`type="module"`配合使用，作为老式浏览器的回退方案。
38 | 
39 | ```html
40 | <script type="module" src="main.js"></script>
41 | <script nomodule src="fallback.js"></script>
42 | ```
43 | 
44 | `<script>`还有下面一些其他属性，大部分跟 JavaScript 语言有关，可以参考相关的 JavaScript 教程。
45 | 
46 | - `async`：该属性指定 JavaScript 代码为异步执行，不是造成阻塞效果，JavaScript 代码默认是同步执行。
47 | - `defer`：该属性指定 JavaScript 代码不是立即执行，而是页面解析完成后执行。
48 | - `crossorigin`：如果采用这个属性，就会采用跨域的方式加载外部脚本，即 HTTP 请求的头信息会加上`origin`字段。
49 | - `integrity`：给出外部脚本的哈希值，防止脚本被篡改。只有哈希值相符的外部脚本，才会执行。
50 | - `nonce`：一个密码随机数，由服务器在 HTTP 头信息里面给出，每次加载脚本都不一样。它相当于给出了内嵌脚本的白名单，只有在白名单内的脚本才能执行。
51 | - `referrerpolicy`：HTTP 请求的`Referer`字段的处理方法。
52 | 
53 | ## `<noscript>`
54 | 
55 | `<noscript>`标签用于浏览器不支持或关闭 JavaScript 时，所要显示的内容。用户关闭 JavaScript 可能是为了节省带宽，以延长手机电池寿命，或者为了防止追踪，保护隐私。
56 | 
57 | ```html
58 | <noscript>
59 |   您的浏览器不能执行 JavaScript 语言，页面无法正常显示。
60 | </noscript>
61 | ```
62 | 
63 | 上面这段代码，只有浏览器不能执行 JavaScript 代码时才会显示，否则就不会显示。
64 | 
65 | 


--------------------------------------------------------------------------------
/docs/semantic.md:
--------------------------------------------------------------------------------
  1 | # 网页的语义结构
  2 | 
  3 | HTML 标签的名称都带有语义（semantic），使用时应该尽量符合标签的语义，不要用错误语义的标签。语义良好的网页，天然具有良好的结构，对于开发者易读易写，容易维护，也能帮助计算机更好地处理网页内容。
  4 | 
  5 | ## 含义
  6 | 
  7 | HTML 标签的一个重要作用，就是声明网页元素的性质，使得用户只看标签，就能了解这个元素的意义，阅读 HTML 源码就能了解网页的大致结构。这被称为 HTML 的语义原则。
  8 | 
  9 | 下面就是一个典型的语义结构的网页。
 10 | 
 11 | ```html
 12 | <body>
 13 |   <header>页眉</header>
 14 |   <main>
 15 |     <article>
 16 |       <h1>文章标题</h1>
 17 |       <p>文章内容</p>
 18 |     </article>
 19 |   </main>
 20 |   <footer>页尾</footer>
 21 | </body>
 22 | ```
 23 | 
 24 | 只看上面的代码，就可以知道，页面分成页眉（`<header>`）、主体（`<main>`）、页尾（`<footer>`）三个部分。
 25 | 
 26 | 编写 HTML 网页，第一步就是写出语义结构的网页骨架。
 27 | 
 28 | ## 常用标签
 29 | 
 30 | ### `<header>`
 31 | 
 32 | `<header>`标签可以用在多个场景，既可以表示整个网页的头部，也可以表示一篇文章或者一个区块的头部。
 33 | 
 34 | 如果用在网页的头部，就称为“页眉”。网站导航和搜索栏通常会放在`<header>`里面。
 35 | 
 36 | ```html
 37 | <header>
 38 |   <h1>公司名称</h1>
 39 |   <ul>
 40 |     <li><a href="/home">首页</a></li>
 41 |     <li><a href="/about">关于</a></li>
 42 |     <li><a href="/contact">联系</a></li>
 43 |   </ul>
 44 |   <form target="/search">
 45 |     <input name="q" type="search" />
 46 |     <input type="submit" />
 47 |   </form>
 48 | </header>
 49 | ```
 50 | 
 51 | 如果`<header>`用在文章的头部，则可以把文章标题、作者等信息放进去。
 52 | 
 53 | ```html
 54 | <article>
 55 |   <header>
 56 |     <h2>文章标题</h2>
 57 |     <p>张三，发表于2010年1月1日</p>
 58 |   </header>
 59 | </article>
 60 | ```
 61 | 
 62 | 由于`<header>`可以用在多种场景，所以一个页面可能包含多个`<header>`，但是一个具体的场景里面只能包含一个，比如网页的页眉只能有一个。另外，`<header>`里面不能包含另一个`<header>`或`<footer>`。
 63 | 
 64 | ### `<footer>`
 65 | 
 66 | `<footer>`标签表示网页、文章或章节的尾部。如果用于整张网页的尾部，就称为“页尾”，通常包含版权信息或者其他相关信息。
 67 | 
 68 | ```html
 69 | <body>
 70 |   <footer>
 71 |     <p>© 2018 xxx 公司</p>
 72 |   </footer>
 73 | </body>
 74 | ```
 75 | 
 76 | 上面代码中，版权信息放在`<footer>`里面。
 77 | 
 78 | `<footer>`也可以放在文章里面。
 79 | 
 80 | ```html
 81 | <article>
 82 |   <header>
 83 |     <h1>文章标题</h1>
 84 |   </header>
 85 |   <footer>
 86 |     <p>© 禁止转贴</p>
 87 |   </footer>
 88 | </article>
 89 | ```
 90 | 
 91 | `<footer>`不能嵌套，即内部不能放置另一个`<footer>`，也不能放置`<header>`。
 92 | 
 93 | ### `<main>`
 94 | 
 95 | `<main>`标签表示页面的主体内容，一个页面只能有一个`<main>`。
 96 | 
 97 | ```html
 98 | <body>
 99 | <header>页眉</header>
100 | <main>
101 |   <article>文章</article>
102 | </main>
103 | <aside>侧边栏</aside>
104 | <footer>页尾</footer>
105 | </body>
106 | ```
107 | 
108 | 上面代码就是最典型的页面结构。
109 | 
110 | 注意，`<main>`是顶层标签，不能放置在`<header>`、`<footer>`、`<article>`、`<aside>`、`<nav>`等标签之中。
111 | 
112 | 另外，功能性区块（比如搜索栏）不适合放入`<main>`，除非当前页面就是搜索页面。
113 | 
114 | ### `<article>`
115 | 
116 | `<article>`标签表示页面里面一段完整的内容，即使页面的其他部分不存在，也具有独立使用的意义，通常用来表示一篇文章或者一个论坛帖子。它可以有自己的标题（`<h1>`到`<h6>`）。
117 | 
118 | ```html
119 | <article>
120 |   <h2>文章标题</h2>
121 |   <p>文章内容</p>
122 | </article>
123 | ```
124 | 
125 | 一个网页可以包含一个或多个`<article>`，比如包含多篇文章。
126 | 
127 | ### `<aside>`
128 | 
129 | `<aside>`标签用来放置与网页或文章主要内容间接相关的部分。网页级别的`<aside>`，可以用来放置侧边栏，但不一定就在页面的侧边；文章级别的`<aside>`，可以用来放置补充信息、评论或注释。
130 | 
131 | 下面是网页级别的`<aside>`的例子。
132 | 
133 | ```html
134 | <body>
135 |   <main>主体内容</main>
136 |   <aside>侧边栏</aside>
137 | </body>
138 | ```
139 | 
140 | 下面是文章评注的例子。
141 | 
142 | ```html
143 | <p>第一段</p>
144 | 
145 | <aside>
146 |   <p>本段是文章的重点。</p>
147 | </aside>
148 | ```
149 | 
150 | ### `<section>`
151 | 
152 | `<section>`标签表示一个含有主题的独立部分，通常用在文档里面表示一个章节，比如`<article>`可以包含多个`<section>`。`<section>`总是多个一起使用，一个页面不能只有一个`<section>`。
153 | 
154 | ```html
155 | <article>
156 |   <h1>文章标题</h1>
157 |   <section>
158 |     <h2>第一章</h2>
159 |     <p>...</p>
160 |   </section>
161 |   <section>
162 |     <h2>第二章</h2>
163 |     <p>...</p>
164 |   </section>
165 | </article>
166 | ```
167 | 
168 | 上面代码中，`<article>`包含了两个`<section>`，代表两章。
169 | 
170 | `<section>`很适合幻灯片展示的页面，每个`<section>`代表一个幻灯片。
171 | 
172 | 一般来说，`<section>`都应该有标题，即包含`<h1>`~`<h6>`标签。多个`<section>`可以放置在同一个`<article>`里面，一个`<section>`里面也可能包含多个`<article>`，这取决于`<section>`和`<article>`在当前页面的含义。
173 | 
174 | ### `<nav>`
175 | 
176 | `<nav>`标签用于放置页面或文档的导航信息。
177 | 
178 | ```html
179 | <nav>
180 |   <ol>
181 |     <li><a href="item-a">商品 A</a></li>
182 |     <li><a href="item-b">商品 B</a></li>
183 |     <li>商品 C</li>
184 |   </ol>
185 | </nav>
186 | ```
187 | 
188 | 一般来说，`<nav>`往往放置在`<header>`里面，不适合放入`<footer>`。另外，一个页面可以有多个`<nav>`，比如一个用于站点导航，另一个用于文章导航。
189 | 
190 | `<nav>`里面通常是列表，但也可以放置其他标签。
191 | 
192 | ### `<h1>` ~ `<h6>`
193 | 
194 | HTML 提供了6个标签，用来表示文章的标题。按照标题的等级，一共分成六级。
195 | 
196 | - `<h1>`：一级标题
197 | - `<h2>`：二级标题
198 | - `<h3>`：三级标题
199 | - `<h4>`：四级标题
200 | - `<h5>`：五级标题
201 | - `<h6>`：六级标题
202 | 
203 | `<h1>`是最高级别的标题，`<h6>`是最低级别的标题。下一级标题都是上一级标题的子标题，比如，一个`<h1>`后面可以有多个`<h2>`，每个`<h2>`后面又可以有多个`<h3>`。
204 | 
205 | ```html
206 | <body>
207 |   <h1>JavaScript 语言介绍</h1>
208 |     <h2>概述</h2>
209 |     <h2>基本概念</h2>
210 |       <h3>网页</h3>
211 |       <h3>链接</h3>
212 |     <h2>主要用法</h2>
213 | </body>
214 | ```
215 | 
216 | 上面代码，通过章节标题，清晰地表明了文章的主体结构。具体的内容，就可以写在章节标题的下面。
217 | 
218 | 标题不应该越级，比如`h1`下面直接写`h3`。虽然这样不会报错，但会导致文章失去清晰的章节结构。
219 | 
220 | 默认情况下，浏览器会粗体显示标题。`h1`的字号比`h2`大，`h2`比`h3`大，以此类推。
221 | 
222 | ### `<hgroup>`
223 | 
224 | 如果主标题包含多级标题（比如带有副标题），那么可以使用`<hgroup>`标签，将多级标题放在其中。
225 | 
226 | ```html
227 | <hgroup>
228 |   <h1>Heading 1</h1>
229 |   <h2>Subheading 1</h2>
230 |   <h2>Subheading 2</h2>
231 | </hgroup>
232 | ```
233 | 
234 | 注意，`<hgroup>`只能包含`<h1>`~`<h6>`，不能包含其他标签。
235 | 
236 | 


--------------------------------------------------------------------------------
/docs/table.md:
--------------------------------------------------------------------------------
  1 | # 表格标签
  2 | 
  3 | 表格（table）以行（row）和列（column）的形式展示数据。
  4 | 
  5 | ## `<table>`，`<caption>`
  6 | 
  7 | `<table>`是一个块级容器标签，所有表格内容都要放在这个标签里面。
  8 | 
  9 | ```html
 10 | <table>
 11 |   ... ...
 12 | </table>
 13 | ```
 14 | 
 15 | `<caption>`总是`<table>`里面的第一个子元素，表示表格的标题。该元素是可选的。
 16 | 
 17 | ```html
 18 | <table>
 19 |   <caption>示例表格</caption>
 20 | </table>
 21 | ```
 22 | 
 23 | ## `<thead>`、`<tbody>`、`<tfoot>`
 24 | 
 25 | `<thead>`、`<tbody>`、`<tfoot>`都是块级容器元素，且都是`<table>`的一级子元素，分别表示表头、表体和表尾。
 26 | 
 27 | ```html
 28 | <table>
 29 |   <thead>... ...</thead>
 30 |   <tbody>... ...</tbody>
 31 |   <tfoot>... ...</tfoot>
 32 | </table>
 33 | ```
 34 | 
 35 | 这三个元素都是可选的。如果使用了`<thead>`，那么`<tbody>`和`<tfoot>`一定在`<thead>`的后面。如果使用了`<tbody>`，那么`<tfoot>`一定在`<tbody>`后面。
 36 | 
 37 | 大型表格内部可以使用多个`<tbody>`，表示连续的多个部分。
 38 | 
 39 | ## `<colgroup>`，`<col>`
 40 | 
 41 | `<colgroup>`是`<table>`的一级子元素，用来包含一组列的定义。`<col>`是`<colgroup>`的子元素，用来定义表格的一列。
 42 | 
 43 | ```html
 44 | <table>
 45 |   <colgroup>
 46 |     <col>
 47 |     <col>
 48 |     <col>
 49 |   </colgroup>
 50 | </table>
 51 | ```
 52 | 
 53 | 上面代码表明表格有3列。
 54 | 
 55 | `<col>`不仅是一个单独使用的标签，没有结束标志，而且还是一个空元素，没有子元素。它的主要作用，除了申明表格结构，还可以为表格附加样式。
 56 | 
 57 | ```html
 58 | <table>
 59 |   <colgroup>
 60 |     <col class="c1">
 61 |     <col class="c2">
 62 |     <col class="c3">
 63 |   </colgroup>
 64 |   <tr>
 65 |     <td>1</td>
 66 |     <td>2</td>
 67 |     <td>3</td>
 68 |   </tr>
 69 | </table>
 70 | ```
 71 | 
 72 | 上面代码中，`<colgroup>`声明表格有三列，每一列有自己的 class，可以使用 CSS 针对每个 class 设定样式，会对整个表格生效。
 73 | 
 74 | `<col>`有一个`span`属性，值为正整数，默认为`1`。如果大于1，就表示该列的宽度包含连续的多列。
 75 | 
 76 | ```html
 77 | <table>
 78 |   <colgroup>
 79 |     <col>
 80 |     <col span="2">
 81 |     <col>
 82 |   </colgroup>
 83 | </table>
 84 | ```
 85 | 
 86 | 上面代码中，表格的表头定义了3列，实际数据有4列。表头的第2列会连续跨2列。
 87 | 
 88 | ## `<tr>`
 89 | 
 90 | `<tr>`标签表示表格的一行（table row）。如果表格有`<thead>`、`<tbody>`、`<tfoot>`，那么`<tr>`就放在这些容器元素之中，否则直接放在`<table>`的下一级。
 91 | 
 92 | ```html
 93 | <table>
 94 |   <tr>...</tr>
 95 |   <tr>...</tr>
 96 |   <tr>...</tr>
 97 | </table>
 98 | ```
 99 | 
100 | 上面代码表示表格共有3行。
101 | 
102 | ## `<th>`，`<td>`
103 | 
104 | `<th>`和`<td>`都用来定义表格的单元格。其中，`<th>`是标题单元格，`<td>`是数据单元格。
105 | 
106 | ```html
107 | <table>
108 |   <tr>
109 |     <th>学号</th><th>姓名</th>
110 |   </tr>
111 |   <tr>
112 |     <td>001</td><td>张三</td>
113 |   </tr>
114 |   <tr>
115 |     <td>002</td><td>李四</td>
116 |   </tr>
117 | </table>
118 | ```
119 | 
120 | 上面代码中，表格一共有三行。第一行是标题行，所以使用`<th>`；第二行和第三行是数据行，所以使用`<td>`。
121 | 
122 | **（1）`colspan`属性，`rowspan`属性**
123 | 
124 | 单元格会有跨越多行或多列的情况，这要通过`colspan`属性和`rowspan`属性设置，前者表示单元格跨越的栏数，后者表示单元格跨越的行数。它们的值都是一个非负整数，默认为1。
125 | 
126 | ```html
127 | <table>
128 |   <tr>
129 |     <td colspan="2">A</td><td>B</td>
130 |   </tr>
131 |   <tr>
132 |     <td>A</td><td>B</td><td>C</td>
133 |   </tr>
134 | </table>
135 | ```
136 | 
137 | 上面代码中，第一行的第一个单元格会跨两列。
138 | 
139 | **（2）`headers`属性**
140 | 
141 | 如果表格很大，单元格很多，源码里面会看不清，哪个单元格对应哪个表头，这时就可以使用`headers`属性。
142 | 
143 | ```html
144 | <table>
145 |   <tr>
146 |     <th id="no">学号</th><th id="names">姓名</th>
147 |   </tr>
148 |   <tr>
149 |     <td headers="no">001</td><td headers="names">张三</td>
150 |   </tr>
151 |   <tr>
152 |     <td headers="no">002</td><td headers="names">李四</td>
153 |   </tr>
154 | </table>
155 | ```
156 | 
157 | 上面代码中，标题栏的`<th>`设置了`id`属性，后面的`<td>`单元格的`headers`属性就对应这些`id`属性的值，因此就能看出来这些单元格对应哪个标题栏。
158 | 
159 | `headers`属性的值总是对应`<th>`标签的`id`属性的值。由于一个单元格可以对应多个标题栏（跨行的情况），所以`headers`属性可以是一个空格分隔的字符串，对应多个`id`属性的值。
160 | 
161 | **（3）`scope`属性**
162 | 
163 | `scope`属性只有`<th>`标签支持，一般不在`<td>`标签使用，表示该`<th>`单元格到底是栏的标题，还是列的标题。
164 | 
165 | ```html
166 | <table>
167 |   <tr>
168 |     <th scope="col">姓名</th>
169 |     <th scope="col">学号</th>
170 |     <th scope="col">性别</th>
171 |   </tr>
172 |   <tr>
173 |     <th scope="row">张三</th>
174 |     <td>001</td>
175 |     <td>男</td>
176 |   </tr>
177 |   <tr>
178 |     <th scope="row">李四</th>
179 |     <td>002</td>
180 |     <td>男</td>
181 |   </tr>
182 | </table>
183 | ```
184 | 
185 | 上面代码中，第一行的标题栏都是列标题，所以`<th>`的`scope`属性为`col`，第二行和第三行的第一列是行标题，所以`<th>`标签的`scope`属性为`row`。
186 | 
187 | `scope`属性可以取下面这些值。
188 | 
189 | - `row`：该行的所有单元格，都与该标题单元格相关。
190 | - `col`：该列的所有单元格，都与该标题单元格相关。
191 | - `rowgroup`：多行组成的一个行组的所有单元格，都与该标题单元格相关，可以与`rowspan`属性配合使用。
192 | - `colgroup`：多列组成的一个列组的所有单元格，都与该标题单元格相关，可以与`colspan`属性配合使用。
193 | - `auto`：默认值，表示由浏览器自行决定。
194 | 
195 | 下面是一个`colgroup`属性和`rowgroup`属性的例子。
196 | 
197 | ```html
198 | <table>
199 |   <thead>
200 |     <tr>
201 |       <th scope="col">海报名称</th>
202 |       <th scope="col">颜色</th>
203 |       <th colspan="3" scope="colgroup">尺寸</th>
204 |     </tr>
205 |   </thead>
206 |   <tbody>
207 |     <tr>
208 |       <th rowspan="3" scope="rowgroup">Zodiac</th>
209 |       <th scope="row">Full color</th>
210 |       <td>A2</td>
211 |       <td>A3</td>
212 |       <td>A4</td>
213 |     </tr>
214 |     <tr>
215 |       <th scope="row">Black and white</th>
216 |       <td>A1</td>
217 |       <td>A2</td>
218 |       <td>A3</td>
219 |     </tr>
220 |     <tr>
221 |       <th scope="row">Sepia</th>
222 |       <td>A3</td>
223 |       <td>A4</td>
224 |       <td>A5</td>
225 |     </tr>
226 |   </tbody>
227 | </table>
228 | ```
229 | 
230 | 上面的例子中，列标题“尺寸”的`scope`属性为`colgroup`，表示这个标题单元格对应多列（本例为3列）；行标题的`scope`属性为`rowgroup`，表示这个标题单元格对应多行（本例为3行）。
231 | 
232 | 渲染结果就是下面的样子。
233 | 
234 | <table>
235 |   <thead>
236 |     <tr>
237 |       <th scope="col">海报名称</th>
238 |       <th scope="col">颜色</th>
239 |       <th colspan="3" scope="colgroup">尺寸</th>
240 |     </tr>
241 |   </thead>
242 |   <tbody>
243 |     <tr>
244 |       <th rowspan="3" scope="rowgroup">Zodiac</th>
245 |       <th scope="row">Full color</th>
246 |       <td>A2</td>
247 |       <td>A3</td>
248 |       <td>A4</td>
249 |     </tr>
250 |     <tr>
251 |       <th scope="row">Black and white</th>
252 |       <td>A1</td>
253 |       <td>A2</td>
254 |       <td>A3</td>
255 |     </tr>
256 |     <tr>
257 |       <th scope="row">Sepia</th>
258 |       <td>A3</td>
259 |       <td>A4</td>
260 |       <td>A5</td>
261 |     </tr>
262 |   </tbody>
263 | </table>
264 | 
265 | 


--------------------------------------------------------------------------------
/docs/text.md:
--------------------------------------------------------------------------------
  1 | # 文本标签
  2 | 
  3 | 历史上，网页的主要功能是文本展示。所以，HTML 提供了大量的文本处理标签。
  4 | 
  5 | ## `<div>`
  6 | 
  7 | `<div>`是一个通用标签，表示一个区块（division）。它没有语义，如果网页需要一个块级元素容器，又没有其他合适的标签，就可以使用这个标签。
  8 | 
  9 | 它的最常见用途就是提供 CSS 的钩子，用来指定各种样式。所以在早期，下面层层包裹的`<div>`就很常见。
 10 | 
 11 | ```html
 12 | <div class="main">
 13 |   <div class="article">
 14 |     <div class="title">
 15 |       <h1>文章标题</h1>
 16 |     </div>
 17 |   </div>
 18 | </div>
 19 | ```
 20 | 
 21 | 上面代码读起来很费力，因为不带有语义。后来，HTML 5 就提出了语义标签，改进了上面的代码。
 22 | 
 23 | ```html
 24 | <main>
 25 |   <article>
 26 |     <header>
 27 |       <h1>文章标题</h1>
 28 |     </header>
 29 |   </article>
 30 | </main>
 31 | ```
 32 | 
 33 | `<div>`是无语义的块级元素。下面的例子使用`<div>`，将图像和文字组合在一起，构成一个警告区块。
 34 | 
 35 | ```html
 36 | <div>
 37 |   <img src="warning.jpg" alt="警告">
 38 |   <p>小心</p>
 39 | </div>
 40 | ```
 41 | 
 42 | 只要样式上需要多个块级元素组合在一起，就可以使用`<div>`。但是，这应该是最后的措施，带有语义的块级标签（比如`<article>`、`<section>`、`<aside>`、`<nav>`等）始终应该优先使用，当且仅当没有其他语义元素合适时，才可以使用`<div>`。
 43 | 
 44 | ## `<p>`
 45 | 
 46 | `<p>`标签是一个块级元素，代表文章的一个段落（paragraph）。不仅是文本，任何想以段落显示的内容，比如图片和表单项，都可以放进`<p>`元素。
 47 | 
 48 | ```html
 49 | <p>hello world</p>
 50 | ```
 51 | 
 52 | 上面代码就是一个简单的段落。
 53 | 
 54 | ## `<span>`
 55 | 
 56 | `<span>`是一个通用目的的行内标签（即不会产生换行），不带有任何语义。它通常用作 CSS 样式的钩子，如果需要对某些行内内容指定样式，就可以把它们放置在`<span>`。
 57 | 
 58 | ```html
 59 | <p>这是一句<span>重要</span>的句子。</p>
 60 | ```
 61 | 
 62 | 上面代码中，句子里面需要强调的部分，就可以放在`<span>`。
 63 | 
 64 | ## `<br>`，`<wbr>`
 65 | 
 66 | `<br>`让网页产生一个换行效果。该标签是单独使用的，没有闭合标签。
 67 | 
 68 | ```html
 69 | hello<br>world
 70 | ```
 71 | 
 72 | 浏览器渲染上面代码时，会分成两行，`hello`和`world`各占一行。
 73 | 
 74 | `<br>`对于诗歌和地址的换行非常有用。
 75 | 
 76 | ```html
 77 | <p>
 78 |   床前明月光，<br>
 79 |   疑是地上霜。<br>
 80 |   举头望明月，<br>
 81 |   低头思故乡。
 82 | </p>
 83 | ```
 84 | 
 85 | 上面的代码如果不用`<br>`，会显示成一行。
 86 | 
 87 | 注意，块级元素的间隔，不要使用`<br>`来产生，而要使用 CSS 指定。
 88 | 
 89 | ```html
 90 | <p>第一段</p>
 91 | <br>
 92 | <br>
 93 | <p>第二段</p>
 94 | ```
 95 | 
 96 | 上面的代码希望段落之间有两个换行，这时不应该使用`<br>`，而应该使用 CSS。
 97 | 
 98 | `<wbr>`标签跟`<br>`很相似，表示一个可选的断行。如果一行的宽度足够，则不断行；如果宽度不够，需要断行，就在`<wbr>`的位置的断行。它是为了防止浏览器在一个很长的单词中间，不正确地断行或者不断行，所以事先标明可以断行的位置，主要用于欧洲一些单词很长的语言或者 URL 的断行。
 99 | 
100 | ```html
101 | <p>
102 | Fernstraßen<wbr>bau<wbr>privat<wbr>finanzierungs<wbr>gesetz
103 | </p>
104 | ```
105 | 
106 | 上面代码是一个很长的德语单词，为了防止不正确断行，事先用`<wbr>`告诉浏览器，可以选择在哪里断行。
107 | 
108 | ## `<hr>`
109 | 
110 | `<hr>`用来在一篇文章中分隔两个不同的主题，浏览器会将其渲染为一根水平线。该标签是单独使用的，没有闭合标签。
111 | 
112 | ```html
113 | <p>第一个主题</p>
114 | <hr>
115 | <p>第二个主题</p>
116 | ```
117 | 
118 | 上面代码的渲染结果是，两段之间会出现一根水平线。
119 | 
120 | 该标签是历史遗留下来的，建议尽量避免使用。主题之间的分隔可以使用`<section>`，如果想要水平线的效果，可以使用 CSS。
121 | 
122 | ## `<pre>`
123 | 
124 | `<pre>`是一个块级元素，表示保留原来的格式（preformatted），即浏览器会保留该标签内部原始的换行和空格。浏览器默认以等宽字体显示标签内容。
125 | 
126 | ```html
127 | <pre>hello
128 | 
129 |    world</pre>
130 | ```
131 | 
132 | 上面代码中，换行和连续空格都会由于`<pre>`标签，而被保留下来，浏览器按照原样输出。
133 | 
134 | 注意，HTML 标签在`<pre>`里面还是起作用的。`<pre>`只保留空格和换行，不会保留 HTML 标签。
135 | 
136 | ```html
137 | <pre><strong>hello world</strong></pre>
138 | ```
139 | 
140 | 上面代码中，`<pre>`标签的内容会加粗显示。
141 | 
142 | ## `<strong>`，`<b>`
143 | 
144 | `<strong>`是一个行内元素，表示它包含的内容具有很强的重要性，需要引起注意。浏览器会以粗体显示内容。
145 | 
146 | ```html
147 | <p>开会时间是<strong>下午两点</strong>。</p>
148 | ```
149 | 
150 | `<b>`与`<strong>`很相似，也表示它包含的内容需要引起注意，浏览器会加粗显示。它是 Boldface 的缩写。
151 | 
152 | ```html
153 | <p>开会时间是<b>下午两点</b>。</p>
154 | ```
155 | 
156 | 它与`<strong>`的区别在于，由于历史原因，它没有语义，是一个纯样式的标签，违反了语义与样式分离的原则，因此不建议使用，应该优先使用`<strong>`标签。
157 | 
158 | ## `<em>`，`<i>`
159 | 
160 | `<em>`是一个行内标签，表示强调（emphasize），浏览器会以斜体显示它包含的内容。
161 | 
162 | ```html
163 | <p>我们<em>已经</em>讨论过这件事情了。</p>
164 | ```
165 | 
166 | 虽然浏览器通常会以斜体显示`<em>`，但无法保证一定如此，所以最好还是用 CSS 指定一下这个标签的样式。
167 | 
168 | `<i>`标签与`<em>`相似，也表示与其他地方有所区别，浏览器会以斜体显示。它是 Italic 的缩写。
169 | 
170 | ```html
171 | <p>我心想，这件事是<i>真的</i>吗？</p>
172 | ```
173 | 
174 | `<i>`标签的语义不强，更接近是一个纯样式的标签，建议优先使用`<em>`标签代替它。
175 | 
176 | ## `<sub>`，`<sup>`，`<var>`
177 | 
178 | `<sub>`标签将内容变为下标，`<sup>`标签将内容变为上标。它们都是行内元素，主要用于数学公式、分子式等。
179 | 
180 | ```html
181 | <p>水分子是 H<sub>2</sub>O。</p>
182 | ```
183 | 
184 | `<var>`标签表示代码或数学公式的变量。
185 | 
186 | ```html
187 | <p>勾股定理是
188 |   <var>a</var><sup>2</sup> + <var>b</var><sup>2</sup> = <var>c</var><sup>2</sup>
189 | 。</p>
190 | ```
191 | 
192 | ## `<u>`，`<s>`
193 | 
194 | `<u>`标签是一个行内元素，表示对内容提供某种注释，提醒用户这里可能有问题，基本上只用来表示拼写错误。浏览器默认以下划线渲染内容。
195 | 
196 | ```html
197 | <p>
198 | 一个容易写错的成语是把<em>安分守己</em>写成<u>安份守己</u>。
199 | </p>
200 | ```
201 | 
202 | 上面代码中，`<u>`提示用户这是一个拼写错误，“安份守己”的下方会有一个下划线。
203 | 
204 | 注意，`<u>`会产生下划线，由于链接也默认带有下划线，所以必须非常小心使用`<u>`标签，避免用户误以为可以点击。万一确有必要使用，最好使用 CSS 改变`<u>`的默认样式。
205 | 
206 | `<s>`标签是一个行内元素，为内容加上删除线。
207 | 
208 | ```html
209 | <p>今天特价商品：<s>三文鱼</s>（售完）</p>
210 | ```
211 | 
212 | 上面代码中，“三文鱼”会有一根删除线。
213 | 
214 | ## `<blockquote>`，`<cite>`，`<q>`
215 | 
216 | `<blockquote>`是一个块级标签，表示引用他人的话。浏览器会在样式上，与正常文本区别显示。
217 | 
218 | ```html
219 | <blockquote cite="https://quote.example.com">
220 |   <p>天才就是 1% 的天赋和99%的汗水。</p>
221 | </blockquote>
222 | ```
223 | 
224 | `<blockquote>`标签有一个`cite`属性，它的值是一个网址，表示引言来源，不会显示在网页上。
225 | 
226 | `<cite>`标签表示引言出处或者作者，浏览器默认使用斜体显示这部分内容。
227 | 
228 | ```html
229 | <blockquote cite="https://quote.example.com">
230 |   <p>天才就是 1% 的天赋和99%的汗水。</p>
231 | </blockquote>
232 | <cite>-- 爱迪生</cite>
233 | ```
234 | 
235 | `<cite>`不一定跟`<blockquote>`一起使用。如果文章中提到资料来源，也可以单独使用。
236 | 
237 | ```html
238 | <p>更多资料请看<cite>维基百科</cite>。</p>
239 | ```
240 | 
241 | `<q>`是一个行内标签，也表示引用。它与`<blockquote>`的区别，就是它不会产生换行。
242 | 
243 | ```html
244 | <p>
245 |   莎士比亚的《哈姆雷特》有一句著名的台词：
246 |   <q cite="https://quote.example.com">活着还是死亡，这是一个问题。</q>
247 | </p>
248 | ```
249 | 
250 | 上面例子中，引言部分跟前面的说明部分是在同一行里面。
251 | 
252 | 另外，跟`<blockquote>`一样，`<q>`也有`cite`属性，表示引言的来源网址。
253 | 
254 | 注意，浏览器默认会斜体显示`<q>`的内容，并且会自动添加半角的双引号。所以，引用中文内容时要小心。
255 | 
256 | ## `<code>`
257 | 
258 | `<code>`标签是一个行内元素，表示标签内容是计算机代码，浏览器默认会以等宽字体显示。
259 | 
260 | ```html
261 | <code>alert()</code>的作用是让网页弹出一个提示框。
262 | ```
263 | 
264 | 如果要表示多行代码，`<code>`标签必须放在`<pre>`内部。`<code>`本身仅表示一行代码。
265 | 
266 | ```html
267 | <pre>
268 | <code>
269 |   let a = 1;
270 |   console.log(a);
271 | </code>
272 | </pre>
273 | ```
274 | 
275 | ## `<kbd>`，`<samp>`
276 | 
277 | `<kbd>`标签是一个行内元素，原意是用户从键盘输入的内容，现在扩展到各种输入，包括语音输入。浏览器默认以等宽字体显示标签内容。
278 | 
279 | ```html
280 | <p>Windows 可以按下 <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Del</kbd> 重启。</p>
281 | ```
282 | 
283 | `<kbd>`可以嵌套，方便指定样式。
284 | 
285 | ```html
286 | <p>Windows 可以按下
287 | <kbd> <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Del</kbd> </kbd>
288 | 重启。</p>
289 | ```
290 | 
291 | `<samp>`标签是一个行内元素，表示计算机程序输出内容的一个例子。浏览器默认以等宽字体显示。
292 | 
293 | ```html
294 | <p>如果使用没有定义的变量，浏览器会报错：
295 | <samp>Uncaught ReferenceError: foo is not defined</samp>。
296 | </p>
297 | ```
298 | 
299 | ## `<mark>`
300 | 
301 | `<mark>`是一个行内标签，表示突出显示的内容。Chrome 浏览器默认会以亮黄色背景，显示该标签的内容。
302 | 
303 | ```html
304 | <p>我们讨论以后决定，<mark>运行会在下周三举办</mark>。</p>
305 | ```
306 | 
307 | `<mark>`很适合在引用的内容（`<q>`或`<blockquote>`）中，标记出需要关注的句子。
308 | 
309 | ```html
310 | <blockquote>
311 | 床前明月光，疑是地上霜。<mark>举头望明月，低头思故乡。</mark>
312 | </blockquote>
313 | ```
314 | 
315 | 除了标记感兴趣的文本，`<mark>`还可以用于在搜索结果中，标记出匹配的关键词。
316 | 
317 | 注意，不要只为了高亮的效果，而使用这个标签，因为不能保证浏览器的处理方式。如果要保证高亮，还是要使用 CSS 样式。
318 | 
319 | ## `<small>`
320 | 
321 | `<small>`是一个行内标签，浏览器会将它包含的内容，以小一号的字号显示，不需要使用 CSS 样式。它通常用于文章附带的版权信息或法律信息。
322 | 
323 | ```html
324 | <p>文章正文</p>
325 | <p><small>以上内容使用创意共享许可证。</small></p>
326 | ```
327 | 
328 | ## `<time>`，`<data>`
329 | 
330 | `<time>`是一个行内标签，为跟时间相关的内容提供机器可读的格式。
331 | 
332 | ```html
333 | <p>运动会预定<time datetime="2015-06-10">下周三</time>举行。</p>
334 | ```
335 | 
336 | 上面代码中，`<time>`表示下周三的具体日期。这方便搜索引擎抓取，或者下一步的其他处理。
337 | 
338 | `<time>`的`datetime`属性，用来指定机器可读的日期，可以有多种格式。
339 | 
340 | - 有效年份：`2011`
341 | - 有效月份：`2011-11`
342 | - 有效日期：`2011-11-18`
343 | - 无年份的日期：`11-18`
344 | - 年度的第几周：`2011-W47`
345 | - 有效时间：`14:54`、`14:54:39`、`14:54:39.929`
346 | - 日期和时间：`2011-11-18T14:54:39.929`
347 | 
348 | ```html
349 | <p>音乐会在<time datetime="20:00">晚上八点</time>开始。</p>
350 | ```
351 | 
352 | `<data>`标签与`<time>`类似，也是提供机器可读的内容，但是用于非时间的场合。
353 | 
354 | ```html
355 | <p>本次马拉松比赛第一名是<data value="39">张三</data></p>。
356 | ```
357 | 
358 | 上面代码中，选手的机读数据就放在`<data>`标签的`value`属性。
359 | 
360 | ## `<address>`
361 | 
362 | `<address>`标签是一个块级元素，表示某人或某个组织的联系方式。
363 | 
364 | ```html
365 | <p>作者的联系方式：</p>
366 | 
367 | <address>
368 |   <p><a href="mailto:foo@example.com">foo@example.com</a></p>
369 |   <p><a href="tel:+555-34762301">+555-34762301</a></p>
370 | </address>
371 | ```
372 | 
373 | 该标签有几个注意点。
374 | 
375 | （1）如果是文章里提到的地址（比如提到搬家前的地址），而不是联系信息，不要使用`<address>`标签。
376 | 
377 | （2）`<address>`的内容不得有非联系信息，比如发布日期。
378 | 
379 | （3）`<address>`不能嵌套，并且内部不能有标题标签（`<h1>`~`<h6>`），也不能有`<article>`、`<aside>`、`<section>`、`<nav>`、`<header>`、`<footer>`等标签。
380 | 
381 | （4）通常，`<address>`会放在`<footer>`里面，下面是一个例子。
382 | 
383 | ```html
384 | <footer>
385 |   <address>
386 |     文章的相关问题请联系<a href="mailto:zhangsan@example.com">张三
387 |     McClure</a>。
388 |   </address>
389 | </footer>
390 | ```
391 | 
392 | ## `<abbr>`
393 | 
394 | `<abbr>`标签是一个行内元素，表示标签内容是一个缩写。它的`title`属性给出缩写的完整形式，或者缩写的描述。鼠标悬停在该元素上方时，`title`属性值作为提示，会完整显示出来。
395 | 
396 | ```html
397 | <abbr title="HyperText Markup Language">HTML</abbr>
398 | ```
399 | 
400 | 注意，某些浏览器可能对该标签提供圆点下划线。
401 | 
402 | ## `<ins>`，`<del>`
403 | 
404 | `<ins>`标签是一个行内元素，表示原始文档添加（insert）的内容。`<del>`与之类似，表示删除（delete）的内容。它们通常用于展示文档的删改。
405 | 
406 | ```html
407 | <del><p>会议定于5月8日举行。</p></del>
408 | <ins><p>会议定于5月9日举行。</p></ins>
409 | ```
410 | 
411 | 浏览器默认为`<del>`标签的内容加上删除线，为`<ins>`标签的内容加上下划线。
412 | 
413 | 这两个标签都有以下属性。
414 | 
415 | - `cite`：该属性的值是一个 URL，表示该网址可以解释本次删改。
416 | - `datetime`：表示删改发生的时间。
417 | 
418 | ```html
419 | <ins cite="./why.html" datetime="2018-05">
420 |   <p>项目比原定时间提前两周结束。</p>
421 | </ins>
422 | ```
423 | 
424 | ## `<dfn>`
425 | 
426 | `<dfn>`是一个行内元素，表示标签内容是一个术语（definition），本段或本句包含它的定义。
427 | 
428 | ```html
429 | <p>
430 | 通过 TCP/IP 协议连接的全球性计算机网络，叫做 <dfn>Internet</dfn>。
431 | </p>
432 | ```
433 | 
434 | 为了脚本操作的方便，可以把术语的定义写入`<dfn>`标签的`title`属性。
435 | 
436 | ```html
437 | <p>
438 | 通过 TCP/IP 协议连接的全球性计算机网络，叫做
439 | <dfn title="全球性计算机网络">Internet</dfn>。
440 | </p>
441 | ```
442 | 
443 | 上面代码中，`title`属性的一个作用是，鼠标悬浮的时候，术语的解释会以提示的形式显示出来。
444 | 
445 | 某些时候，术语本身是一个缩写，这时`<dfn>`和`<abbr>`可以结合使用。
446 | 
447 | ```html
448 | <p>
449 | <dfn><abbr title="acquired immune deficiency syndrome">AIDS</abbr></dfn>
450 | 的全称是获得性免疫缺陷综合征。
451 | </p>
452 | ```
453 | 
454 | ## `<ruby>`
455 | 
456 | `<ruby>`标签表示文字的语音注释，主要用于东亚文字，比如汉语拼音和日语的片假名。它默认将语音注释，以小字体显示在文字的上方。
457 | 
458 | ```html
459 | <ruby>
460 | 汉<rp>(</rp><rt>han</rt><rp>)</rp>
461 | 字<rp>(</rp><rt>zi</rt><rp>)</rp>
462 | </ruby>
463 | ```
464 | 
465 | 上面代码的渲染结果是，`汉字`上方有小字体的拼音`han zi`。
466 | 
467 | `<ruby>`标签是一个行内元素，也是一个容器标签。如果要使用语音注释，就必须把文字和注释都放在这个标签里面。
468 | 
469 | `<ruby>`的内部还有许多配套的标签。
470 | 
471 | **（1）`<rp>`**
472 | 
473 | `<rp>`标签的用处，是为不支持语音注释的浏览器，提供一个兼容方案。对于那些支持语音注释的浏览器，该标签的内容不显示。
474 | 
475 | `<rp>`标签一般用于放置圆括号，如果遇到不支持的浏览器，就会将语音注释显示在括号里面。
476 | 
477 | ```html
478 | <ruby>
479 | 汉<rp>(</rp><rt>han</rt><rp>)</rp>
480 | 字<rp>(</rp><rt>zi</rt><rp>)</rp>
481 | </ruby>
482 | ```
483 | 
484 | 上面代码在不支持语音注释的浏览器中，渲染结果为`汉(han)字(zi)`。遇到支持语音注释的浏览器，就不会显示圆括号。
485 | 
486 | **（2）`<rt>`**
487 | 
488 | `<rt>`标签用于放置语音注释。
489 | 
490 | **（3）`<rb>`**
491 | 
492 | `<rb>`标签用于划分文字单位，与语音注释一一对应。
493 | 
494 | ```html
495 | <ruby>
496 |   <rb>汉</rb><rb>字</rb>
497 |   <rp>(</rp>
498 |   <rt>han</rt>
499 |   <rt>zi</rt>
500 |   <rp>)</rp>
501 | </ruby>
502 | ```
503 | 
504 | 上面例子中，`汉字`这两个字是写在一起的，`<rb>`标签用于每个字划分出来，跟`<rt>`标签一一对应。
505 | 
506 | 注意，Chrome 浏览器目前不支持这个标签。
507 | 
508 | **（4）`<rbc>`，`<rtc>`**
509 | 
510 | `<rbc>`标签表示一组文字，通常包含多个`<rb>`元素。`<rtc>`标签表示一组语音注释，跟`<rbc>`对应。
511 | 
512 | ```html
513 | <ruby style="ruby-position: under;">
514 |   <rbc>
515 |     <rb>汉</rb><rp>(</rp><rt>han</rt><rp>)</rp>
516 |     <rb>字</rb><rp>(</rp><rt>zi</rt><rp>)</rp>
517 |   </rbc>
518 |   <rtc style="ruby-position: over;">
519 |     <rp>(</rp><rt>Chinese</rt><rp>)</rp>
520 |   </rtc>
521 | </ruby>
522 | ```
523 | 
524 | 上面例子中，`汉字`这两个字有两组语音注释，分别是汉语拼音与英语。一组语音注释放在`<rbc>`标签中，另一组语音注释放在`<rtc>`，用来对应`<rbc>`。同时，分别使用`style`属性，指定汉语拼音显示在文字下方，英语显示在文字上方。
525 | 
526 | 注意，Chrome 浏览器目前不支持这两个标签。
527 | 
528 | ## `<bdo>`，`<bdi>`
529 | 
530 | 大部分文字的阅读方向是从左到右，但是有些文字的方向是从右到左，比如阿拉伯语、希伯来语等。`<bdo>`标签是一个行内元素，表示文字方向与网页主体内容的方向不一致。
531 | 
532 | ```html
533 | <p>床前明月光，<bdo dir="rtl">霜上地是疑</bdo>。</p>
534 | ```
535 | 
536 | 上面代码中，`<bdo>`标签里面的文字，会以相反的方向渲染，结果就是“床前明月光，疑是地上霜”。
537 | 
538 | `<bdo>`的`dir`属性，指定具体的文字方向。它有两个值，`ltr`表示从左到右，`rtl`表示从右到左。
539 | 
540 | `<bdi>`标签用于不确定文字方向的情况。比如，网页有一个部分是用户输入的内容，但是不知道输入内容的文字方向。这种情况就可以使用`<bdi>`标签，告诉浏览器，不确定文字的方向，由浏览器自己决定。
541 | 
542 | ```html
543 | <p><bdi>床前明月光，疑是地上霜。</bdi></p>
544 | ```
545 | 
546 | 


--------------------------------------------------------------------------------
/docs/url.md:
--------------------------------------------------------------------------------
  1 | # URL 简介
  2 | 
  3 | ## 概述
  4 | 
  5 | URL 是“统一资源定位符”（Uniform Resource Locator）的首字母缩写，中文译为“网址”，表示各种资源的互联网地址。下面就是一个典型的 URL。
  6 | 
  7 | ```html
  8 | https://www.example.com/path/index.html
  9 | ```
 10 | 
 11 | 所谓资源，可以简单理解成各种可以通过互联网访问的文件，比如网页、图像、音频、视频、JavaScript 脚本等等。只有知道了它们的 URL，才能在互联网上获取它们。
 12 | 
 13 | 只要资源可以通过互联网访问，它就必然有对应的 URL。一个 URL 对应一个资源，但是同一个资源可能对应多个 URL。
 14 | 
 15 | URL 是互联网的基础。互联网之所以“互联”，就是因为网页可以通过“链接”（link），包含其他 URL。用户只要点击，就可以从一个 URL 跳转到另一个 URL，前往不同的网站。
 16 | 
 17 | ## 网址的组成部分
 18 | 
 19 | URL 由多个部分组成。下面是一个比较复杂的 URL，实际的 URL 通常不会有这么多部分。
 20 | 
 21 | ```html
 22 | https://www.example.com:80/path/to/myfile.html?key1=value1&key2=value2#anchor
 23 | ```
 24 | 
 25 | 我们看看，这个 URL 的各个部分。
 26 | 
 27 | ### 协议
 28 | 
 29 | 协议（scheme）是浏览器请求服务器资源的方法，上例是`https://`的部分，表示使用 HTTPS 协议。
 30 | 
 31 | 互联网支持多种协议，必须指明网址使用哪一种协议，默认是 HTTP 协议。也就是说，如果省略协议，直接在浏览器地址栏输入`www.example.com`，那么浏览器默认会访问`http://www.example.com`。HTTPS 是 HTTP 的加密版本，出于安全考虑，越来越多的网站使用这个协议。
 32 | 
 33 | HTTP 和 HTTPS 的协议名称后面，紧跟着一个冒号和两个斜杠（`://`）。其他协议不一定如此，邮件地址协议`mailto:`的协议名后面只有一个冒号，比如`mailto:foo@example.com`。
 34 | 
 35 | ### 主机
 36 | 
 37 | 主机（host）是资源所在的网站名或服务器的名字，又称为域名。上例的主机是`www.example.com`。
 38 | 
 39 | 有些主机没有域名，只有 IP 地址，比如`192.168.2.15`。这种情况常常出现在局域网。
 40 | 
 41 | ### 端口
 42 | 
 43 | 同一个域名下面可能同时包含多个网站，它们之间通过端口（port）区分。“端口”就是一个整数，可以简单理解成，访问者告诉服务器，想要访问哪一个网站。HTTP 协议的默认端口是80，如果省略了这个参数，服务器就会返回80端口的网站。
 44 | 
 45 | 端口紧跟在域名后面，两者之间使用冒号分隔，比如`www.example.com:80`。
 46 | 
 47 | ### 路径
 48 | 
 49 | 路径（path）是资源在网站的位置。比如，`/path/index.html`这个路径，指向网站的`/path`子目录下面的网页文件`index.html`。
 50 | 
 51 | 互联网的早期，路径是真实存在的物理位置。现在由于服务器可以模拟这些位置，所以路径只是虚拟位置。
 52 | 
 53 | 路径可能只包含目录，不包含文件名，比如`/foo/`，甚至结尾的斜杠都可以省略。这时，服务器通常会默认跳转到该目录里面的`index.html`文件（即等同于请求`/foo/index.html`），但也可能有其他的处理（比如列出目录里面的所有文件），这取决于服务器的设置。一般来说，访问`www.example.com`这个网址，很可能返回的是网页文件`www.example.com/index.html`。
 54 | 
 55 | ### 查询参数
 56 | 
 57 | 查询参数（parameter）是提供给服务器的额外信息。参数的位置是在路径后面，两者之间使用`?`分隔，上例是`?key1=value1&key2=value2`。
 58 | 
 59 | 查询参数可以有一组或多组。每组参数都是键值对（key-value pair）的形式，同时具有键名(key)和键值(value)，它们之间使用等号（`=`）连接。比如，`key1=value`就是一个键值对，`key1`是键名，`value1`是键值。
 60 | 
 61 | 多组参数之间使用`&`连接，比如`key1=value1&key2=value2`。
 62 | 
 63 | ### 锚点
 64 | 
 65 | 锚点（anchor）是网页内部的定位点，使用`#`加上锚点名称，放在网址的最后，比如`#anchor`。浏览器加载页面以后，会自动滚动到锚点所在的位置。
 66 | 
 67 | 锚点名称通过网页元素的`id`属性命名，详见《元素的属性》一章。
 68 | 
 69 | ## URL 字符
 70 | 
 71 | URL 的各个组成部分，只能使用以下这些字符。
 72 | 
 73 | - 26个英语字母（包括大写和小写）
 74 | - 10个阿拉伯数字
 75 | - 连词号（`-`）
 76 | - 句点（`.`）
 77 | - 下划线（`_`）
 78 | 
 79 | 此外，还有18个字符属于 URL 的保留字符，只能在给定的位置出现。比如，查询参数的开头是问号（`?`），也就是说，问号只能出现查询参数的开头，出现在其他位置就是非法的，会导致网址解析错误。网址的其他部分如果要使用这些保留字符，必须使用它们的转义形式。
 80 | 
 81 | URL 字符转义的方法是，在这些字符的十六进制 ASCII 码前面加上百分号（`%`）。下面是这18个字符及其转义形式。
 82 | 
 83 | - `!`：%21
 84 | - `#`：%23
 85 | - `$`：%24
 86 | - `&`：%26
 87 | - `'`：%27
 88 | - `(`：%28
 89 | - `)`：%29
 90 | - `*`：%2A
 91 | - `+`：%2B
 92 | - `,`：%2C
 93 | - `/`：%2F
 94 | - `:`：%3A
 95 | - `;`：%3B
 96 | - `=`：%3D
 97 | - `?`：%3F
 98 | - `@`：%40
 99 | - `[`：%5B
100 | - `]`：%5D
101 | 
102 | 举例来说，有一个网页的 URL 是`foo?bar.html`，即文件里面包含一个问号，那么需要写成`foo%3Fbar.html`。
103 | 
104 | URL 的合法字符，其实也可以采用这种转义方法，但是不建议使用。比如，字母`a`的十六进制 ASCII 码是`61`，转义形式后就是`%61`。因此，`www.apple.com`又可以写成`www.%61pple.com`，浏览器一样识别。
105 | 
106 | 值得注意的是，空格的转义形式是`%20`。对于那些包含空格的文件名，这个转义是必须的。
107 | 
108 | 既不属于合法字符、也不属于保留字符的其他字符（比如汉字），理论上不需要手动转义，可以直接写在 URL 里面，比如`www.example.com/中国.html`，浏览器会自动将它们转义，发给服务器。转义方法是使用这些字符的十六进制 UTF-8 编码，每两位算作一组，然后每组头部添加百分号（`%`）。
109 | 
110 | 举例来说，汉字`中`的 UTF-8 十六进制编码是`e4b8ad`，每两个字符一组，URL 转义后就为`%e4%b8%ad`。也就是说，URL 里面凡是有汉字`中`的地方，都要写成`%e4%b8%ad`。因此，访问`www.example.com/中国.html`这个网址，需要写成下面的样子。
111 | 
112 | ```html
113 | www.example.com/%e4%b8%ad%e5%9b%bd.html
114 | ```
115 | 
116 | 上面代码中，`中`的转义形式是`%e4%b8%ad`，`国`是`%e5%9b%bd`。
117 | 
118 | ## 绝对 URL 和相对 URL
119 | 
120 | URL 分成两种：绝对 URL 和相对 URL。
121 | 
122 | 绝对 URL 指的是，只靠 URL 本身就能确定资源的位置。这意味着，URL 必须带有资源的完整信息，包含协议、主机、路径等部分。前面的例子都是绝对 URL。
123 | 
124 | 相对 URL 指的是，URL 不包含资源位置的全部信息，必须结合当前网页的位置，才能定位资源。比如，当前网页的 URL 是`https://www.example.com/path/index.html`，该网页上面有一个资源，URL 指向`a.html`，这个就是相对 URL。因为只知道`a.html`，并不能定位资源。浏览器假定，`a.html`与当前网址在同一个子目录下面，从而得到绝对 URL `https://www.example.com/path/a.html`。
125 | 
126 | 相对 URL 如果以斜杠（`/`）开头，就表示网站的根目录。否则，必须以当前目录为起点，推算资源的位置。比如，相对 URL `/foo/bar.html`表示网站根目录的子目录`foo`，`foo/bar.html`表示在当前目录的`foo`子目录。
127 | 
128 | URL 还可以使用两个特殊简写，表示特定位置。
129 | 
130 | - `.`：表示当前目录，比如`./a.html`（当前目录下的`a.html`文件）
131 | - `..`：表示上级目录，比如`../a.html`（上级目录下的`a.html`文件）
132 | 
133 | 这两种简写可以多个连用，比如`../../`表示上两级目录。
134 | 
135 | 绝对 URL 也可以使用这两个简写，比如`www.example.com/./index.html`等同于`www.example.com/index.html`，这时`.`相当于根目录的当前目录，即根目录本身。
136 | 
137 | ## `<base>`
138 | 
139 | `<base>`标签指定网页内部的所有相对 URL 的计算基准。整张网页只能有一个`<base>`标签，而且只能放在`<head>`里面。它是单独使用的标签，没有闭合标签，下面是一个例子。
140 | 
141 | ```html
142 | <head>
143 | <base href="https://www.example.com/files/" target="_blank">
144 | </head>
145 | ```
146 | 
147 | `<base>`标签的`href`属性给出计算的基准网址，`target`属性给出如何打开链接的说明（参见《链接》一章）。已知计算基准是`https://www.example.com/files/`，那么相对 URL `foo.html`，就可以转成绝对 URL `https://www.example.com/files/foo.html`。
148 | 
149 | 注意，`<base>`标签必须至少具有`href`属性或`target`属性之一。
150 | 
151 | ```html
152 | <base href="http://foo.com/app/">
153 | <base target="_blank">
154 | ```
155 | 
156 | 一旦设置了`<base>`，就对整个网页都有效。如果要改变某个链接的行为，只能用绝对链接替代相对链接。尤其需要注意锚点，这时锚点也是针对`<base>`计算的，而不是针对当前网页的 URL。
157 | 
158 | 


--------------------------------------------------------------------------------
/loppo.yml:
--------------------------------------------------------------------------------
 1 | dir: docs
 2 | output: dist
 3 | site: html
 4 | theme: wangdoc
 5 | customization: false
 6 | themeDir: loppo-theme
 7 | direction: ltr
 8 | id: html
 9 | hasComments: true
10 | isTutorial: true
11 | 


--------------------------------------------------------------------------------
/package.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "name": "html-tutorial",
 3 |   "version": "1.0.0",
 4 |   "description": "HTML 语言教程",
 5 |   "main": "index.js",
 6 |   "directories": {
 7 |     "doc": "docs"
 8 |   },
 9 |   "scripts": {
10 |     "build": "loppo --site \"HTML 教程\" --id html --theme wangdoc",
11 |     "build-and-commit": "npm run build && npm run commit",
12 |     "commit": "gh-pages --dist dist --dest dist/html --branch master --repo git@github.com:wangdoc/website.git",
13 |     "chapter": "loppo chapter",
14 |     "server": "loppo server"
15 |   },
16 |   "repository": {
17 |     "type": "git",
18 |     "url": "git+https://github.com/wangdoc/html-tutorial.git"
19 |   },
20 |   "keywords": [
21 |     "HTML",
22 |     "tutorial"
23 |   ],
24 |   "author": "Ruan Yifeng",
25 |   "license": "CC-BY-SA-4.0",
26 |   "bugs": {
27 |     "url": "https://github.com/wangdoc/html-tutorial/issues"
28 |   },
29 |   "homepage": "https://github.com/wangdoc/html-tutorial#readme",
30 |   "dependencies": {
31 |     "gh-pages": "^3.2.3",
32 |     "loppo": "^0.6.24",
33 |     "loppo-theme-wangdoc": "^0.6.1"
34 |   }
35 | }
36 | 


--------------------------------------------------------------------------------
/wangdoc-deploy-rsa.enc:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wangdoc/html-tutorial/edfee2e579e82302dfbcbce87a36b2a1501ac77f/wangdoc-deploy-rsa.enc


--------------------------------------------------------------------------------