semi-design/content/feedback/popconfirm/index.md

---

localeCode: zh-CN order: 63 category: 反馈类 title: Popconfirm 气泡确认框 icon: doc-popconfirm

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

何时使用

目标元素的操作需要用户进一步的确认时，在目标元素附近弹出浮层提示，询问用户。

和 Modal.confirm 弹出的全屏居中模态对话框相比，交互形式更轻量。

代码演示

如何引入

import { Popconfirm } from '@douyinfe/semi-ui';

基本使用

import React from 'react';
import { Popconfirm, Button, Toast } from '@douyinfe/semi-ui';

() => {
    const onConfirm = () => {
        Toast.success('确认保存！');
    };

    const onCancel = () => {
        Toast.warning('取消保存！');
    };
    return (
        <Popconfirm
            title="确定是否要保存此修改？"
            content="此修改将不可逆"
            onConfirm={onConfirm}
            onCancel={onCancel}
        >
            <Button>保存</Button>
        </Popconfirm>
    );
};

类型搭配

开发者可以基于场景使用 okType/cancelType/icon 等参数搭配出不同风格的气泡式确认框。

import React, { useState } from 'react';
import { Popconfirm, Radio, RadioGroup, Button } from '@douyinfe/semi-ui';
import { IconAlertTriangle } from '@douyinfe/semi-icons';

function TypesConfirmDemo(props = {}) {
    const typeMap = {
        default: {
            icon: <IconAlertTriangle size="extra-large" />,
        },
        warning: {
            icon: <IconAlertTriangle style={{ color: 'var(--semi-color-warning)' }} size="extra-large" />,
        },
        danger: {
            okType: 'danger',
            icon: <IconAlertTriangle style={{ color: 'var(--semi-color-danger)' }} size="extra-large" />,
        },
        tertiary: {
            icon: <IconAlertTriangle style={{ color: 'var(--semi-color-tertiary)' }} size="extra-large" />,
        },
    };

    const keys = Object.keys(typeMap);
    const [type, setType] = useState('default');
    const [visible, _setVisible] = useState(true);

    const changeType = e => {
        const type = e && e.target && e.target.value;
        if (type && keys.includes(type)) {
            setType(type);
        }
    };

    const setVisible = visible => _setVisible(visible);
    const toggleVisible = () => setVisible(!visible);

    return (
        <div>
            <RadioGroup onChange={changeType} value={type} style={{ marginTop: 14, marginBottom: 14 }}>
                {keys.map(key => (
                    <Radio key={key} value={key}>
                        <strong style={{ color: `var(--semi-color-${key === 'default' ? 'primary' : key})` }}>{key}</strong>
                    </Radio>
                ))}
            </RadioGroup>
            <div>
                <Popconfirm
                    {...typeMap[type]}
                    visible={visible}
                    onVisibleChange={setVisible}
                    trigger="custom"
                    title="确定是否要保存此修改？"
                    content="此修改将不可逆"
                >
                    <Button onClick={toggleVisible}>点击此处</Button>
                </Popconfirm>
            </div>
        </div>
    );
}

搭配 Tooltip 或 Popover 使用

请参考搭配使用

API 参考

属性	说明	类型	默认值	版本
arrowPointAtCenter	“小三角”是否指向元素中心，需要同时传入"showArrow=true"	boolean	false	0.34.0
cancelText	取消按钮文字	string	"取消"
cancelButtonProps	取消按钮的 props	object		0.29.0
cancelType	取消按钮类型	string	"tertiary"
content	显示的内容	string|ReactNode
defaultVisible	气泡框默认是否展示	boolean		0.19.0
disabled	点击 Popconfirm 子元素是否弹出气泡确认框	boolean	false
getPopupContainer	指定父级 DOM，弹层将会渲染至该 DOM 中，自定义时容器需要设置 position: relative	Function():HTMLElement	() => document.body
icon	自定义弹出气泡 Icon 图标	ReactNode
motion	下拉列表出现/隐藏时，是否有动画	boolean|object	true
okText	确认按钮文字	string	"确认"
okType	确认按钮类型	string	"primary"
okButtonProps	确认按钮的 props	object		0.29.0
position	方向，可选值：top,topLeft,topRight,left,leftTop,leftBottom, right,rightTop,rightBottom,bottom,bottomLeft,bottomRight	string	"bottomLeft"
showArrow	是否显示箭头三角形	boolean	false
stopPropagation	是否阻止弹层上的点击事件冒泡	boolean	true	0.34.0
title	显示的标题	string|ReactNode
trigger	触发展示的时机，可选值：hover / focus / click / custom	string	'click'
visible	气泡框是否展示的受控属性	boolean		0.19.0
zIndex	浮层 z-index 值	number	1030
onConfirm	点击确认按钮回调	Function(e)
onCancel	点击取消按钮回调	Function(e)
onClickOutSide	当弹出层处于展示状态，点击非Children、非浮层内部区域时的回调	Function(e)	2.1.0
onVisibleChange	气泡框切换显示隐藏的回调	Function(visible: boolean): void	() => {}	0.19.0

设计变量