Popup 弹出层
弹出层容器,用于展示弹窗、信息提示等内容,支持上、下、左、右和中部弹出。组件只提供容器,内部内容由用户自定义
平台差异说明
App | H5 | 微信小程序 | 支付宝小程序 | 百度小程序 | 头条小程序 | QQ小程序 |
---|---|---|---|---|---|---|
√ | √ | √ | √ | √ | √ | √ |
基本使用
- 弹出层的内容通过
slot
传入,由用户自定义 - 通过
v-model
绑定一个布尔值的变量控制弹出层的打开和收起
<template>
<u-popup v-model="show">
<view>出淤泥而不染,濯清涟而不妖</view>
</u-popup>
</template>
<script>
export default {
data() {
return {
show: false
}
}
}
</script>
设置弹出层的方向
- 可以通过
mode
参数设置,可以设置为left
、top
、right
、bottom
、center
<template>
<u-popup v-model="show" mode="top">
<view>
人生若只如初见,何事秋风悲画扇
</view>
</u-popup>
</template>
设置弹出层的圆角
可以给border-radius
设置一个值来给弹窗增加圆角,单位rpx。
<template>
<u-popup v-model="show" mode="top" border-radius="14">
<view>
人生若只如初见,何事秋风悲画扇
</view>
</u-popup>
</template>
控制弹窗的宽度 | 高度
这里说的宽度,指的是左边,右边,中部弹出的场景,高度指的是顶部和底部弹出的场景(因为这两个场景宽度都是100%)。
uView提供了length
来控制此种情况,此值可以是数值
(单位rpx),auto
,百分比
等,内部会自动处理对应的逻辑。 如果为auto
的时候,表示弹窗的宽度 | 高度由内容撑开。
<template>
<u-popup v-model="show" mode="top" length="60%">
<view>
等闲变却故人心,却道故人心易变
</view>
</u-popup>
</template>
API
Props
注意:props中没有控制弹窗打开与收起的参数,因为这是通过v-model绑定变量实现的,见上方说明。
参数 | 说明 | 类型 | 默认值 | 可选值 |
---|---|---|---|---|
mode | 弹出方向 | String | left | top / right / bottom / center |
mask | 是否显示遮罩 | Boolean | true | false |
length | mode=left | 见上方说明 | String | Number | auto | - |
zoom | 是否开启缩放动画,只在mode 为center 时有效 | Boolean | true | false |
safe-area-inset-bottom | 是否开启底部安全区适配 | Boolean | false | true |
mask-close-able | 点击遮罩是否可以关闭弹出层 | Boolean | true | false |
custom-style | 用户自定义样式 | Object | - | - |
border-radius | 弹窗圆角值 | Number | String | 0 | - |
z-index | 弹出内容的z-index 值 | Number | String | 1075 | - |
closeable | 是否显示关闭图标 | Boolean | false | true |
close-icon | 关闭图标的名称,只能uView的内置图标 | String | close | - |
close-icon-pos | 自定义关闭图标位置,top-left为左上角,top-right为右上角,bottom-left为左下角,bottom-right为右下角 | String | top-right | top-left / bottom-left / bottom-right |
close-icon-color | 关闭图标的颜色 | String | #909399 | - |
close-icon-size | 关闭图标的大小,单位rpx | String | Number | 30 | - |
Event
事件名 | 说明 | 回调参数 | 版本 |
---|---|---|---|
open | 弹出层打开 | - | - |
close | 弹出层收起 | - | - |