# 气泡确认框 Popconfirm

- 页面: https://jiguang132.com/zh/resources/arco-design/docs/popconfirm
- 资源: Arco Design (https://jiguang132.com/zh/resources/arco-design.md)
- 全部指南: https://jiguang132.com/zh/resources/arco-design/docs.md

点击元素，弹出气泡式的确认框。

## 安装

```bash
npm install @arco-design/web-react@2.66.18
```

在入口引入 `@arco-design/web-react/dist/css/arco.css`，用 `ConfigProvider` 设置语言。React 19 项目还需在入口最先引入 `@arco-design/web-react/es/_util/react-19-adapter`，否则 Message、Modal 等命令式 API 无法渲染。

## 示例

- **基础用法**：最基础的用法。
- **国际化**：自定义按钮文字。
- **位置**：气泡确认框支持 12 个不同的方位。分别为：`上左`、 `上`、 `上右`、`下左`、 `下`、 `下右`、 `左上`、 `左`、 `左下`、 `右上`、 `右`、 `右下`。
- **异步关闭**：用于异步执行某些操作，等操作完成再关闭弹出框。 **用法**：返回一个 `Promise` 用于异步关闭。
- **自定义icon**：自定义图标。

示例来自 Arco Design 官方仓库（MIT），固定在 npm 2.66.18 对应的提交；部分示例使用在线图片或上传地址，预览中网络请求被禁用。

## API

### Popconfirm

|参数名|描述|类型|默认值|版本|
|---|---|---|---|---|
|autoFocus|是否自动聚焦弹出框内的可聚焦元素|boolean |`-`|-|
|defaultPopupVisible|默认弹出框是打开还是关闭|boolean |`-`|-|
|disabled|是否禁用|boolean |`-`|2.11.0|
|focusLock|是否将焦点锁定在弹出框内|boolean |`-`|-|
|popupVisible|弹出框是打开还是关闭。(受控)|boolean |`-`|-|
|unmountOnExit|是否在隐藏的时候销毁 DOM 节点|boolean |`true`|-|
|okType|确认按钮的类型|ButtonProps['type'] |`primary`|-|
|position|弹出框的方位，有 12 个方位可供选择|\| 'top'\| 'tl'\| 'tr'\| 'bottom'\| 'bl'\| 'br'\| 'left'\| 'lt'\| 'lb'\| 'right'\| 'rt'\| 'rb' |`top`|-|
|trigger|触发方式|[TriggerProps](trigger#trigger)['trigger'] |`click`|-|
|cancelText|取消按钮文字|ReactNode |`-`|-|
|icon|标题前的图标|ReactNode |`<IconExclamationCircleFill />`|-|
|okText|确认按钮文字|ReactNode |`-`|-|
|cancelButtonProps|取消按钮的参数，可接受 `Button` 组件的所有参数|ButtonProps |`-`|-|
|className|节点类名|string \| string[] |`-`|-|
|okButtonProps|确定按钮的参数，可接受 `Button` 组件的所有参数|ButtonProps |`-`|-|
|onOk|点击确认按钮的回调函数。回调函数 `event` 参数在 `2.29.0` 支持|(e: React.MouseEvent) =&gt; Promise&lt;any&gt; \| void |`-`|-|
|style|节点样式|CSSProperties |`-`|-|
|triggerProps|可以接受所有 Trigger 的参数|Partial&lt;[TriggerProps](trigger#trigger)&gt; |`-`|-|
|content|内容.函数类型在 `2.48.0` 支持|ReactNode \| (() => ReactNode) |`-`|2.44.0|
|getPopupContainer|弹出挂载的节点|(node: HTMLElement) => Element |`-`|-|
|onCancel|点击取消按钮的回调函数。 回调函数 `event` 参数在 `2.29.0` 支持|(e: React.MouseEvent) => void |`-`|-|
|onVisibleChange|弹出打开和关闭触发的回调|(visible: boolean) => void |`-`|-|
|title|标题。 函数类型在 `2.48.0` 支持|ReactNode \| (() => ReactNode) |`-`|-|

---

JGuang 全部资源索引: https://jiguang132.com/llms.txt