界面组件 深入了解 A1 · 正式标准

Alert Dialog

警告对话框

警告对话框是处理紧急选择的模态对话框,用户必须先了解后果才能继续。

动手试试看
也有人这样说 Alert Dialog确认弹窗警告弹窗

动手试试看

警告对话框role="alertdialog"
删除 Aurora 项目?

这会永久移除 3 个环境、18 次发布和更改记录,而且无法恢复。

↩ 关闭后,键盘焦点会回到打开按钮。

生活中的例子

永久清空回收站前,对话框会说清楚哪些内容将消失,并提供安全的“取消”选项。

主要部分

  1. 01触发对象
  2. 02锚定或模态表面
  3. 03焦点边界
  4. 04关闭方式

什么时候用

操作会造成破坏、无法撤销,或立刻产生重大后果时,就使用警告对话框。

什么时候不要用

无害而且可以撤销的操作,不要每次都要求确认,以免用户忽略真正的警告。

代码里的名称

role="alertdialog"

上线前要检查

只在遮住整个页面的对话框中限制焦点,其他情况不要困住焦点。支持 Esc 键与清楚可见的关闭按钮;关闭后,把焦点还给原来的按钮。保留已输入数据,并检查小屏幕、加载与失败状态。

可以直接复制的需求

预期结果:使用 警告对话框 (Alert Dialog) 解决这项需求,同时保留用户当前的操作上下文。 用户场景:永久清空回收站前,对话框会说清楚哪些内容将消失,并提供安全的“取消”选项。 建议界面模式:警告对话框 (Alert Dialog)。 适用理由:操作会造成破坏、无法撤销,或立刻产生重大后果时,就使用警告对话框。 不应使用的情况:无害而且可以撤销的操作,不要每次都要求确认,以免用户忽略真正的警告。 产品要求:定义默认、加载、没有内容、错误、成功与恢复状态。保留用户已输入的内容,每个操作后都提供清楚反馈。 无障碍与韧性:使用结构正确的 HTML(语义化 HTML)和完整键盘操作。焦点要清楚可见,布局缩放后仍要好用。也要提供减少动态效果。遵守项目现有规则。除非项目已采用,否则不要新增界面组件库。 验收标准:主要任务可只用键盘完成,在 320px 宽度也能正常使用。焦点与状态变化可被辅助工具读出。加载、失败、重试、取消与减少动态效果都已验证。 证据与限制(证据边界):标准只涵盖列出的范围,不会替你决定外观、产品做法或 Vibulary 的教学示例。 待确认:产品文字、数据来源、分析事件、支持设备与语言,以及平台特有限制。

检查这份需求

请 AI 编程助手检查当前如何使用 警告对话框 (Alert Dialog)。 定义:警告对话框是处理紧急选择的模态对话框,用户必须先了解后果才能继续。 生产环境检查:只在遮住整个页面的对话框中限制焦点,其他情况不要困住焦点。支持 Esc 键与清楚可见的关闭按钮;关闭后,把焦点还给原来的按钮。保留已输入数据,并检查小屏幕、加载与失败状态。 修改程序前,先列出看到的证据、缺口、严重程度,以及最小且安全的修正。

A1
这个术语有多正式?

正式标准

本页说明的规则,可以在列出的正式标准中找到。

标准只涵盖列出的范围,不会替你决定外观、产品做法或 Vibulary 的教学示例。

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

证据来源与适用范围

正式来源 + 术语参考资料 · W3C · 正式推荐标准 Accessible Rich Internet Applications (WAI-ARIA) 1.2 — alertdialog role alertdialog role 适用范围: 正式名称、定义、语义、实现 本页用途: 直接术语参考 来源涵盖内容: 正式名称, 定义, 语义, 实现 正式来源 · W3C · 正式推荐标准 Accessible Rich Internet Applications (WAI-ARIA) 1.2 适用范围: 正式名称、定义、语义、实现 本页用途: 只支持写明的范围 来源涵盖内容: 正式名称, 定义, 语义, 实现 正式来源 · W3C WAI · 稳定 ARIA Authoring Practices Guide 适用范围: 正式名称、定义、交互行为、键盘行为、无障碍 本页用途: 只支持写明的范围 来源涵盖内容: 正式名称, 定义, 交互行为, 键盘行为, 无障碍

自行复制

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