Popover 弹出框
基础用法
Popover 是在 GTooltip
基础上开发出来的。 因此对于重复属性,请参考 Tooltip 的文档,在此文档中不做详尽解释。
虚拟触发
像 Tooltip一样,Popover 可以由虚拟元素触发,这个功能就很适合使用在触发元素和展示内容元素是分开的场景。通常我们使用 #reference
来放置我们的触发元素, 用 triggering-element
API,您可以任意设置您的触发元素 但注意到触发元素应该是接受 mouse
和 keyboard
事件的元素。
WARNING
v-popover
将被废弃,请使用 virtual-ref
作为替代。
内容可扩展
可以在 Popover 中嵌套其它组件, 以下为嵌套表格的例子。
嵌套操作
当然,你还可以嵌套操作, 它比使用dialog更加轻量。
API
属性名 | 说明 | 类型 | 接受值 | 默认值 |
---|---|---|---|---|
trigger | 触发方式 | string | click/focus/hover/contextmenu | hover |
title | 标题 | string | — | — |
content | 显示的内容,也可以通过写入默认 slot 修改显示内容 slot | string | — | — |
width | 宽度 | string / number | — | 150px |
placement | 出现位置 | string | top/top-start/top-end/bottom/bottom-start/bottom-end/left/left-start/left-end/right/right-start/right-end | bottom |
disabled | Popover 是否可用 | boolean | — | false |
visible / v-model:visible | Popover 是否显示 | Boolean | — | false |
offset | 浮层偏移量, Popover 是在 Tooltip,基础上开发的, Popover的 offset 是 undefined, 但Tooltip 的 offset 是12 | number | — | 12 |
transition | 定义渐变动画,默认是 el-fade-in-linear | string | — | el-fade-in-linear |
show-arrow | 是否显示 Tooltip 箭头 | boolean | — | true |
Slots
插槽名 | 说明 |
---|---|
default | Popover 内嵌 HTML 文本 |
reference | 触发 Popover 显示的 HTML 元素 |
Events
事件名 | 说明 | 参数 |
---|---|---|
show | 显示时触发 | — |
before-enter | 显示动画播放前触发 | — |
after-enter | 显示动画播放完毕后触发 | — |
hide | 隐藏时触发 | — |
before-leave | 隐藏动画播放前触发 | — |
after-leave | 隐藏动画播放完毕后触发 | — |