跳至正文

Alert modal

要求用户确认或取消操作的对话框。

浏览器
Chrome 123+Firefox 121+Safari 17.5+
层级
0
压缩后大小
555 B
强制布局预算
0 ms
axe 预算
0
支持 SSR
是
基于
elements/dialog
公开契约
测试环境

交互示例

Alert Modal

Closed

Delete item?

This action cannot be undone.

API

AlertModal

属性类型默认值说明
id*string—alertdialog元素的唯一id,作为触发器、取消和操作按钮的目标。
trigger*ReactNode—打开对话框的按钮内容。
title*ReactNode—在对话框内渲染的标题,用作无障碍名称。
descriptionReactNode—在标题下方渲染的辅助文本,由aria-describedby引用。
childrenReactNode—位于描述和两个按钮之间的主体内容。
actionLabelReactNode"Confirm"确认按钮的内容,以"confirm"值关闭。
cancelLabelReactNode"Cancel"取消按钮的内容,以"cancel"值关闭。
classNamestring—应用于dialog元素的类名。

AlertModalTrigger

属性类型默认值说明
target*string—此按钮打开的AlertModalContent id;由浏览器在点击时解析。
childrenReactNode—触发器按钮的内容。
asTAs & NativeButtonAs<TAs>"button"将props和ref转发给原生按钮的组件;拒绝其他标签,因为调用命令需要真实按钮。

AlertModalContent

属性类型默认值说明
id*string—使用方提供的唯一id,由其他组成部分引用。
childrenReactNode—对话框内容,以role="alertdialog"渲染。

AlertModalAction

属性类型默认值说明
target*string—此按钮为确认操作而关闭的AlertModalContent id。
childrenReactNode—确认按钮的内容。
asTAs & NativeButtonAs<TAs>"button"将props和ref转发给原生按钮的组件;拒绝其他标签,因为调用命令需要真实按钮。

AlertModalCancel

属性类型默认值说明
target*string—此按钮为取消操作而关闭的AlertModalContent id。
childrenReactNode—取消按钮的内容。
asTAs & NativeButtonAs<TAs>"button"将props和ref转发给原生按钮的组件;拒绝其他标签,因为调用命令需要真实按钮。

键盘

按键操作
Tab将焦点移入或移出控件
Enter / Space获得焦点时激活(按钮类控件)

无障碍

尽可能使用语义化HTML。可在交互示例中检查渲染的标记;仅在原生元素无法满足需求时添加ARIA。

样式钩子

data-disabled
本页由机器翻译,尚未经人工审核。