tui-bottom-popup 底部弹出层 开源组件

介绍

底部弹出层，可用于商品规格选择，分享弹层等。

引入

uni-app引入

第一种，手动引入（可全局引入）

import tuiBottomPopup from "@/components/thorui/tui-bottom-popup/tui-bottom-popup.vue"
export default {
	components:{
		tuiBottomPopup
	}
}

第二种，开启easycom组件模式，如果不了解如何配置，可先查看 官网文档 (opens new window)。

uni-app版本平台差异说明

App-Nvue	App-vue	H5	微信小程序	支付宝小程序	百度小程序	字节小程序	QQ小程序
升级中	✓	✓	✓	✓	✓	✓	✓

微信小程序引入（可在app.json中全局引入）

{
  "usingComponents": {
    "tui-bottom-popup": "/components/thorui/tui-bottom-popup/tui-bottom-popup"
  }
}

代码演示

部分功能演示，具体可参考示例程序以及文档API。

基础使用

通过 show 属性控制组件显示隐藏， zIndex 属性设置容器 z-index值 ， maskZIndex 属性设置遮罩层z-index值 ，close 为弹层关闭事件。

注：关闭弹层时需监听close事件 将 show 设置为false

<!--uni-app-->
<tui-bottom-popup  :zIndex="1002" :maskZIndex="1001" :show="popupShow" @close="hiddenPopup">
	slot自定义内容
</tui-bottom-popup>

// data 数据 及 方法
//注：关闭弹层时需监听close事件 将 popupShow 设置为false
export default {
	data() {
		return {
			popupShow: false
		}
	},
	methods: {
		//调用此方法显示弹层
		showPopup: function() {
			this.popupShow = true
		},
		hiddenPopup: function() {
			this.popupShow = false
		}
	}
}

<!--微信小程序-->
<tui-bottom-popup  zIndex="{{1002}}" maskZIndex="{{1001}}" show="{{popupShow}}" bindclose="hiddenPopup">
	此处为slot插槽自定义内容
</tui-bottom-popup>

//注：关闭弹层时需监听close事件 将 popupShow 设置为false
Page({
  data: {
	popupShow: false  
  },
  //调用此方法显示弹层
  showPopup: function() {
  	this.setData({
  	  popupShow: true
  	})
  },
  hiddenPopup: function() {
  	this.setData({
  	  popupShow: false
  	})
  }
})

// Make sure to add code blocks to your code group

背景色以及高度设置

通过 backgroundColor 属性设置弹出层的背景色，默认为白色 #fff，通过 height 属性设置弹出层高度，不设置默认'auto'。

<!--uni-app-->
<tui-bottom-popup  backgroundColor="transparent" :height="600" :show="popupShow" @close="hiddenPopup">
	此处为slot插槽自定义内容
</tui-bottom-popup>

// data 数据 及 方法
//注：关闭弹层时需监听close事件 将 popupShow 设置为false
export default {
	data() {
		return {
			popupShow: false
		}
	},
	methods: {
		//调用此方法显示弹层
		showPopup: function() {
			this.popupShow = true
		},
		hiddenPopup: function() {
			this.popupShow = false
		}
	}
}

<!--微信小程序-->
<tui-bottom-popup backgroundColor="transparent" height="{{600}}" show="{{popupShow}}" bindclose="hiddenPopup">
	slot自定义内容
</tui-bottom-popup>

//注：关闭弹层时需监听close事件 将 popupShow 设置为false
Page({
  data: {
	popupShow: false  
  },
  //调用此方法显示弹层
  showPopup: function() {
  	this.setData({
  	  popupShow: true
  	})
  },
  hiddenPopup: function() {
  	this.setData({
  	  popupShow: false
  	})
  }
})

// Make sure to add code blocks to your code group

Slots

插槽名称	插槽说明
default	弹出层中自定义显示内容，内容过多可与scroll-view结合使用

Props

属性名	类型	说明	默认值
mask	Boolean	是否需要mask	true
show	Boolean	控制显示	false
backgroundColor	String	背景颜色	#fff
height	Number	高度 单位rpx	0：表示auto
radius	Boolean	是否设置圆角	true
zIndex	[Number, String]	popup z-index	997
maskZIndex	[Number, String]	mask z-index	996
translateY	String	弹层显示时，垂直方向移动的距离	0
isSafeArea V2.8.0+	Boolean	是否需要判断底部安全区域（主要针对iphonex一类机型）	true

Events

注：uni-app端绑定事件使用@前缀，如@close；微信小程序原生使用bind前缀，如bindclose

事件名	说明	回调参数
close	关闭弹层时触发	{}

预览

特别说明

• 该组件为 开源组件，uni-app版所有用户均可免费使用。
• 微信小程序原生版仅开源至v1.4.2，后续版本需开通会员才可获取使用。

线上程序扫码预览

ThorUI组件库小程序码	H5二维码	ThorUI示例小程序码