Popup 弹出层
弹出层容器,用于展示弹窗、信息提示等内容,支持多个弹出层叠加展示。
基础用法
弹出位置
关闭图标
圆角弹窗
监听点击事件
Popup 支持以下点击事件: click: 点击弹出层时触发。 click-overlay: 点击遮罩层时触发。 click-close-icon: 点击关闭图标时触发。
监听显示事件
当 Popup 被打开或关闭时,会触发以下事件:
open: 打开弹出层时立即触发。 opened: 打开弹出层且动画结束后触发。 close: 关闭弹出层时立即触发。 closed: 关闭弹出层且动画结束后触发。
指定挂载位置
Popup API
Popup 属性
属性名 | 说明 | Type | 默认值 |
---|---|---|---|
v-model:show | 是否显示弹出层 | boolean | false |
overlay | 是否显示遮罩层 | boolean | true |
position | 弹出位置,可选值为 top bottom right left | string | center |
overlay-class | 自定义遮罩层类名 | string | Array |
overlay-style | 自定义遮罩层样式 | object | — |
duration | 动画时长,单位秒,设置为 0 可以禁用动画 | number | string |
z-index | 将弹窗的 z-index 层级设置为一个固定值 | number | string |
round | 是否显示圆角 | boolean | false |
destroy-on-close | 是否在关闭时销毁内容 | boolean | false |
lock-scroll | 是否锁定背景滚动 | boolean | true |
lazy-render | 是否在显示弹层时才渲染节点 | boolean | true |
close-on-popstate | 是否在页面回退时自动关闭 | boolean | false |
close-on-click-overlay | 是否在点击遮罩层后关闭 | boolean | true |
closeable | 是否显示关闭图标 | boolean | false |
close-icon | 关闭图标名称或图片链接,等同于 Icon 组件的 name 属性 | string | cross |
close-icon-position | 关闭图标位置,可选值为 top-left bottom-left bottom-right | string | top-right |
icon-prefix | 图标类名前缀,等同于 Icon 组件的 class-prefix 属性 | string | van-icon |
transition | 动画类名,等价于 transition 的 name 属性 | string | - |
transition-appear | 是否在初始渲染时启用过渡动画 | boolean | false |
teleport | 指定挂载的节点,等同于 Teleport 组件的 to 属性 | string | Element |
safe-area-inset-top | 是否开启顶部安全区适配 | boolean | false |
safe-area-inset-bottom | 是否开启底部安全区适配 | boolean | false |
Popup 插槽
名称 | 说明 |
---|---|
default | 弹窗内容 |
overlay-content | 遮罩层的内容 |