Confirm 确认框
在执行重要操作前征求确认,并等待用户的选择。
编辑内容使用 Modal,希望在触发按钮旁简短确认时使用 Popconfirm。
在应用入口接入 ConfigProvider,子组件即可调用 useConfirm()。确认框沿用调用区域的主题和语言。
基础用法
confirm() 返回 Promise<boolean>:确认得到 true,取消得到 false。
simple.tsx
示例
状态提示
通过 type 选择提示意图,默认为 info。type="default" 不显示内置图标,也可用 icon={null} 隐藏任意类型的图标。success 默认不显示取消按钮,需要时设置 showCancel。
status.tsx
异步确认
将异步操作放入 onConfirm,成功后确认框自动关闭并返回 true。等待期间默认按钮显示加载状态,不能重复确认或取消。
basic.tsx
失败与重试
onConfirm 抛出错误时显示错误并保持打开,可再次确认重试。此例每次打开都先失败一次,第二次成功。
retry.tsx
API
useConfirm API
返回的对象类型是 ConfirmApi。同一队列的请求依次展示,上一个完成关闭过渡后才显示下一个;Promise 在作出决定并开始关闭时返回结果,不等待关闭动画。
调用组件或 Provider 卸载时,未结束的请求返回 false;这不会中止已经执行的异步操作,也不会触发 onCancel。
ConfirmApi
useConfirm() 返回的命令接口。
ConfirmOptions
调用 confirm() 时提供的内容、操作和交互配置。
ConfirmProvider API
未使用 ConfigProvider 时,在入口放置 ConfirmProvider。显式添加 ConfirmProvider 会建立独立队列,嵌套 ConfigProvider 则继续共享已有队列。