w wyl123ly 的博客
MD

前端-01-HTML基础

41 KB 2026.10.11 原文件

前端-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?因为它承担着三个别人替代不了的职责:

  1. 它是唯一的"意义层"。搜索引擎、屏幕阅读器、浏览器阅读模式、自动化测试工具都只能通过标签判断"这块内容是正文还是广告、是导航还是页脚"。你用 <div> 堆出来的页面在视觉上和 <article> 一模一样,但对机器来说是一堆无名方块。
  2. 它是可访问性的落点。视障用户用屏幕阅读器(如 NVDA、VoiceOver)逐标签朗读页面。<h1> 是可以跳转的层级,<div class="title"> 什么都不是。
  3. 它有原生能力。表单校验(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 缺失 vs alt=""

缺少 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 里唯一能与服务器双向交互的部分,也是最容易写错语义的地方。它有三条铁律:

  1. 每个控件都必须有 <label>(或 aria-label)。
  2. 要提交的数据靠 name 标识,靠 value 承载。没有 name 的控件不会被提交。
  3. 优先用原生校验属性,不要一上来就写 JS 校验。
form 与 input 的完整 type 清单
<form action="/api/resume" method="post" enctype="multipart/form-data" novalidate>
  ...
</form>
form 属性作用
action提交地址
methodget(参数拼在 URL,可收藏、有长度限制)或 post(放请求体,用于写操作与文件)
enctypepost 时的编码;上传文件必须为 multipart/form-data
novalidate关闭浏览器原生校验(通常用于改为自己校验时)
target提交结果在哪个浏览上下文打开,如 _blank
autocompleteon / 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 / maxnumber、range、日期时间类数值 / 日期范围
stepnumber、range、日期时间类步长;step="any" 表示不限
pattern文本类正则(隐式整串匹配,无需 ^...$)
type—email/url/number 自带格式校验
multipleemail、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、非法属性等功能性问题:

  1. 打开 <https://validator.w3.org/>。
  2. 选 Validate by Direct Input,把 HTML 源码粘进去(或选 Validate by URI 填线上地址、Validate by File Upload 传文件)。
  3. 看结果中的 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>

自检清单(保存后逐条确认):

  1. 按 <kbd>Tab</kbd> 从页面开头走到底,每个链接、输入框、按钮都能聚焦,且焦点框清晰可见。
  2. 点击"姓名"两个字,光标应自动跳进输入框(验证 label for 生效)。
  3. 直接点"提交",浏览器应弹出"请填写此字段"(验证 required 生效)。
  4. 用 W3C 校验器检查,不应有 Error。
  5. 把窗口拉窄到手机宽度,页面不应出现横向滚动条(验证 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> 造段落间距:应改 CSS margin;<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 题 解释下面三组标签的区别,并各写一个"必须用前者、不能用后者"的真实场景:

  1. <strong> 与 <b>
  2. <em> 与 <i>
  3. alt="用户头像" 与 alt=""

第 4 题 写一个注册表单片段,包含用户名、邮箱、密码、确认密码、生日、头像上传、同意条款复选框,以及提交/重置按钮。要求:

  • 每个控件都有正确关联的 <label>。
  • 使用至少 4 种原生校验属性。
  • 密码字段有可见的规则说明文字,并与控件建立无障碍关联。
  • 所有按钮显式声明 type。
  • 说明每个字段的 name 取值理由(提示:后端字段命名习惯)。

第 5 题 打开任意一个你常用的网站,用浏览器开发者工具(F12 → Elements)检查它的页面结构,回答:

  1. 它用了哪些语义化标签?有没有 <main>?数量是否超过一个(不合规)?
  2. 找出 3 个用 <div> 本可以换成语义标签的地方,写出替换方案。
  3. 它有没有跳过标题层级?截图或记录路径。
  4. 它有没有表单控件缺少 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/>