HTML:结构就是语义
本合集目录
本章目录
单册说明:本文件是卷 2 的第 1 章,可独立阅读。前置:卷 1 第 6 章(让世界看到你的文件)。本章讲清"标签是给机器读的说明书",并写出「读到」的摘录页骨架。
| 项 | 内容 |
|---|---|
| 所属卷 | 卷 2 · 浏览器三件套(第 1 / 7 章) |
| 前置章节 | 1.6 让世界看到你的文件 |
| 本章产出 | index.html:一个能读通、能被键盘操作、能被屏幕阅读器念明白的摘录页骨架 |
| 对应代码 | code/dudao/index.html(本章版本,样式与脚本留给第 2–6 章) |
| 配图 | 无(后续统一制图) |
| 读完的判定 | 关掉 CSS、只用键盘 Tab,你能把表单填完并说清页面上每一块的"身份" |
2.1.1 一句话结论:标签回答"这是什么",不回答"长什么样"
新手写 HTML 最常见的动作,是打开一个网页、看到标题很大,于是写下 <h1> 然后给它 font-size: 40px;看到一个区块,就写 <div> 然后给它加粗加边框。
这样写出来的页面在你自己电脑上看着没问题,但它有个致命缺陷:除了像素,什么都没告诉别人。
下面是我带过的一个真实场面。学员用清一色的 div 加 span 拼出了一个"文章列表",浏览器里看是漂亮的。我让他做三件事:
- 按
Ctrl加+把页面放大到 200%; - 只用键盘
Tab键在页面上走一圈; - 在控制台执行
document.querySelectorAll('h1, h2, h3').length。
三件事的结果分别是:布局开始重叠、Tab 完全跳过所有"按钮"、返回 0。页面只有视觉,没有结构。
这不是审美问题。浏览器的"阅读模式"靠 <article> 判断主体内容,屏幕阅读器靠标题层级给盲人用户跳读,搜索引擎靠 <h1>–<h6> 判断主次,你的自动化脚本靠 <label> 知道哪个输入框叫什么。这些工具全都不看颜色,只看标签。
所以本章的第一条纪律:
先在 HTML 里把"这是什么"写对,再去 CSS 里决定"长什么样"。顺序反了,后面每一章都会替你付账。
2.1.2 原理与方法
① 页面的最小骨架
任何一个 HTML 文件都长这个样子,五个部分缺一不可:
<!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> |
告诉浏览器"按标准模式解析" | 进入"怪异模式",盒模型计算和旧浏览器一致,宽度全对不上 |
<html lang="zh-CN"> |
声明文档语言 | 浏览器可能用英文语音朗读中文;翻译插件会误判 |
<meta charset="UTF-8"> |
声明字符编码 | 中文变问号或方块,且必须在 <head> 最前面才稳 |
<meta name="viewport" ...> |
告诉手机"按设备宽度渲染" | 手机上整页被缩小成一张邮票,媒体查询也全不生效 |
<title> |
标签页上的名字 | 收藏夹里一堆"无标题文档" |
viewport 这一行在第 3 章讲响应式时还会再提一次,因为它是"手机上看着不挤"的前提。没有它,你写的任何断点都是白写。
② 标题层级:h1–h6 是目录,不是字号
h1 到 h6 表达的是嵌套层级,不是六个字号档位。规则只有三条:
- 一个页面通常只有一个
h1,就是这一页的主题; - 层级不能跳:有
h2才能有h3,不能从h1直接到h4; - 想要更大的字,用 CSS 改
font-size,不要用h1去顶。
为什么较真这个?因为屏幕阅读器用户可以按标题键在页面里跳读——这是盲人浏览网页最快的方式。层级一乱,跳读就等于失效:他从"一级标题"跳到"四级标题",中间那两层的内容被整段跳过。
③ 内容标签:把"一段话"写成"一段话"
| 标签 | 语义 | 正确用法 | 常见误用 |
|---|---|---|---|
p |
段落 | 一整段文字 | 用 <br> 堆出段间距 |
h1–h6 |
标题层级 | 章节标题 | 把正文调大 |
ul / ol / li |
无序 / 有序列表 | 并列的条目 | 拿来做布局 |
a |
指向另一个资源 | 跳转、下载 | 用 href="#" 假装按钮 |
button |
触发一个动作 | 提交、切换、删除 | 用 div 加 onclick |
img |
一张有内容的图 | 配图、截图 | 装饰性花纹(那该用 CSS 背景) |
strong / em |
重要 / 强调语气 | 真的重要、真的强调 | 只为加粗斜体 |
a 和 button 的分工是新手最常混的一处,判据只有一句:点了会去别的地方,用 a;点了在原地发生一件事,用 button。 这条不是洁癖——a 支持"在新标签页打开""复制链接地址",button 支持空格键触发;用 div 两者都拿不到。
④ 图片:alt 不是可选项
<img src="cover.png" alt="读到首页截图:左侧标签栏,右侧三条摘录">
alt 有三个真实用途:图片加载失败时显示的文字、屏幕阅读器朗读的内容、搜索引擎理解图片的依据。
写 alt 的判据是"如果这张图不存在,你会怎么跟人描述它":
| 图片类型 | alt 怎么写 |
|---|---|
| 内容图(截图、图表、照片) | 描述它传达的信息,一两句,别写"图片" |
| 纯装饰(分隔线、花纹) | alt=""(空字符串),让屏幕阅读器直接跳过 |
| 图标按钮(放大镜) | 写动作,如 alt="搜索" |
alt 缺失和 alt="图片" 是两种不同的错:前者让屏幕阅读器念出整个文件名,后者等于什么都没说。
⑤ 表单:label 的 for 是那根线
<div class="field">
<label for="field-title">标题</label>
<input id="field-title" name="title" type="text" required maxlength="80">
</div>
label 的 for 必须等于目标控件的 id。这一根线连上之后,会同时得到三件事:
- 点"标题"两个字,光标自动跳进输入框(触屏上这个体验差别巨大);
- 屏幕阅读器念到输入框时,会先说"标题,文本输入框";
- 自动化测试可以用
getByLabel('标题')精确找到它。
name 是另一件事:它决定这个值提交给谁。没有 name 的输入框,表单提交时它的值会被直接丢掉——这是"我明明填了,后端说没收到"的第一大原因。
required、maxlength、type="url"、type="email" 这些属性,是浏览器免费给你的校验。它们不能替代后端校验(用户能改前端代码),但能在提交前挡掉八成手误。第 6 章读数据、第 5 章做表单时都会用到。
⑥ 语义容器:div 是最后的选择,不是第一个
div 和 span 是"没有任何语义的盒子",只在"实在找不到更合适的标签"时用。现代浏览器认得的语义容器有这些:
| 标签 | 表达什么 | 什么时候用 | 判据 |
|---|---|---|---|
header |
页头 / 区块头部 | 站点标题、导航 | 出现在页面或 article 顶部 |
main |
本页唯一的主体 | 一页只能有一个 | 去掉头尾之后剩下的核心 |
nav |
导航链接组 | 站内跳转集合 | 里面主要是一堆 a |
article |
能独立拿出去的内容 | 一篇摘录、一篇文章 | 单独发到别处也讲得通 |
section |
一个有主题的分组 | 需要一个小标题的区块 | 有 h2/h3 才叫 section |
aside |
与主体相关但可跳过 | 侧边栏、标签云 | 去掉它主体依然完整 |
footer |
页脚 / 区块尾部 | 版权、更新时间 | 出现在页面或 article 底部 |
判断 section 还是 div,只看一件事:这块内容有没有自己的标题。 有标题就是 section,没有就老实写 div。至于 article,判据是"能不能独立分发"——一条摘录当然能,一个"关于本站"的区块就不算。
⑦ 可访问性:四条最低要求
这一节不是"加分项",是及格线。四条都能用手边的工具验证:
| # | 要求 | 怎么自查 | 违反了会怎样 |
|---|---|---|---|
| 1 | 每个表单控件都有 label 关联 |
点标签文字,看光标是否跳进输入框 | 触屏用户点不中,读屏用户不知道填什么 |
| 2 | 每张 img 都有 alt |
在控制台查 document.querySelectorAll('img:not([alt])').length |
图挂了只剩空白,读屏念文件名 |
| 3 | 所有交互都能用键盘完成 | 只用 Tab + Enter 走一遍 |
不用鼠标的人完全用不了 |
| 4 | 正文对比度不低于 4.5:1 | 浏览器开发者工具的对比度提示 | 强光下、视力弱的人看不清 |
第 3 条是 div 冒充按钮最直接的代价:div 不在 Tab 序列里,也不会响应回车。你省下的那点标签选择时间,会让一部分人彻底用不了你的页面。
2.1.3 动手:写出「读到」的语义骨架
新建目录 C:\code\dudao(macOS/Linux 用 ~/code/dudao),在里面建 index.html,把下面整段粘进去。这一段是本章的成品,后面六章都在这上面加东西,不要改已有的 id 和 class。
<!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>
<header class="site-header">
<h1 class="site-title">读到</h1>
<p class="site-sub">把读到的句子留下来,按标签找回去。</p>
</header>
<main class="layout">
<aside class="sidebar" aria-labelledby="tag-title">
<h2 class="sidebar-title" id="tag-title">标签</h2>
<ul class="tag-list" id="tag-list">
<li><button class="tag-btn is-active" type="button" data-tag="">全部</button></li>
<li><button class="tag-btn" type="button" data-tag="认知">认知</button></li>
<li><button class="tag-btn" type="button" data-tag="写作">写作</button></li>
</ul>
</aside>
<section class="content" aria-labelledby="note-title">
<h2 class="section-title" id="note-title">摘录</h2>
<ul class="note-list" id="note-list">
<li class="note-card">
<h3 class="note-card-title">注意力是稀缺资源</h3>
<p class="note-card-body">把注意力当成预算来花,而不是当成免费的空气。</p>
<p class="note-card-meta">
<a class="note-link" href="https://reading.example/2026/11/attention" target="_blank" rel="noopener noreferrer">原文</a>
<span class="note-date">2026-11-17</span>
<span class="tag-chip">认知</span>
<span class="tag-chip">写作</span>
</p>
</li>
<li class="note-card">
<h3 class="note-card-title">先写,再改</h3>
<p class="note-card-body">初稿的唯一任务是存在,不是正确。</p>
<p class="note-card-meta">
<a class="note-link" href="https://reading.example/2026/11/draft" target="_blank" rel="noopener noreferrer">原文</a>
<span class="note-date">2026-11-16</span>
<span class="tag-chip">写作</span>
</p>
</li>
</ul>
<p class="empty" id="empty-hint" hidden>还没有摘录。用下面的表单加一条。</p>
</section>
</main>
<section class="stats" aria-labelledby="stats-title">
<h2 class="section-title" id="stats-title">关键词</h2>
<ul class="stats-list" id="stats-list"></ul>
</section>
<section class="composer" aria-labelledby="form-title">
<h2 class="section-title" id="form-title">新增摘录</h2>
<form class="note-form" id="note-form">
<div class="field">
<label for="field-title">标题</label>
<input id="field-title" name="title" type="text" required maxlength="80" placeholder="一句话概括这条摘录">
</div>
<div class="field">
<label for="field-content">正文</label>
<textarea id="field-content" name="content" rows="4" required placeholder="把原文抄进来,或者写一句自己的话"></textarea>
</div>
<div class="field">
<label for="field-source">来源网址</label>
<input id="field-source" name="sourceUrl" type="url" placeholder="https://reading.example/...">
</div>
<div class="field">
<label for="field-tags">标签</label>
<input id="field-tags" name="tags" type="text" placeholder="用空格分隔,例如:认知 写作">
</div>
<button class="primary" type="submit">保存</button>
</form>
</section>
<footer class="site-footer">
<p>读到 · 本地版</p>
</footer>
</body>
</html>
写完之后,按下面的顺序验收这具骨架。这一步不做,第 2 章你会对着一个自己都不认识的页面调样式。
第一步:关掉样式看结构。 现在还没有 CSS,浏览器给的默认样式就是"裸结构"。此时你的页面应该是:一个大标题、一行小字、两个小标题、一堆带圆点的条目、四个输入框、一个按钮。如果某个部分看起来"不知道是什么",说明它的标签选错了。
第二步:只用键盘走一圈。 按 Tab 依次跳:三个标签按钮 → 两个"原文"链接 → 四个输入框 → 保存按钮。每个焦点都要有可见的框(浏览器默认有)。如果哪个点不到,回去看它是不是 div。
第三步:点标签文字。 点"标题"这两个字,光标应该跳进输入框。点不到,说明 for 和 id 没对上。
第四步:查两个数。 在控制台里执行:
document.querySelectorAll('h1').length // 必须是 1
document.querySelectorAll('img:not([alt])').length // 目前没有 img,返回 0
第五步:验证 hidden。 那条"还没有摘录"的提示带有 hidden 属性,所以现在不该显示。它是第 5 章要用的:列表空了才让它出现。hidden 是 HTML 自带的隐藏方式,比 display: none 更"语义化"——它表达的是"这块内容此刻不适用",而不是"这块内容不该被排版"。
2.1.4 三个坑
坑 1:把标题当字号用,h1 之后直接 h4
症状:视觉上层次分明,但浏览器阅读模式提取的目录是断的;用标题键跳读时,从一级直接掉到四级。
成因:写的时候想的是"这个字要小一点",于是照着字号挑标签。字号是随设计稿变的,语义层级不随设计变。
修法:先把层级写对(h1 → h2 → h3),再用 CSS 调 font-size。改字号永远只动样式表。判断依据:**你把这一页的 CSS 全删掉,标题的嵌套关系还讲得通吗?**讲得通就是对的。
坑 2:用 div 加 onclick 冒充按钮
症状:鼠标点着好好的,一换键盘就完全用不了;手机上长按也不会出现"在新标签打开"。
成因:div 天生不是交互元素,它不在 Tab 序列里,不响应回车和空格,也没有 disabled 状态和默认的焦点样式。
修法:要动作就写 <button type="button">,要跳转就写 <a href="...">,然后用 CSS 把按钮的默认边框背景去掉,让它长得像你想要的样子。样式可以随便改,标签不能随便换。
坑 3:label 的 for 和 id 对不上,或者忘了写
症状:点标签文字没反应;读屏软件念输入框时只说"文本输入框",不说这个框要填什么。
成因:for 拼错一个字母、id 重复、或者干脆用 <span> 当标签。for 是大小写敏感的精确匹配,field-title 和 field-Title 是两个东西。
修法:一个输入框配一个 id,for 原样抄过去。id 全页唯一,别在循环里生成重复的 id——第 5 章动态渲染列表时会专门避开这个雷(列表项不写 id,用 class)。
本章验收
-
index.html能在浏览器打开,控制台无报错 -
document.querySelectorAll('h1').length返回1,且标题层级无跳级 - 只用键盘能从页头走到"保存"按钮,每个焦点都看得见
- 点每个
label的文字,光标都能跳进对应输入框 - 能说出
a和button的分工,以及为什么不能用div顶替 - 页面里没有"为了布局而写的
div套div套div"
自测
Q1:设计师给你一张图,主标题 32px、区块标题 20px、卡片标题 16px。你应该写几个 h1、几个 h2、几个 h3?
看答案
数量由**内容层级**决定,不由字号决定。如果这一页的主题只有一个,就是 1 个 `h1`;区块有几个就几个 `h2`;卡片是区块下的条目,用 `h3`。字号全部交给 CSS:`.site-title { font-size: 2rem }`、`.section-title { font-size: 1.25rem }`、`.note-card-title { font-size: 1rem }`。反过来做(按字号挑标签)会让页面在换设计稿时结构跟着崩。Q2:为什么 section 里一定要有标题,而 div 不需要?
看答案
因为 `section` 的语义是"一个有主题的分组",主题要靠标题表达。没有标题的 `section` 在屏幕阅读器的文档大纲里是一个无名节点,用户跳进去不知道自己在哪,等于给导航添乱。没有标题的分组就是纯排版需要,那正是 `div` 的用途。Q3:<input name="title" id="t1"> 和 <label for="title">标题</label> 这组代码有两个问题,分别是什么?
看答案
① `for="title"` 找的是 `id="title"`,而输入框的 `id` 是 `t1`,那根线没连上——点标签不会聚焦,读屏也不会念出名字。② `name="title"` 与 `id` 不一致本身不算错(两者职责不同:`name` 管提交,`id` 管关联),但混用很容易在后续维护时改错一个忘改另一个。稳妥写法是让 `for` 与 `id` 完全一致(如都叫 `field-title`),`name` 单独按接口字段命名。下一步
结构立住了,但它现在是一堆黑字白底。下一章讲盒子:为什么两个 50% 宽的盒子会换行,以及怎样把它们排成"左边标签、右边列表"。