界面组件 核心 B · 官方指南或术语 平台: 网页

Error Summary

错误摘要

错误摘要是表单上方的短列表。每一项会说明错误,也能带用户前往要修改的字段。

看看怎样运作
也有人这样说 Error Summary表单错误摘要校验错误列表

看看怎样运作

原创情境示例错误摘要
无障碍界面规则错误摘要submit -> validate -> focus summary -> link each message to its invalid field
创建账号2 个错误
错误摘要请修正 2 个字段#email · 请输入完整的电子邮箱地址#password · 请至少输入 12 个字符
!电子邮箱保留输入值・显示单独提示name@
!密码保留输入值・显示单独提示••••••••
已经填对的内容保留focus → #error-summary
通过摘要会列出每个错误,并链接到对应字段。避免错误摘要不能取代字段旁的单独提示。
submit -> validate -> focus summary -> link each message to its invalid fieldA11Y
错误摘要无障碍界面实践

另一个例子

表单有两个错误。提交后,焦点会移到摘要。选择“电子邮箱”后,焦点会移到对应字段。

主要部分

  1. 01摘要标题
  2. 02错误数量
  3. 03可前往字段的错误项目
  4. 04字段标识符
  5. 05字段旁的单独提示
  6. 06焦点移动路径

什么时候用

提交表单后发现多个错误时,可以显示错误摘要。每个有问题的字段旁仍要保留单独提示。

什么时候不要用

不要只显示一个模糊横幅来取代字段提示。校验失败后,也不要清除已经填对的内容。

代码里的名称

submit -> validate -> focus summary -> link each message to its invalid field

上线前要检查

每个字段都要有程序能读到的标签。关联提示与错误,并保留已输入内容。检查自动填充、键盘顺序、验证时机、提交状态、失败恢复、缩放与多语言。

可以直接复制的需求

预期结果:使用 错误摘要 (Error Summary) 解决这项需求,同时保留用户当前的操作上下文。 用户场景:表单有两个错误。提交后,焦点会移到摘要。选择“电子邮箱”后,焦点会移到对应字段。 建议界面模式:错误摘要 (Error Summary)。 适用理由:提交表单后发现多个错误时,可以显示错误摘要。每个有问题的字段旁仍要保留单独提示。 不应使用的情况:不要只显示一个模糊横幅来取代字段提示。校验失败后,也不要清除已经填对的内容。 产品要求:定义默认、加载、没有内容、错误、成功与恢复状态。保留用户已输入的内容,每个操作后都提供清楚反馈。 无障碍与韧性:使用结构正确的 HTML(语义化 HTML)和完整键盘操作。焦点要清楚可见,布局缩放后仍要好用。也要提供减少动态效果。遵守项目现有规则。除非项目已采用,否则不要新增界面组件库。 验收标准:主要任务可只用键盘完成,在 320px 宽度也能正常使用。焦点与状态变化可被辅助工具读出。加载、失败、重试、取消与减少动态效果都已验证。 证据与限制(证据边界):它只代表该来源的官方说法。其他平台或团队可能有不同用法。 待确认:产品文字、数据来源、分析事件、支持设备与语言,以及平台特有限制。

检查这份需求

请 AI 编程助手检查当前如何使用 错误摘要 (Error Summary)。 定义:错误摘要是表单上方的短列表。每一项会说明错误,也能带用户前往要修改的字段。 生产环境检查:每个字段都要有程序能读到的标签。关联提示与错误,并保留已输入内容。检查自动填充、键盘顺序、验证时机、提交状态、失败恢复、缩放与多语言。 修改程序前,先列出看到的证据、缺口、严重程度,以及最小且安全的修正。

B
这个术语有多正式?

官方指南或术语

列出的平台、框架、项目或专业组织,发布了这个术语的官方指南。

它只代表该来源的官方说法。其他平台或团队可能有不同用法。

适用范围
只包含来源有说明的内容:正式名称、定义、交互行为、键盘行为、无障碍
文档状态
稳定
核验日期
2026-07-30

证据来源与适用范围

正式来源 + 术语参考资料 · W3C WAI · 稳定 User Notification — Listing Errors 适用范围: 正式名称、定义、交互行为、键盘行为、无障碍 本页用途: 直接术语参考 来源涵盖内容: 正式名称, 定义, 交互行为, 键盘行为, 无障碍 正式来源 · GOV.UK Design System · 稳定 Error summary 适用范围: 正式名称、定义、交互行为、键盘行为、无障碍 本页用途: 只支持写明的范围 来源涵盖内容: 正式名称, 定义, 交互行为, 键盘行为, 无障碍

自行复制

浏览器无法自动复制。请选择下方文字,再自行复制。