Popup 弹出层

弹出层容器,用于展示弹窗、信息提示等内容,支持上、下、左、右和中部弹出。组件只提供容器,内部内容由用户自定义

平台差异说明

AppH5微信小程序支付宝小程序百度小程序头条小程序QQ小程序

基本使用

  • 弹出层的内容通过slot传入,由用户自定义
  • 通过v-model绑定一个布尔值的变量控制弹出层的打开和收起
  1. <template>
  2. <u-popup v-model="show">
  3. <view>出淤泥而不染,濯清涟而不妖</view>
  4. </u-popup>
  5. </template>
  6. <script>
  7. export default {
  8. data() {
  9. return {
  10. show: false
  11. }
  12. }
  13. }
  14. </script>

设置弹出层的方向

  • 可以通过mode参数设置,可以设置为lefttoprightbottomcenter
  1. <template>
  2. <u-popup v-model="show" mode="top">
  3. <view>
  4. 人生若只如初见,何事秋风悲画扇
  5. </view>
  6. </u-popup>
  7. </template>

设置弹出层的圆角

可以给border-radius设置一个值来给弹窗增加圆角,单位rpx。

  1. <template>
  2. <u-popup v-model="show" mode="top" border-radius="14">
  3. <view>
  4. 人生若只如初见,何事秋风悲画扇
  5. </view>
  6. </u-popup>
  7. </template>

控制弹窗的宽度 | 高度

这里说的宽度,指的是左边,右边,中部弹出的场景,高度指的是顶部和底部弹出的场景(因为这两个场景宽度都是100%)。
uView提供了length来控制此种情况,此值可以是数值(单位rpx),auto百分比等,内部会自动处理对应的逻辑。 如果为auto的时候,表示弹窗的宽度 | 高度由内容撑开。

  1. <template>
  2. <u-popup v-model="show" mode="top" length="60%">
  3. <view>
  4. 等闲变却故人心,却道故人心易变
  5. </view>
  6. </u-popup>
  7. </template>

API

Props

注意:props中没有控制弹窗打开与收起的参数,因为这是通过v-model绑定变量实现的,见上方说明。

参数说明类型默认值可选值
mode弹出方向Stringlefttop / right / bottom / center
mask是否显示遮罩Booleantruefalse
lengthmode=left | 见上方说明String | Numberauto-
zoom是否开启缩放动画,只在modecenter时有效Booleantruefalse
safe-area-inset-bottom是否开启底部安全区适配Booleanfalsetrue
mask-close-able点击遮罩是否可以关闭弹出层Booleantruefalse
custom-style用户自定义样式Object--
border-radius弹窗圆角值Number | String0-
z-index弹出内容的z-indexNumber | String1075-
closeable是否显示关闭图标Booleanfalsetrue
close-icon关闭图标的名称,只能uView的内置图标Stringclose-
close-icon-pos自定义关闭图标位置,top-left为左上角,top-right为右上角,bottom-left为左下角,bottom-right为右下角Stringtop-righttop-left / bottom-left / bottom-right
close-icon-color关闭图标的颜色String#909399-
close-icon-size关闭图标的大小,单位rpxString | Number30-

Event

事件名说明回调参数版本
open弹出层打开--
close弹出层收起--