几年前做过一个活动页,结构全用 div 加类名搭起来,视觉上没问题,上线也顺利。直到做无障碍验收,同事用读屏软件演示:按一下快捷键想跳到正文,读屏软件找不到「主要内容」这个区域,只能从头开始念,先念站点名、再念六个导航项、再念侧边推荐,念了快半分钟才轮到正文。会议室里没人说话,但那次之后,那个项目的页面结构全改了一遍。

这篇讲什么:HTML5 提供了一组描述「这个区域是干什么的」标签,比如 header、nav、main。这篇不让你背定义,而是讲每一块内容到底该选哪个标签、选错的常见后果、以及语义化能带来什么、代价是什么。读完你能做到:拿到一张页面设计稿,十分钟内把分区结构定下来,并且知道哪些地方用 div 反而更合适。

先分清一件事:语义标签不是「更高级的 div」

把 div 换成 section,视觉上不会有任何变化,因为浏览器给它们的默认样式几乎一样。变化发生在「别人怎么理解这块内容」:读屏软件能把它识别成地标区域,搜索引擎能判断哪部分是正文,接手代码的人能一眼看出结构。所以语义标签的价值不在页面本身,而在页面之外的消费者。

这也意味着,如果你只是把 div class="header" 改名成 header,但里面装的还是导航和搜索框,那语义就错了,甚至比全用 div 更糟:读屏软件会信任这个标签,把错误的信息报给用户。语义化的前提是「标签名和内容对得上」。标签是承诺,不是装饰。

还有一个容易被忽略的点:浏览器默认样式几乎一样,不代表完全没有差别。部分语义标签自带默认外边距,换了标签之后页面间距会变;main、section 这些标签在很老的浏览器里需要额外的兼容处理,具体版本这里待确认。现代浏览器基本不用管,但如果你要维护十年前的页面,得先测。

七个分区标签怎么选

日常页面九成以上的分区需求,用下面七个标签就能覆盖。判断顺序建议从「这块内容在页面里承担什么角色」入手,而不是从「它长什么样」入手。

header 与 footer:一组内容的开头和结尾

header 是「引言区」,通常放标题、副标题、作者信息、搜索框。footer 是「收尾区」,通常放版权、联系方式、相关链接。关键点是:它们不限于整个页面,也可以属于某一个 article 或 section。一篇文章的头部(标题、作者、发布时间)用 header,整站的头部(Logo、主导航)也用 header,两者可以同时存在。

常见错误是把整个侧边栏都塞进 header,或者把页面顶部那条含导航的横条写成 div class="top"。前者语义错位,后者只是少了信息,不算错,但读屏用户会少一个「横幅区域」的快捷入口。

nav:主要导航,不是所有链接

nav 表示「一组用于导航的链接」。注意「主要」两个字:文章正文里出现几个相关链接,不需要包 nav;页脚那堆备案、隐私政策链接,通常也不值得单独标 nav。真正该用的是主导航、面包屑、文章目录、分页器这类「帮助用户在站点里移动」的链接组。

一个页面可以有好几个 nav,但每个最好带一个能区分的名字,比如 aria-label="主导航"、aria-label="文章目录"。否则读屏软件会报「导航、导航、导航」,用户不知道进哪个。这个站在页面顶部和文章右侧都用了导航,就是靠 aria-label 区分的。

main:正文只能有一块

main 是页面独有的主要内容。规范要求一个页面只能有一个可见的 main,而且它不应该被放进 header、footer、nav、aside 里面。原因很实际:读屏软件有「跳到主要内容」的快捷键,它找的就是这个标签。如果页面上有多个 main,或者正文其实在 main 外面,这个快捷键就失效了。

还有个常见场景:列表页的每一张卡片都写 main。这是错的。卡片是列表项,整页的列表才是主要内容。判断标准很简单:把页面上其他东西全删掉,剩下的那块就是 main。

article 与 section:一个靠「独立性」,一个靠「主题」

这两个最容易被滥用,也最值得说清。用一组对比来看:

article

能独立拿出去、脱离当前页面也成立的一段内容。比如一篇博客、一条新闻、一个商品卡、一条用户评论。

section

按主题划分的一块内容,通常需要一个小标题。它强调的是「同一页面内的分组」,不强调独立性。

拿文章页举例:整篇文章是 article,里面的「环境准备」「安装步骤」「常见问题」是三个 section,每个都有自己的 h2。再拿首页举例:如果首页是一列文章摘要,每条摘要可以是一个 article;如果首页只是一段介绍加几个入口,那用 section 分组就够了,不必硬套 article。

