前端-01-HTML基础
这篇笔记讲什么
HTML 不"编程",它只做一件事:给内容贴上语义标签。这篇从文档骨架讲到大全级的元素用法,重点是三块新手最容易糊弄过去的内容——语义化标签的选型、表单的可提交契约(
name/value)、可访问性(Accessibility,常缩写为 a11y)。读完你应该能独立写出一个结构正确、能被屏幕阅读器读懂、能通过 W3C 校验的个人主页。
是什么
HTML(HyperText Markup Language,超文本标记语言)是描述网页结构的标记语言。它不是编程语言:没有变量、没有循环、没有条件分支,只有一层层嵌套的元素(element),而每个元素都在说"包在里面的这段内容,语义上是什么"。
一个最小的 HTML 文档只有 5 行:
<!DOCTYPE html>
<html lang="zh-CN">
<head><meta charset="utf-8"><title>标题</title></head>
<body><p>你好,世界</p></body>
</html>
浏览器解析它之后,会在内存里建出一棵 DOM 树(Document Object Model Tree),CSS 负责给这棵树"上色",JavaScript 负责让它"动起来"。三者的分工是本篇的第一条主线。
为什么
为什么 2026 年了还要老老实实学 HTML?因为它承担着三个别人替代不了的职责:
- 它是唯一的"意义层"。搜索引擎、屏幕阅读器、浏览器阅读模式、自动化测试工具都只能通过标签判断"这块内容是正文还是广告、是导航还是页脚"。你用
<div>堆出来的页面在视觉上和<article>一模一样,但对机器来说是一堆无名方块。 - 它是可访问性的落点。视障用户用屏幕阅读器(如 NVDA、VoiceOver)逐标签朗读页面。
<h1>是可以跳转的层级,<div class="title">什么都不是。 - 它有原生能力。表单校验(
required/pattern/type="email")、懒加载(loading="lazy")、响应式图片(srcset)、日期选择器、自动填充,这些浏览器都免费提供。用 JS 重写一遍只会更慢、更容易出 bug,还更难被无障碍工具识别。
核心结论
先写 HTML 结构(内容与语义),再加 CSS 表现,最后加 JS 行为。顺序颠倒会导致:结构里塞满只为样式服务的空
<div>,语义丢失且后期无法维护。
核心内容
一、结构 / 表现 / 行为分离
| 层次 | 技术 | 负责什么 | 该放什么 | 不该放什么 |
|---|---|---|---|---|
| 结构(Structure) | HTML | 内容是什么 | 标题、段落、列表、表单字段、图片替代文本 | 颜色、字号、间距 |
| 表现(Presentation) | CSS | 长什么样 | 布局、颜色、字体、动画 | 内容文本、语义信息 |
| 行为(Behavior) | JavaScript | 做什么 | 交互、数据请求、状态管理 | 首屏渲染必需的内容 |
分离的实际收益:换皮只改 CSS、SEO 与无障碍只依赖 HTML、无 JS 时页面仍可阅读。style="..." 行内样式和 <font>(已废弃)之所以被劝退,是因为它们把表现焊死在结构上。
二、文档骨架逐行解释
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>页面标题——出现在标签页与搜索结果里</title>
</head>
<body>
<h1>可见内容的开始</h1>
</body>
</html>
| 行 | 作用 | 不写的后果 |
|---|---|---|
<!DOCTYPE html> | 告诉浏览器按 标准模式(Standards Mode) 解析 | 进入怪异模式(Quirks Mode),盒模型计算、行高、百分比高度等按 1990 年代老规则来,布局莫名其妙错位 |
<html lang="zh-CN"> | 文档根元素;lang 声明内容语言 | 屏幕阅读器可能用英文语音朗读中文;浏览器可能不弹出中文翻译提示;连字符断行规则失效 |
<head> | 放元数据(metadata),不渲染可见内容 | — |
<meta charset="utf-8"> | 声明字符编码 | 中文乱码("锟斤拷");必须放在 <head> 前 1024 字节内,否则声明无效 |
<meta name="viewport" ...> | 移动端视口宽度等于设备宽度、初始缩放为 1 | 手机上页面被当成 980px 宽的桌面页缩放着看,字小到看不清 |
<title> | 标签页标题、搜索结果标题、收藏夹默认名 | 用户无法区分多个标签页;SEO 直接受损 |
<body> | 放所有可见内容 | — |
lang的正确写法常用值:
zh-CN(简体中文)、zh-TW(繁体)、en、ja。整页用一种语言时写在<html>上;页面内某段是外语时,在那一小段上再写一次lang="en",屏幕阅读器会自动切换发音。
三、元素与标签的区别
这两个词经常被混着用,但含义不同:
- 标签(tag):源码里的尖括号写法,如起始标签
<p>、结束标签</p>。 - 元素(element):从起始标签到结束标签、连同里面的内容构成的整体,即
<p>你好</p>整个是一个段落元素。 - 空元素(void element):没有内容也没有结束标签,如
<img>、<br>、<hr>、<input>、<meta>、<link>。
<!-- 起始标签 + 内容 + 结束标签 = 一个元素 -->
<p class="intro">这是一段<strong>重要</strong>文字。</p>
<!-- 空元素:没有结束标签,自闭合斜杠是可选的 -->
<img src="avatar.png" alt="我的头像">
<br>
<input type="text" name="nickname">
元素可以嵌套,但不能交叉。<p><strong>文字</p></strong> 是错误写法:浏览器会自行"修复"成它猜的结构,结果往往不是你想要的(DOM 里可能出现空 <strong>)。
四、属性
属性写在起始标签里,格式为 名="值"。有些属性是布尔属性(boolean attribute):只要出现就是真,值写不写都行,hidden=""、hidden="hidden"、hidden 三者等价,但 hidden="false" 仍然是真——这是高频误解。
全局属性表(几乎所有元素都能用)
| 属性 | 作用 | 典型用法与注意点 |
|---|---|---|
id | 文档内唯一标识 | 锚点跳转、<label for> 关联、JS getElementById。同一 id 不可重复,重复不会报错但行为不确定 |
class | 可复用的分类名 | 可写多个,空格分隔:class="btn btn-primary"。CSS/JS 的主要挂钩点 |
style | 行内 CSS | 优先级极高,难覆盖、难复用。仅用于动态计算出来的值(如 JS 拖拽时的 left) |
data-* | 自定义数据 | data-user-id="42",JS 用 el.dataset.userId 读取。这是"把数据放进 HTML"的官方通道 |
title | 悬停提示补充信息 | 移动端与键盘用户基本看不到,不能用它承载关键信息 |
hidden | 隐藏元素 | 等价于 display: none(可被 CSS 覆盖)。语义上表示"当前不相关" |
lang | 内容语言 | 见上文 |
tabindex | 键盘焦点顺序 | 0 表示进入正常 Tab 序列,-1 表示可被 JS .focus() 但不参与 Tab,正数几乎总是坏主意 |
contenteditable | 让元素可编辑 | 简单富文本编辑器的起点 |
draggable | 可拖拽 | 配合拖拽事件使用 |
五、语义化标签(Semantic Elements)
语义化指用标签本身表达内容的角色,而不是用 <div> + 类名暗示。核心问题是:这块内容在文档里承担什么职责?
| 标签 | 适用场景 | 判断标准(一句话自测) | 不要用于 |
|---|---|---|---|
<header> | 页面或某个区域的头部 | "这里是标题 + logo + 搜索框" | 整页只能有一个的想法是错的——<article> 里可以有它自己的 <header> |
<nav> | 主要导航链接组 | "这是一组跳转链接" | 页脚里零散的法务链接;不是所有链接组都需要 nav |
<main> | 页面唯一的主内容 | "去掉头尾和侧栏,剩下的就是它" | 每页只用一个,且不能嵌在 <article>/<aside>/<nav> 内 |
<article> | 可独立分发、脱离上下文仍成立的内容 | "这条内容能单独发到 RSS 里吗?" | 纯装饰性区块 |
<section> | 有主题的章节,通常自带标题 | "这里能起一个小标题吗?" | 纯粹为了套一个样式容器(那是 <div> 的活) |
<aside> | 与主内容相关但可分离的补充 | "这是侧栏/广告/相关阅读" | 主内容的一部分 |
<footer> | 页面或区域的页脚 | "版权、联系方式、备案号" | — |
<figure> + <figcaption> | 图、代码、图表等自包含内容 + 说明文字 | "这段内容需要一个编号/说明" | 纯装饰性图片 |
<body>
<header>
<h1>张三的简历</h1>
<nav aria-label="页面导航">
<ul>
<li><a href="#skills">技能</a></li>
<li><a href="#projects">项目</a></li>
</ul>
</nav>
</header>
<main>
<article>
<section id="skills">
<h2>技能</h2>
<p>熟悉 HTML、CSS 与可访问性基础。</p>
</section>
<section id="projects">
<h2>项目</h2>
<figure>
<img src="demo.png" alt="项目首页截图,顶部是导航栏,中间是三列卡片">
<figcaption>图 1:项目首页布局</figcaption>
</figure>
</section>
</article>
<aside>
<h2>相关阅读</h2>
<p>延伸资料见文末。</p>
</aside>
</main>
<footer>
<p>© 2026 张三 · 联系方式:<a href="mailto:me@example.com">me@example.com</a></p>
</footer>
</body>
语义化带来的三类价值:
| 收益 | 具体机制 |
|---|---|
| SEO | 搜索引擎抓取时用 <h1>–<h6> 建立主题层级,用 <article>/<main> 判断正文权重,<nav> 里的链接权重通常低于正文链接 |
| 可访问性 | 屏幕阅读器提供"按地标(landmark)跳转"功能,用户能一键跳到 <main> 或 <nav>;<button> 天然可聚焦、响应 Enter/Space,<div onclick> 不能 |
| 可维护性 | 结构自解释,新人不用猜 class="f12-ccc" 是什么;样式重构时语义不变 |
判断口诀
想写
<div>时先问三句:这块内容能独立成篇吗?(article)它有主题吗?(section)它承担可识别的页面职责吗?(header/nav/main/aside/footer)三个都否,才用<div>。三个都否但需要一个纯样式容器时,<div>正是正确选择——语义化不是"禁止 div"。
六、文本内容标签
| 标签 | 含义 | 关键规则 |
|---|---|---|
<h1>–<h6> | 六级标题 | 不要跳级:h1 后直接 h3 会让屏幕阅读器的"按标题导航"出现断档。一页通常只有一个 <h1>(HTML 标准并未强制,但这是广泛共识与 a11y 实践)。不要为了字号选级别,字号交给 CSS |
<p> | 段落 | 只能包含短语内容(phrasing content),不能嵌 <div>/<p>;块级元素会出现自动闭合 |
<strong> | 重要性强调 | 语义是"这段内容很重要",屏幕阅读器会重读。用于警告、关键结论 |
<b> | 视觉加粗,无语义 | 用于产品名、关键词高亮等"样式性加粗"。不确定时用 <strong> |
<em> | 强调重音 | 改变句子意思的重音,如"我没说你偷了钱" |
<i> | 视觉斜体 / 惯用文本 | 外语词、术语、内心独白 |
<br> | 换行 | 只用于诗歌、地址等内容本身需要换行的场合。不要用它做段落间距(那是 margin) |
<hr> | 主题分隔 | 语义是"段落级话题转换",不是一条装饰线 |
<blockquote> + cite | 块级引用 | cite 属性放来源 URL(不是引用文字) |
<q> | 行内引用 | 浏览器会自动加引号 |
<code> | 行内代码 | 等宽字体,语义是"代码" |
<pre> | 保留空白与换行 | 常与 <code> 组合成代码块:<pre><code>...</code></pre> |
<time datetime="2026-10-11"> | 机器可读时间 | datetime 用 ISO 格式,显示文字可以随意 |
<abbr title="Cascading Style Sheets">CSS</abbr> | 缩写 | title 提供全称 |
<mark> | 高亮 | 表示"因搜索/上下文而相关" |
<small> | 附属细则 | 版权、免责声明 |
<h2>为什么推荐 rem 而不是 em</h2>
<p><strong>注意:</strong>嵌套使用 <code>em</code> 时长度会<em>逐层复利</em>,很容易算出非预期的字号。</p>
<blockquote cite="https://developer.mozilla.org/zh-CN/docs/Web/CSS/Reference/Values/length">
<p>相对长度单位相对于其他长度来定义。</p>
</blockquote>
<p>代码块要这样写:</p>
<pre><code>html { font-size: 100%; }
.card { padding: 1rem; }</code></pre>
<hr>
<p><small>最后更新:<time datetime="2026-10-11">2026 年 10 月 11 日</time></small></p>
七、列表
| 类型 | 标签 | 何时用 |
|---|---|---|
| 无序列表 | <ul> + <li> | 顺序无关:导航菜单、特性清单、标签云 |
| 有序列表 | <ol> + <li> | 顺序有意义:步骤、排行榜、法律条款。可用 start、reversed、type 调整 |
| 描述列表 | <dl> + <dt> + <dd> | 术语—解释配对:FAQ、术语表、键值对展示 |
<ol>
<li>打开开发者工具(F12)</li>
<li>切到 Elements 面板</li>
<li>选中元素查看盒模型</li>
</ol>
<dl>
<dt>HTML</dt>
<dd>负责结构。</dd>
<dt>CSS</dt>
<dd>负责表现。</dd>
</dl>
导航菜单 ≠ 列表可以省
<nav>里应当放<ul>。屏幕阅读器会播报"列表,3 项",用户从而知道菜单有多长;直接堆<a>会丢失这个信息。
八、链接与锚点
<!-- 站外链接 -->
<a href="https://developer.mozilla.org/zh-CN/" rel="noopener noreferrer" target="_blank">MDN 中文</a>
<!-- 页内锚点:href 以 # 开头,对应目标元素的 id -->
<a href="#skills">跳到技能</a>
<h2 id="skills">技能</h2>
<!-- 跳到页面顶部(id 无需存在) -->
<a href="#">回到顶部</a>
<!-- 邮件与电话 -->
<a href="mailto:me@example.com?subject=你好">发邮件</a>
<a href="tel:+8613800000000">拨打电话</a>
<!-- 下载 -->
<a href="resume.pdf" download="张三-简历.pdf">下载简历</a>
链接文字(link text)必须是自解释的。屏幕阅读器有"列出本页所有链接"功能,一串"点击这里 / 更多 / 阅读全文"对用户毫无意义,必须改成"查看 CSS 盒模型详解"这类描述性文字。
target="_blank" 在新标签页打开时,要加 rel="noopener":否则新页面可以通过 window.opener 反向操作你的页面(钓鱼跳转)。noreferrer 顺带隐藏来源信息。
九、图片
<!-- 基础:alt 是必需的 -->
<img src="chart.png" alt="2025 年各季度营收柱状图,Q4 最高" width="800" height="450">
<!-- 懒加载:滚动到附近才请求 -->
<img src="photo.jpg" alt="团队合影" loading="lazy" decoding="async">
<!-- 响应式:按条件挑选源文件,浏览器只下载一个 -->
<img
src="hero-800.jpg"
srcset="hero-400.jpg 400w, hero-800.jpg 800w, hero-1600.jpg 1600w"
sizes="(max-width: 600px) 100vw, 800px"
alt="产品主图"
width="800" height="450">
| 属性 | 作用 | 不写的代价 |
|---|---|---|
alt | 图片的文字替代 | 图片加载失败时是空白;屏幕阅读器会朗读整个文件名("IMG_2043.JPG");不合规 |
width / height | 提供固有宽高比 | 图片加载完成后把下方内容"顶下去",产生累积布局偏移(CLS),体验很差 |
loading="lazy" | 延迟加载 | 首屏加载浪费带宽。首屏大图不要用,反而会拖慢 |
srcset / sizes | 多分辨率选择 | 手机上也要下载桌面大图 |
decoding="async" | 不阻塞渲染的解码 | 大图解码时可能卡顿 |
alt 的三种写法(这是新手最容易写错的点):
| 情境 | 写法 | 理由 |
|---|---|---|
| 图片承载信息 | alt="2025 年营收柱状图,Q4 达 1200 万" | 替代文本要传达同样的信息,不是描述"这是一张图" |
| 纯装饰性图片 | alt=""(空字符串) | 明确告诉屏幕阅读器跳过它。不写 alt 和写 alt="" 完全不同 |
| 图片在链接内 | alt="返回首页" | 此时 alt 成了链接文字,必须说明链接去向 |
alt缺失 vsalt=""缺少
alt属性时,屏幕阅读器会退而朗读文件名;alt=""才是"这张图无需播报"。装饰图用后者,且不要顺手加role="presentation"——空 alt 已经够了。
十、表格
表格只能用于数据,绝不能用来做页面布局(那是 2005 年的做法,会摧毁无障碍与响应式)。
<table>
<caption>2026 年第一季度各渠道访问量</caption>
<thead>
<tr>
<th scope="col">渠道</th>
<th scope="col">访问量</th>
<th scope="col">转化率</th>
</tr>
</thead>
<tbody>
<tr>
<th scope="row">搜索</th>
<td>12,400</td>
<td>3.2%</td>
</tr>
<tr>
<th scope="row">社交媒体</th>
<td>8,100</td>
<td>1.8%</td>
</tr>
</tbody>
<tfoot>
<tr>
<th scope="row">合计</th>
<td>20,500</td>
<td>—</td>
</tr>
</tfoot>
</table>
| 部分 | 作用 | 关键点 |
|---|---|---|
<caption> | 表格标题 | 必须是 table 的第一个子元素;屏幕阅读器会先读它 |
<thead> / <tbody> / <tfoot> | 表头、主体、汇总 | 语义分区,长表格打印时表头可重复 |
<th> | 表头单元格 | 默认加粗居中(可用 CSS 改) |
<th scope="col"> | 声明这列的表头 | 屏幕阅读器朗读数据单元格时会先报列名 |
<th scope="row"> | 声明这行的表头 | 同上,用于行首标签 |
colspan / rowspan | 跨列 / 跨行 | 只在数据确有合并时使用,会让 a11y 播报复杂 |
十一、表单
表单是 HTML 里唯一能与服务器双向交互的部分,也是最容易写错语义的地方。它有三条铁律:
- 每个控件都必须有
<label>(或aria-label)。 - 要提交的数据靠
name标识,靠value承载。没有name的控件不会被提交。 - 优先用原生校验属性,不要一上来就写 JS 校验。
form 与 input 的完整 type 清单
<form action="/api/resume" method="post" enctype="multipart/form-data" novalidate>
...
</form>
form 属性 | 作用 |
|---|---|
action | 提交地址 |
method | get(参数拼在 URL,可收藏、有长度限制)或 post(放请求体,用于写操作与文件) |
enctype | post 时的编码;上传文件必须为 multipart/form-data |
novalidate | 关闭浏览器原生校验(通常用于改为自己校验时) |
target | 提交结果在哪个浏览上下文打开,如 _blank |
autocomplete | on / off,控制自动填充 |
input 的 type 完整清单(HTML 标准定义的 22 种):
type | 外观 / 行为 | 移动端键盘 / 附加能力 |
|---|---|---|
text | 单行文本 | 普通键盘 |
password | 掩码显示 | 普通键盘,value 不显示 |
email | 邮箱 | @ 与 . 键;多值可用 multiple;原生格式校验 |
tel | 电话 | 数字键盘;格式因地区而异,故不自动校验 |
url | 网址 | / 与 .com 键;原生 URL 校验 |
search | 搜索框 | 右侧可能出现清除按钮 |
number | 数字输入 | 带上下微调;可用 min/max/step |
range | 滑块 | 默认 0–100,配 min/max/step |
date | 日期选择器 | value 必须是 YYYY-MM-DD |
time | 时间选择器 | HH:MM |
datetime-local | 日期 + 时间 | YYYY-MM-DDTHH:MM |
month | 年月 | YYYY-MM |
week | 年 + 周 | YYYY-Www |
color | 颜色选择器 | 值为 #rrggbb |
checkbox | 复选框 | 多个可同时选中;同一组用相同 name,value 区分 |
radio | 单选按钮 | 同组必须 name 相同才能互斥 |
file | 文件选择 | 需要表单 enctype="multipart/form-data";accept 限制类型,multiple 多选 |
hidden | 不可见 | 用于传递上下文(如 CSRF token);用户可篡改,绝不能放权限信息 |
submit | 提交按钮 | value 是按钮文字 |
reset | 重置按钮 | 恢复到初始值,实际项目里少用 |
image | 图片提交按钮 | 用 src/alt,比 submit 更少用 |
button | 无默认行为的按钮 | 纯 JS 按钮用它(也可直接用 <button type="button">) |
label 关联:三种正确写法
<!-- 写法 1(推荐):for 指向控件的 id -->
<label for="email">邮箱</label>
<input type="email" id="email" name="email">
<!-- 写法 2:把控件包在 label 里,无需 for -->
<label>
昵称
<input type="text" name="nickname">
</label>
<!-- 写法 3:确实无法显示标签时(如图标按钮),用 aria-label -->
<input type="search" name="q" aria-label="站内搜索">
关联上之后有三重收益:点标签文字就能聚焦控件(小屏幕上尤其重要)、屏幕阅读器会朗读标签、语音输入用户可以念出标签名来定位。
原生校验属性
| 属性 | 适用于 | 作用 |
|---|---|---|
required | 大多数输入类控件 | 非空校验(布尔属性) |
minlength / maxlength | 文本类 | 字符数下限 / 上限 |
min / max | number、range、日期时间类 | 数值 / 日期范围 |
step | number、range、日期时间类 | 步长;step="any" 表示不限 |
pattern | 文本类 | 正则(隐式整串匹配,无需 ^...$) |
type | — | email/url/number 自带格式校验 |
multiple | email、file | 允许多值 / 多文件 |
autocomplete | 表单与控件 | 控制自动填充,如 autocomplete="new-password" |
inputmode | 文本类 | 只改移动端键盘,不改语义,如 inputmode="numeric" |
readonly / disabled | 大多数控件 | readonly 可聚焦可提交;disabled 不可聚焦且不会提交 |
placeholder | 文本类 | 提示文字,不能替代 label(输入后就消失) |
<p>
<label for="pwd">密码</label>
<input type="password" id="pwd" name="password"
required minlength="8" pattern="(?=.*\d)(?=.*[a-zA-Z]).{8,}"
autocomplete="new-password"
aria-describedby="pwd-hint">
<small id="pwd-hint">至少 8 位,且同时包含字母和数字。</small>
</p>
pattern 校验失败时页面不会自动告诉用户原因。要让提示既可见又可被朗读,需要用 aria-describedby 把说明文字与控件关联(如上例),或用 JS 在 invalid 事件里补充提示。
select / textarea / button
<!-- 下拉选择:分组用 optgroup,占位项用 value="" 且 disabled selected -->
<label for="city">城市</label>
<select id="city" name="city" required>
<option value="">请选择</option>
<optgroup label="华东">
<option value="sh">上海</option>
<option value="hz">杭州</option>
</optgroup>
<optgroup label="华南">
<option value="gz">广州</option>
</optgroup>
</select>
<!-- 多行文本:内容是标签之间的文字,不是 value 属性 -->
<label for="intro">自我介绍</label>
<textarea id="intro" name="intro" rows="5" cols="40" maxlength="500"></textarea>
<!-- 三种按钮:默认 type 是 submit,务必显式写 -->
<button type="submit">提交</button>
<button type="reset">重置</button>
<button type="button" onclick="alert('仅交互')">预览</button>
| 对比项 | <select> | <textarea> |
|---|---|---|
| 值的位置 | <option value="..."> | 标签之间的文本内容 |
| 多选 | multiple 属性(体验差,慎用) | — |
| 尺寸控制 | size(显示行数) | rows / cols |
| 换行 | 选项文字不换行 | 用户可输入换行 |
<button>的默认type是submit表单里放一个"删除"按钮却忘了写
type="button",点它会提交整个表单。这是表单里最常见的 bug,养成"每个button都写type"的习惯。另外:不要用<div onclick>当按钮——它不可聚焦、不响应键盘、屏幕阅读器不播报。
十二、iframe
<iframe
src="https://example.com/embed"
title="嵌入的示例页面"
width="600" height="400"
loading="lazy"
sandbox="allow-scripts allow-same-origin"
referrerpolicy="no-referrer">
</iframe>
title是必需的:屏幕阅读器用它描述这个框架是什么,没写会播报"框架"。sandbox是安全边界:默认禁止脚本、表单、弹窗等,按需逐项放开。放开allow-scripts+allow-same-origin的组合相当于几乎取消沙箱,嵌入不可信内容时不要这么写。- 每个
iframe都是独立的浏览上下文,会独立加载资源、独立执行 JS,因此贵:能不用就不用,视频、地图、第三方支付这类无法自建的内容才用。
十三、可访问性(a11y)基础
为什么重要:全球有相当比例的人存在视、听、运动或认知障碍;许多国家(含中国《信息无障碍 身体机能差异人群 网站设计无障碍技术要求》相关标准)对公共服务网站有合规要求;而且 a11y 做好的页面,对所有人(键盘党、临时受伤、光线下看不清屏幕)都更好用,并直接提升 SEO。
| 要点 | 具体做法 |
|---|---|
| 文本替代 | 有信息的图写描述性 alt;装饰图写 alt="";表单控件有 label;iframe 有 title |
| 语义标签 | 用 <button> 而非 <div onclick>;用 <nav>/<main> 提供地标跳转;标题层级不跳级 |
| 键盘可达 | 所有交互元素可用 Tab 到达、Enter/Space 触发;可见的焦点样式不要写 outline: none 而不给替代;避免 tabindex 正数 |
| ARIA 最小用法 | 只在原生元素表达不了时才用:aria-label(无可见文字时给名字)、aria-labelledby(引用已有文字作名字)、aria-describedby(补充说明)、aria-expanded(展开状态)、aria-hidden="true"(对辅助技术隐藏装饰内容) |
| 颜色对比度 | 正文与背景对比度至少 ,大号文字至少 (见下文公式);不要只靠颜色传达信息(错误提示除了变红还要有文字) |
| 动画 | 为尊重"减少动态效果"偏好,可用 @media (prefers-reduced-motion: reduce) 关闭动画 |
颜色对比度是可以算出来的,不是凭感觉调。WCAG 定义对比度为两个颜色的相对亮度之比:
其中 是相对亮度(relative luminance),取两个颜色中较亮者的作为 。因此对比度的取值范围是 (同色)到 (纯黑与纯白)。AA 级要求:正文 ,大号文字( 常规,或 加粗)。AAA 级要求正文 。
举个例子:正文 #767676 在白色背景上的对比度约为 ,刚好过 AA 线;换成 #777777 就降到约 ,差一点点就不合格。所以这类数值不要手算,直接用浏览器 DevTools 取色器里显示的对比度数值(或 W3C 的 WCAG 速查页)核对。
ARIA 的第一条规则
能用原生 HTML 元素解决,就不要用 ARIA。
<button>自带角色、键盘行为与焦点管理;<div role="button" tabindex="0">需要你手动补齐所有行为,少一样就坏一样。ARIA 是补丁,不是地基。
十四、HTML 校验
W3C 提供免费的标记校验服务,能在提交前抓出嵌套错误、重复 id、非法属性等功能性问题:
- 打开 <https://validator.w3.org/>。
- 选 Validate by Direct Input,把 HTML 源码粘进去(或选 Validate by URI 填线上地址、Validate by File Upload 传文件)。
- 看结果中的
Error(必须修)与Warning(酌情处理)。
也可以装编辑器插件(如 VS Code 的 HTMLHint)在写的时候实时提示。校验通过不代表语义好、无障碍达标,它只保证"语法与内容模型合法"——但这是最低门槛。
怎么用:可粘贴运行的最小完整示例
把下面内容保存为 profile.html,双击用浏览器打开即可。它包含骨架、语义化结构、表格、表单与原生校验,可直接丢进 W3C 校验器检查。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>张三的简历</title>
<style>
body { font-family: system-ui, -apple-system, "Segoe UI", "Microsoft YaHei", sans-serif; line-height: 1.7; max-width: 46rem; margin: 0 auto; padding: 1rem; color: #222; }
nav ul { display: flex; gap: 1rem; list-style: none; padding: 0; }
table { border-collapse: collapse; width: 100%; }
th, td { border: 1px solid #ccc; padding: .5rem .75rem; text-align: left; }
fieldset { border: 1px solid #ccc; border-radius: 8px; margin-block: 1rem; }
label { display: block; margin-block: .5rem .25rem; font-weight: 600; }
input, select, textarea { width: 100%; padding: .5rem; box-sizing: border-box; }
button { margin-top: 1rem; padding: .6rem 1.2rem; cursor: pointer; }
:focus-visible { outline: 3px solid #0b5fff; outline-offset: 2px; }
footer { margin-top: 2rem; border-top: 1px solid #ddd; padding-top: 1rem; font-size: .9rem; }
</style>
</head>
<body>
<header>
<h1>张三</h1>
<p>前端开发 · 上海 · <a href="mailto:me@example.com">me@example.com</a></p>
<nav aria-label="页面导航">
<ul>
<li><a href="#skills">技能</a></li>
<li><a href="#projects">项目</a></li>
<li><a href="#contact">联系方式</a></li>
</ul>
</nav>
</header>
<main>
<section id="skills">
<h2>技能</h2>
<ul>
<li>HTML 语义化与可访问性</li>
<li>CSS 盒模型与 Flex / Grid 布局</li>
<li>原生表单校验与基础 JS 交互</li>
</ul>
</section>
<section id="projects">
<h2>项目经历</h2>
<table>
<caption>个人项目一览</caption>
<thead>
<tr>
<th scope="col">项目</th>
<th scope="col">角色</th>
<th scope="col">年份</th>
</tr>
</thead>
<tbody>
<tr><th scope="row">笔记库</th><td>独立开发</td><td>2026</td></tr>
<tr><th scope="row">表单组件库</th><td>可访问性改造</td><td>2025</td></tr>
</tbody>
</table>
<figure>
<img src="https://placehold.co/640x360?text=demo" alt="项目首页截图:顶部导航,中间三列卡片,底部版权信息" width="640" height="360">
<figcaption>图 1:项目首页布局</figcaption>
</figure>
</section>
<section id="contact">
<h2>联系我</h2>
<!-- novalidate 去掉后即为原生校验版本;这里保留原生校验,故不写 novalidate -->
<form action="/api/contact" method="post">
<fieldset>
<legend>留言</legend>
<label for="name">姓名(必填)</label>
<input type="text" id="name" name="name" required maxlength="20" autocomplete="name">
<label for="email">邮箱(必填)</label>
<input type="email" id="email" name="email" required autocomplete="email">
<label for="topic">主题</label>
<select id="topic" name="topic">
<option value="">请选择</option>
<option value="job">工作机会</option>
<option value="talk">技术交流</option>
</select>
<label for="message">内容</label>
<textarea id="message" name="message" rows="4" maxlength="500" required></textarea>
<button type="submit">提交</button>
<button type="reset">重置</button>
</fieldset>
</form>
</section>
</main>
<aside>
<h2>补充</h2>
<p>本页可通过键盘 Tab 键完整操作,焦点有可见描边。</p>
</aside>
<footer>
<p><small>© 2026 张三。最后更新:<time datetime="2026-10-11">2026 年 10 月 11 日</time></small></p>
</footer>
</body>
</html>
自检清单(保存后逐条确认):
- 按 <kbd>Tab</kbd> 从页面开头走到底,每个链接、输入框、按钮都能聚焦,且焦点框清晰可见。
- 点击"姓名"两个字,光标应自动跳进输入框(验证
label for生效)。 - 直接点"提交",浏览器应弹出"请填写此字段"(验证
required生效)。 - 用 W3C 校验器检查,不应有
Error。 - 把窗口拉窄到手机宽度,页面不应出现横向滚动条(验证 viewport 生效)。
常见坑
高频错误清单
1. 不写
<!DOCTYPE html>:进入怪异模式,box-sizing、行高、百分比高度全按老规则算,排查半天找不到原因。2.
<meta charset>写在<head>靠后位置:声明必须出现在文档前 1024 字节内,否则无效,中文仍会乱码。放<head>第一行最稳。3. 忘了 viewport meta:手机上整个页面被缩放到 980px 宽,用户得双指放大才能读。
4.
id重复:不会报错,但<label for>、#锚点、getElementById都可能命中错误的元素。CSS 校验器会警告。5. 表单控件没写
name:数据根本不会被提交,后端收到空对象。这是前后端联调最常见的"玄学"问题。6.
<button>没写type:默认submit,表单里的任何按钮都会提交表单。7.
hidden="false"以为能显示:布尔属性只看存在与否,hidden="false"依然隐藏。8. 用
placeholder代替label:一输入就消失,用户忘记字段含义;屏幕阅读器支持也不一致。9. 只写
alt不写真内容:alt="图片"、alt="image"等于没写,要写这张图传达了什么信息。10. 图片不写
width/height:加载完成后页面跳动(CLS),既影响体验也影响性能评分。11. 用
<br>或<br><br>造段落间距:应改 CSSmargin;<br>只用于内容本身需要断行处。12. 用
<table>做页面布局:破坏响应式与无障碍,现代一律用 CSS Grid / Flex。13.
target="_blank"忘记rel="noopener":新页面可通过window.opener操作原页面。14.
<div onclick>当按钮:不可聚焦、不响应键盘、不播报角色。用<button type="button">。15. 标题级别为了字号跳级:
h1→h4会让依赖标题导航的用户迷路。改字号请用 CSS。
练习题
第 1 题(照着做,实操) 手写一个语义化的个人简历页面 resume.html,要求:
- 只用原生 HTML + 一个
<style>块,单文件可运行,不许用任何框架或在线模板。 - 结构必须包含:
<header>(姓名 + 一句话简介 +<nav>锚点菜单)、<main>、至少 2 个<section>、一个<aside>、<footer>。 - 至少包含:一个三层有序列表(教育/工作经历)、一个描述列表(技能—熟练度)、一个带
<caption>与scope的数据表格、一张带真实alt的图片。 - 通过 W3C 校验器,
Error数为 0。
第 2 题 下面这段代码有几个问题?逐一指出并写出修正后的版本。
<div class="header">
<div class="title" style="font-size:24px">我的博客</div>
</div>
<div class="content">
<p>第一段<br><br>第二段
</div>
<button>搜索</button>
第 3 题 解释下面三组标签的区别,并各写一个"必须用前者、不能用后者"的真实场景:
<strong>与<b><em>与<i>alt="用户头像"与alt=""
第 4 题 写一个注册表单片段,包含用户名、邮箱、密码、确认密码、生日、头像上传、同意条款复选框,以及提交/重置按钮。要求:
- 每个控件都有正确关联的
<label>。 - 使用至少 4 种原生校验属性。
- 密码字段有可见的规则说明文字,并与控件建立无障碍关联。
- 所有按钮显式声明
type。 - 说明每个字段的
name取值理由(提示:后端字段命名习惯)。
第 5 题 打开任意一个你常用的网站,用浏览器开发者工具(F12 → Elements)检查它的页面结构,回答:
- 它用了哪些语义化标签?有没有
<main>?数量是否超过一个(不合规)? - 找出 3 个用
<div>本可以换成语义标签的地方,写出替换方案。 - 它有没有跳过标题层级?截图或记录路径。
- 它有没有表单控件缺少
label?举一例并给出修法。
FAQ
Q1:<div> 和 <section> 到底怎么选?我感觉换一下也没区别。
视觉上确实零区别,因为两者 display 都是 block。区别在语义与 a11y:<section> 会成为一个地标区域,应当有标题(<h2>–<h6>),屏幕阅读器用户可以跳进去;<div> 什么也不表示。自测方法:如果这一块能自然地起一个小标题,用 <section>;如果只是"为了给几个元素套一层好写样式",用 <div>。纯样式容器用 <div> 不是错误,是正确用法。
Q2:语义化真的值得花时间吗?我只关心页面能不能显示。
能不显示的地方它都不影响,所以短期看不出收益。但成本几乎为零(写 <nav> 和写 <div class="nav"> 敲键盘次数差不多),收益却持续存在:SEO 排名、屏幕阅读器可用性、浏览器阅读模式、自动化测试定位、半年后你自己能不能看懂。真正贵的是返工:当设计稿改版、要求出无障碍报告、或被搜索引擎降权时,回头补语义要重写模板结构。
Q3:required 能替代后端校验吗?
绝对不能。原生校验只是用户体验优化:用户可以按 F12 删掉 required 属性,也可以直接绕过页面用 curl 发请求。同时它也不可靠——老浏览器、部分辅助技术下行为不一致。正确做法是:前端原生校验(即时反馈)+ 前端 JS 校验(复杂规则)+ 后端强制校验(唯一的信任边界)。三者中只有后端是安全保证。
Q4:pattern 里要不要写 ^ 和 $?
不用。HTML 标准规定 pattern 是隐式整串匹配,等价于自动加上了 ^ 和 $`(严格说是 `^(?:` 与 `)$)。写了也不会错,但容易让人误以为可以写"部分匹配"。另一个高频坑:pattern 里的正则不要用 u 标志下才支持的转义或 / 分隔符,直接写裸正则;反斜杠在 HTML 属性里无需转义,但在 JS 字符串里要写成 \\。
Q5:为什么我的 <input type="date"> 在 value 里填了"2026年10月11日"却显示为空?
因为 type="date" 的 value 必须是规范的 YYYY-MM-DD 格式,不符合的值会被当作无效值丢弃(控件显示空白)。同理 time 是 HH:MM、datetime-local 是 YYYY-MM-DDTHH:MM、month 是 YYYY-MM。要显示中文格式,交给 <label>、<time> 元素的可见文本或 JS 格式化,而不是塞进 value。
相关笔记
- 前端-02-CSS基础 —— 给本篇的结构"上色":选择器怎么命中这些标签、盒模型怎么算尺寸。
- 前端-03-CSS布局-Flex与Grid —— 语义化结构写好后,用 Flexbox / Grid 把
<header>/<main>/<aside>排成真正的页面布局。 - 前端-04-浏览器与HTTP —— 表单提交后发生了什么:请求方法、状态码、编码格式与浏览器渲染流程。
- JavaScript-05-DOM与事件 —— 用脚本读写本篇搭出的 DOM 树,处理表单事件与用户交互。
参考来源
- MDN 中文:使用 HTML 构建 Web(结构、语义、表单与调试的系统教程)—— <https://developer.mozilla.org/zh-CN/docs/Learn_web_development/Core/Structuring_content>
- MDN 中文:HTML 元素参考(
<input>全部type、<table>、<label>、<iframe>等权威说明)—— <https://developer.mozilla.org/zh-CN/docs/Web/HTML/Reference/Elements> - MDN 中文:
<input>元素(22 种type与全部校验属性的对照)—— <https://developer.mozilla.org/zh-CN/docs/Web/HTML/Reference/Elements/input> - MDN 中文:HTML 全局属性参考(
id/class/style/data-*/title/hidden/tabindex)—— <https://developer.mozilla.org/zh-CN/docs/Web/HTML/Reference/Global_attributes> - MDN 中文:响应式图片(
srcset、sizes、picture的完整规则)—— <https://developer.mozilla.org/zh-CN/docs/Web/HTML/Guides/Responsive_images> - WHATWG HTML 标准:语义、结构与元素(文档骨架、内容模型的最终依据)—— <https://html.spec.whatwg.org/multipage/semantics.html>
- WHATWG HTML 标准:表单元素(
input类型、约束校验 API 的规范定义)—— <https://html.spec.whatwg.org/multipage/form-elements.html> - W3C Markup Validation Service(官方 HTML 校验服务)—— <https://validator.w3.org/>
- W3C:WCAG 2.2 快速参考(对比度、键盘可达等成功标准的速查表)—— <https://www.w3.org/WAI/WCAG22/quickref/>