弹出层容器,用于展示弹窗、信息提示等内容,支持上、下、左、右和中部弹出。组件只提供容器,内部内容由用户自定义
#平台差异说明
#基本使用
- 弹出层的内容通过
slot
传入,由用户自定义
- 通过
v-model
绑定一个布尔值的变量控制弹出层的打开和收起
<template>
<view>
<u-popup v-model="show">
<view>出淤泥而不染,濯清涟而不妖</view>
</u-popup>
<u-button @click="show = true">打开</u-button>
</view>
</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
的时候,表示弹窗的宽度 | 高度由内容撑开。
1.3.7版本新增width
和height
参数: 1.3.7
1.3.7版本后,优先推荐width
和height
参数,并且优先级会高于length
,这3个参数都可以设置百分比
、auto
、数值
(单位rpx)、或者是带px
和rpx
单位的字符串:
width
只对mode = left | center | right
模式有效
height
只对mode = top | center | bottom
模式有效
提示
1.3.7版本后,内置了scroll-view
元素,内如内容超出容器的高度,将会自动获得垂直滚动的特性,如果您因为在slot
内容做了滚动的处理,而造成了 冲突的话,请移除自定义关于滚动部分的逻辑。
<template>
<u-popup v-model="show" mode="top" length="60%">
<view>
等闲变却故人心,却道故人心易变
</view>
</u-popup>
<u-popup v-model="show" mode="center" width="500rpx" height="600px">
<view>
骊山语罢清宵半,泪雨霖铃终不怨
</view>
</u-popup>
</template>
#内容局部滚动
如果您需要让弹窗中的内容局部滚动,局部固定,比如商城底部弹出SKU选择的场景,可以按如下思路进行处理:
- 在弹窗内容中放一个
scroll-view
组件,设置为竖向滚动,并指定高度(必须)
- 在
scroll-view
组件下方放一块无需滚动内容,如下:
<template>
<view class="">
<u-button @click="show = true;">打开弹窗</u-button>
<u-popup mode="bottom" v-model="show">
<view class="content">
<scroll-view scroll-y="true" style="height: 300rpx;">
<view>
<view v-for="index in 20" :key="index">
第{{index}}个Item
</view>
</view>
</scroll-view>
<view class="confrim-btn">
<u-button @click="show = false;">确定</u-button>
</view>
</view>
</u-popup>
</view>
</template>
<script>
export default {
data() {
return {
show: false
}
}
}
</script>
<style lang="scss" scoped>
.content {
padding: 24rpx;
text-align: center;
}
</style>
#API
#Props
注意:props中没有控制弹窗打开与收起的参数,因为这是通过v-model绑定变量实现的,见上方说明。
#Event