一个很常见的错误是「为了语义化,把所有 div 都改成 section」。结果一个页面十几个 section,其中一半没有标题,读屏软件报出一串没有名字的区域,反而更乱。规范的建议是:section 一般应该有标题;如果没有合适的标题,就说明它可能只是一个样式容器,用 div 更诚实。

aside:和正文有关、但不是正文

aside 表示「附属内容」:侧边栏推荐、相关文章、作者简介、广告位、术语解释。它和正文有关系,但删掉也不影响正文完整性。反过来说,如果一块内容删掉之后文章就读不通了,那它不该是 aside。

移动端有个实际取舍:桌面端放在右侧的推荐栏,到了手机上往往被排到正文后面。用 aside 不会自动改变顺序,顺序还是由 DOM 决定。如果希望手机上先看正文,就必须在 DOM 里把正文放在前面,再用布局把它排到右边。这件事在讲 Grid 和响应式时会展开。

语义化到底带来什么,代价是什么

可访问性:最确定的收益

这是语义化最实在的好处。读屏软件、浏览器、键盘用户都依赖结构来判断页面。有了正确的分区标签,用户可以按快捷键在「导航」「正文」「补充内容」之间跳转,而不是从头听到尾。再加上一个「跳到主要内容」的链接,键盘用户按一次 Tab 就能绕过导航。这个收益是确定存在的,也是无障碍规范里明确要求的。

SEO:有帮助,但别指望换标签提权

搜索引擎确实会分析页面结构,标题层级、正文位置、链接文字都会影响它对内容的理解。但没有可靠证据表明「把 div 换成 article」本身能提高排名。搜索引擎更看重内容质量、链接关系、页面体验这些因素。语义标签的作用是让机器少猜错,属于基本功,不是排名技巧。把语义化当 SEO 捷径,方向就偏了。

可维护性:短期多花时间,长期省时间

全用 div 的页面,三个月后回来看,满屏 class="box wrapper inner",改一个样式要在十几个容器里找。语义标签相当于给结构加了注释,接手的人看到 aside 就知道这块可以整体删。代价是写的时候要多想一步「这块算什么」,以及要处理标签自带的默认边距。小项目、一次性活动页,这个投入可能不划算;长期维护的产品,收益会慢慢显出来。

几个具体的误区

  • 把 section 当 div 用。现象是页面里一堆没有标题的 section,读屏软件列出一串匿名区域。判断方法:给这块内容起不出小标题,就用 div。
  • 一个页面多个 main。现象是「跳到主要内容」快捷键行为异常,或者干脆没反应。一个页面只留一个 main,列表页的卡片不要写。
  • nav 包住所有链接。现象是读屏软件的导航地标列表长得离谱,用户要跳过七八个「导航」。只给真正的导航组用 nav。
  • header 里放正文。有人觉得页面顶部那块都叫 header,就把主标题、摘要、封面图全塞进去。其实文章标题属于 article 的 header,而站点顶部横条是另一个 header,两者层级不同,别合并成一个。
  • 只改标签不改结构。把 div 改成 main,但正文仍然散落在好几个并列容器里,快捷键跳过去只落到一小段。语义标签要和真实的内容边界对齐。

这些误区有个共同点:都是把语义化当成「换标签」的动作,而不是「先想清楚内容边界」的过程。标签换得再勤,边界错了,结果只会更糟。

场景走查:一个订单详情页的分区改造

后来接手一个后台系统的订单详情页改版。页面原来全用 div 加类名:class="top" 放面包屑和一排帮助链接,class="content" 放订单信息、商品明细、物流,class="side" 放相关订单推荐。视觉上没有问题,但无障碍评审提了三条具体意见:读屏软件找不到「主要内容」;导航地标列表里前五个都叫「导航」;手机上打开,先出现的是相关订单推荐,正文要往下滑很久。

第一版修改很粗暴。我把能换的 div 全换成了 section,觉得「语义化就是换标签」。改完用读屏一测,情况更乱:页面列出十几个没有名字的区域,因为那些 section 都没有标题;面包屑仍然被当成一组普通链接;推荐区在 DOM 里仍然排在正文前面,手机上的顺序一点没变。

第二次改,我不再逐行替换,而是先把页面上的内容按角色列成一张清单:站点顶栏、面包屑、订单正文、正文里的三个主题块、相关订单。然后对着清单定标签:顶栏用 header;面包屑是一组导航链接,用 nav 加 aria-label;整块订单内容用 main,因为删掉它页面就没有主体;main 里按主题分成三个 section,每个补一个 h2;相关订单是附属信息,用 aside。

