弹出窗口
安置
弹出窗口有 9 个展示位置。
使用属性 content 设置悬停时的显示内容。属性 placement 确定 Popover 的位置。其值为 [orientation]-[alignment],有四个方向 top、left、right、bottom 和三个对齐方式 start、end, null,默认对齐方式为空。以 placement="left-end" 为例,Popover 将显示在您悬停的元素的左侧,并且 Popover 的底部与元素的底部对齐。
基本用法
弹出框是用 ElTooltip 构建的。所以对于一些重复的属性,请参考Tooltip的文档。
trigger 属性用于定义如何触发弹出窗口: hover、click、focus 或 contextmenu 。如果想手动控制,可以设置:visible。
虚拟触发
与 Tooltip 一样,Popover 可以由虚拟元素触发,如果您的用例包括单独的触发元素和内容元素,您绝对应该使用该机制,通常我们使用 #reference 来放置触发元素,使用 triggering-element API 您可以将触发元素设置在任何您喜欢的地方,但请注意,触发元素应该是接受 mouse 和keyboard 事件。
WARNING
v-popover 即将被弃用,请使用 virtual-ref 作为替代。
内容丰富
其他组件/元素可以嵌套在弹出窗口中。以下是嵌套表的示例。
将 content 属性替换为默认的 slot。
嵌套操作
当然,你可以嵌套其他操作。它比使用对话框更轻量。
指令
您仍然可以以指令方式使用弹出框,但不再推荐,因为这会使您的应用程序 比较复杂,可以参考虚拟触发了解更多信息。
API
属性
| 名称 | 描述 | 类型 | 默认 | | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- | --- | | 触发 | 弹出框如何触发,在受控模式下无效 | 枚举 / 数组 | 悬停 | | 触发键 2.9.8 | 当点击鼠标聚焦到触发元素时,可以定义一组键盘代码,通过键盘控制popover的显示,在受控模式下无效 | 数组 | ['输入','空格'] | | 标题 | 弹出窗口标题 | 字符串 | — | | 效果 | 工具提示主题,内置主题:dark / light | 枚举 / 字符串 | 光 | | 内容 | popover内容,可以替换为默认的slot | 字符串 | '' | | 宽度 | 弹出框宽度 | 字符串 / 数字 | 150 | 150 | | 安置 | 弹出框放置 | 枚举 | 底部 | | 已禁用 | 是否禁用 Popover | 布尔值 | 假 | | 可见 / v 模型:可见 | 弹出窗口是否可见 | 布尔值 / 空 | 空 | | 偏移 | 弹出窗口偏移量,Popover 是用 Tooltip 构建的,Popover 的偏移量是 undefined,但 Tooltip 的偏移量是 12 | 数字 | 未定义 | | 过渡 | popover过渡动画,默认为el-fade-in-linear | 字符串 | — | | 显示箭头 | 是否显示工具提示箭头。欲了解更多信息,请参阅ElPopper | 布尔值 | 真实 | | popper 选项 | popper.js 的参数 | 对象 | {modifiers: [{name: 'computeStyles',options: {gpuAcceleration: false}}]} | | 波普尔级 | 弹出窗口的自定义类名 | 字符串 | — | | 波普风格 | 弹出窗口的自定义样式 | 字符串 / 对象 | — | | 后显示 | 出现延迟,以毫秒为单位,在受控模式下无效 | 数字 | 0 | | 隐藏后 | 消失延迟,单位毫秒,在受控模式下无效 | 数字 | 200 | 200 | | 自动关闭 | 隐藏工具提示的超时(以毫秒为单位),在受控模式下无效 | 数字 | 0 | | 标签索引 | 弹出窗口的tabindex | 数字 / 字符串 | 0 | | 传送 | 弹出框下拉列表是否传送到主体 | 布尔值 | 真实 | | 追加到 2.9.10 | 弹出内容内容附加到哪个元素 | CSS选择器 / HTMLElement | 身体 | | 执着 | 当 popover 处于非活动状态且 persistent 为 false 时,popover 将被销毁 | 布尔值 | 真实 | | 虚拟触发 | 指示是否启用虚拟触发 | 布尔值 | — | | 虚拟参考 | 指示弹出框附加到的参考元素 | HTMLElement | — | | 工具提示 | 继承 Tooltip | 中的所有属性— | — |
老虎机
| 名称 | 描述 | 类型 |
|---|---|---|
| 默认 | popover的内容,版本2.13.4及更高版本可以接收hide参数。 | 对象 |
| 参考 | 触发弹出窗口的 HTML 元素,仅接受单个根元素 | - |
活动
| 名称 | 描述 | 类型 |
|---|---|---|
| 显示 | 当弹出窗口显示 | 时触发功能 |
| 输入之前 | 之前进入转换时触发功能 | |
| 输入后 | 当进入转换结束时触发 | 功能 |
| 隐藏 | 弹出窗口隐藏时触发 | 功能 |
| 出发前 | 之前的离开转换时触发功能 | |
| 休假后 | 当离开转换结束时触发 | 功能 |
暴露
| 名称 | 描述 | 类型 |
|---|---|---|
| 隐藏 | 隐藏弹出窗口 | 功能 |