跳到正文
零到全栈 · 卷 2 · 浏览器三件套

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 拼出了一个"文章列表",浏览器里看是漂亮的。我让他做三件事:

  1. 按 Ctrl 加 + 把页面放大到 200%;
  2. 只用键盘 Tab 键在页面上走一圈;
  3. 在控制台执行 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。这一根线连上之后,会同时得到三件事:

  1. 点"标题"两个字,光标自动跳进输入框(触屏上这个体验差别巨大);
  2. 屏幕阅读器念到输入框时,会先说"标题,文本输入框";
  3. 自动化测试可以用 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% 宽的盒子会换行,以及怎样把它们排成"左边标签、右边列表"。

→ 卷2-02-CSS盒子流与布局.md