最关键的一步不是选标签,而是调 DOM 顺序。原来 aside 写在 main 前面,我把它移到后面,再用布局把它放到右侧。这样手机上是正文在前、推荐在后,桌面上视觉位置不变。改完再测:跳到主要内容能直接落到订单正文,导航地标只剩三个且都有名字,手机上也不用先划过推荐。

这次返工让我改了一个习惯:语义化不是「把 div 换成 section」,而是先想清楚页面有哪几块、每块对读者意味着什么,再决定标签和顺序。顺序这件事比标签名更容易被漏掉,因为它完全不体现在视觉上。

错误现象对照

语义化的很多问题,单看页面是看不出来的,必须换一个「消费者」去读。下表是几个我实际遇到过的现象。

现象真实原因第一步查什么
按「跳到主要内容」快捷键没反应,或落点很奇怪main 缺失、出现多个,或者正文不在它里面数 DOM 里 main 的数量和嵌套位置
读屏软件列出一串「区域」,但都不报名字section 被当成分组容器用,里面没有标题逐个检查 section 第一个子元素是不是标题
导航地标列表长得离谱,要跳过七八个「导航」nav 滥用,且多个 nav 没有区分标签统计 nav 数量,检查各自的 aria-label
把标签换了个遍,页面看着一点变化没有语义收益面向读屏、搜索和接手的开发者,不面向视觉用读屏或 DOM 大纲验证,不要只看截图
手机上推荐内容跑到正文前面DOM 顺序决定阅读和排列顺序,CSS 定位不改变语义顺序看源码里 aside 和 main 谁在前
视觉顺序正常,读屏却从侧栏开始念用 flex 或 grid 的 order 改了视觉位置,DOM 顺序没动对比 DOM 顺序与实际朗读顺序

边界与代价

语义化不是无条件正确的。第一层边界是收益对象:它主要服务读屏用户、搜索引擎和维护代码的人。如果页面是内部工具、一次性的活动页,使用者只有几个同事,投入产出比就不高。这不是说可以乱写,而是不值得为它反复推敲标签,用 div 加清楚的类名完全够用。

第二层边界是标签覆盖不了内容组织的问题。页面分区再标准,如果标题层级混乱、正文东一块西一块,读屏用户照样读不明白。语义标签是骨架,不是内容的替代品。

第三层是宿主环境。用组件库时,很多结构由库内部决定,你在外层能控制的只有少数几个容器;富文本和用户评论的 HTML 来自编辑器,标签可能被过滤或改写;邮件模板基本用不上这套标签。在这些场景里,先接受限制,再在能控制的地方做对。

成本也很具体:团队要有一致的判断标准,否则一个人用 section、一个人用 div,风格比全用 div 还乱;语义标签的默认样式需要重置,设计稿的视觉分区和语义分区也不总是一一对应,有时一个大框里其实该拆成两个语义区,有时一个语义区被视觉拆成三块。遇到冲突,通常以语义为准,再用 CSS 补视觉。至于规模,超过几十个页面之后,靠个人自觉维持结构一致会失效,得把分区模式沉淀成组件或模板。

副作用也有一条:地标不是越多越好。给每个小模块都套一个带名字的 nav 或 section,读屏用户要在噪音里找目标,反而更累。语义化做到「关键分区清楚」就够了,不必追求满页都是标签。

小结与练习

记住一个判断顺序:先问这块内容「是不是页面的主体」,再问「能不能独立成活」,然后问「是不是导航」「是不是附属」。四个问题问完,标签基本就定了。剩下的装饰性容器,大方地用 div,不用有心理负担。

当天可以自己验证的几件事:

  • 打开本文页面,在 Elements 面板里数一数有几个 main、几个 nav,每个 nav 是否都有可区分的名字。
  • 找一个你常看的网站,在开发者工具里临时禁用所有样式,看还能不能分清导航、正文和页脚。分不清的地方,就是语义结构薄弱的地方。
  • 给自己手头一个全 div 的页面列一张「角色清单」,只写每块内容是什么,先不写标签,再对着清单决定用哪个标签。
  • 只用键盘 Tab 走一遍页面,看能不能较快跳过导航到达正文;再手动加一个「跳到主要内容」的链接,对比前后差别。
  • 检查页面里每个 section 是否都有标题,没有的改成 div,然后重新用读屏或大纲工具听一遍。

结构定好之后,页面要能和外界连接:点得动的链接、显示得出来的图片、放得了的视频。下一篇 链接、图片与媒体 重点放在路径怎么写、alt 到底该写什么,以及图片尺寸没写会导致什么真实的布局问题。那篇里的很多坑,和本篇一样,都是「本地看着正常、换个环境就出问题」。