Skip to content

Popup 弹出层

继承van-popup所有属性

弹出层容器,用于展示弹窗、信息提示等内容,支持多个弹出层叠加展示。

基础用法

弹出位置

关闭图标

圆角弹窗

监听点击事件

Popup 支持以下点击事件: click: 点击弹出层时触发。 click-overlay: 点击遮罩层时触发。 click-close-icon: 点击关闭图标时触发。

监听显示事件

当 Popup 被打开或关闭时,会触发以下事件:

open: 打开弹出层时立即触发。 opened: 打开弹出层且动画结束后触发。 close: 关闭弹出层时立即触发。 closed: 关闭弹出层且动画结束后触发。

指定挂载位置

属性名说明Type默认值
v-model:show是否显示弹出层booleanfalse
overlay是否显示遮罩层booleantrue
position弹出位置,可选值为 top bottom right leftstringcenter
overlay-class自定义遮罩层类名stringArray
overlay-style自定义遮罩层样式object
duration动画时长,单位秒,设置为 0 可以禁用动画numberstring
z-index将弹窗的 z-index 层级设置为一个固定值numberstring
round是否显示圆角booleanfalse
destroy-on-close是否在关闭时销毁内容booleanfalse
lock-scroll是否锁定背景滚动booleantrue
lazy-render是否在显示弹层时才渲染节点booleantrue
close-on-popstate是否在页面回退时自动关闭booleanfalse
close-on-click-overlay是否在点击遮罩层后关闭booleantrue
closeable是否显示关闭图标booleanfalse
close-icon关闭图标名称或图片链接,等同于 Icon 组件的 name 属性stringcross
close-icon-position关闭图标位置,可选值为 top-left
bottom-left bottom-right
stringtop-right
icon-prefix图标类名前缀,等同于 Icon 组件的 class-prefix 属性stringvan-icon
transition动画类名,等价于 transition 的 name 属性string-
transition-appear是否在初始渲染时启用过渡动画booleanfalse
teleport指定挂载的节点,等同于 Teleport 组件的 to 属性stringElement
safe-area-inset-top是否开启顶部安全区适配booleanfalse
safe-area-inset-bottom是否开启底部安全区适配booleanfalse
名称说明
default弹窗内容
overlay-content遮罩层的内容