# Poptip 气泡提示

# Poptip 概述

Poptip 与 Tooltip 类似,具有很多相同配置,不同点是 Poptip 以卡片的形式承载了更多的内容,比如链接、表格、按钮等。
Poptip 还 confirm 确认框,与 Modal 不同的是,它会出现在就近元素,相对轻量。

# Poptip 代码示例

# 基础用法

支持三种触发方式:鼠标悬停、点击、聚焦。默认是点击。
注意 Poptip 内的文本使用了 white-space: nowrap;,即不自动换行,如需展示很多内容并自动换行时,建议给内容 slot 增加样式 white-space: normal;

# 位置

组件提供了 12 个不同的方向显示 Poptip,具体配置可查看API

# 从浮层内关闭

通过 v-model 来控制提示框的显示和隐藏。

# 嵌套复杂内容

通过自定义 slot 来实现复杂的内容。

# 确认框

通过设置属性 confirm 开启确认框模式。确认框只会以 click 的形式激活,并且只会显示 title 的内容,忽略 content。

# Poptip API

# Poptip props

属性 说明 类型 默认值
trigger 触发方式,可选值为 hover(悬停)click(点击)focus(聚焦),在 confirm 模式下,只有 click 有效 String click
title 显示的标题 String | Number -
content 显示的正文内容,只在非 confirm 模式下有效 String | Number
placement 提示框出现的位置,可选值为top top-start top-end bottom bottom-start bottom-end left left-start left-end right right-start right-end String top
width 宽度,最小宽度为 150px,在 confirm 模式下,默认最大宽度为 300px String | Number -
confirm 是否开启对话框模式 Boolean false
ok-text 确定按钮的文字,只在 confirm 模式下有效 String 确定
cancel-text 取消按钮的文字,只在 confirm 模式下有效 String 取消
transfer 是否将弹层放置于 body 内,在 Tabs、带有 fixed 的 Table 列内使用时,建议添加此属性,它将不受父级样式影响,从而达到更好的效果 Boolean false
closeOutClick 禁用点击外部关闭弹框的功能(此属性只在1.0.14或以上版本有效) Boolean false
notResponding 禁用默认弹框的响应功能(v1.0.31) Boolean false
isNotCache 设置content文本内容是否每次展开时,重新渲染(v1.0.65)
false: 表示渲染的内容通过v-show来控制
true: 表示内容通过v-if来控制,每次点击都要重新渲染内容
Boolean false

# Poptip events

事件名 说明 返回值
on-popper-hide 在提示框消失时触发
on-ok 点击确定的回调,只在 confirm 模式下有效
on-cancel 点击取消的回调,只在 confirm 模式下有效

# Poptip slot

名称 说明
主体内容
title 提示框标题,定义此 slot 时,会覆盖 props title
content 提示框内容,定义此 slot 时,会覆盖 props content,只在非 confirm 模式下有效