fieldset 必须配对 legend 使用,legend 是其必要标题且须为首个子元素;禁用整个分组应使用 fieldset 的 disabled 属性;嵌套需有真实逻辑,避免冗余;legend 内容须具体描述控件用途。
fieldset 用来包裹一组语义相关的表单控件
它不是装饰用的 div,而是有明确语义和辅助技术支持的原生分组机制。屏幕阅读器会把 fieldset 内的内容当作一个逻辑单元读出,同时自动关联 legend 作为该组的标题。
- 必须配对使用:
fieldset里至少得有一个legend,否则语义断裂,部分读屏软件可能忽略整个分组 - 不要用
div+ CSS 模拟分组外观——视觉像了,但键盘导航、焦点管理、语义结构全丢了 -
legend必须是fieldset的第一个子元素,放后面或用position: absolute移走都会破坏可访问性
legend 是 fieldset 的唯一合法标题,不能省略也不能重复
legend 不是可选标签,也不是“加个文字好看”。它是 fieldset 的必要组成部分,也是浏览器计算表单可访问性树的关键节点。
- 空
legend(比如<legend></legend>)等同于没写,会导致分组无描述,WCAG 会报错 - 多个
legend只渲染第一个,其余被忽略——别试图靠多加几个来实现副标题效果 - 如果视觉上不想显示标题文字,用
visually-hidden类(而非display: none或aria-hidden="true"),否则读屏仍会丢失上下文
禁用整个分组:用 fieldset 的 disabled 属性,别逐个控件设
fieldset 支持原生 disabled 属性,作用是禁用内部所有可交互子元素(input、select、button 等),且会自动灰显、阻止焦点进入、屏蔽表单提交值。
- 手动给每个子控件加
disabled容易漏掉,也难维护;用fieldset一层控制更可靠 - 注意:被
disabled的fieldset内的值不会提交,哪怕你 JS 临时改了input.value - 若需“只读但可聚焦”,别用
disabled,改用fieldset[aria-readonly="true"]+ CSS 控制样式,再自行处理交互逻辑
嵌套 fieldset 会增加语义层级,但别为了结构而嵌套
HTML 允许 fieldset 嵌套,比如大分类下再分小选项组。但这不是排版技巧,而是表达「组中组」的真实逻辑关系。
- 嵌套过深(超过两层)会让屏幕阅读器播报冗长,用户容易迷失上下文
- 不要只因样式需要(比如想加个内边框)就套一层
fieldset——没有legend的嵌套毫无意义,还可能干扰表单验证流程 - 动态生成时注意:JS 插入
fieldset后,要确保legend节点已挂载,否则初始无障碍树可能不完整
legend 的内容是否真正描述了这一组控件的用途。写成“选项”“设置”这种泛称,和留空几乎一样无效。











