<template> <view class="mescroll-uni-warp"> <scroll-view :id="viewId" class="mescroll-uni" :class="{'mescroll-uni-fixed':isFixed}" :style="{'height':scrollHeight,'padding-top':padTop,'padding-bottom':padBottom,'padding-bottom':padBottomConstant,'padding-bottom':padBottomEnv,'top':fixedTop,'bottom':fixedBottom,'bottom':fixedBottomConstant,'bottom':fixedBottomEnv}" :scroll-top="scrollTop" :scroll-into-view="scrollToViewId" :scroll-with-animation="scrollAnim" @scroll="scroll" @touchstart="touchstartEvent" @touchmove="touchmoveEvent" @touchend="touchendEvent" @touchcancel="touchendEvent" :scroll-y='isDownReset' :enable-back-to-top="true"> <view class="mescroll-uni-content" :style="{'transform': translateY, 'transition': transition}"> <!-- 下拉加载区域 (支付宝小程序子组件传参给子子组件仍报单项数据流的异常,暂时不通过mescroll-down组件实现)--> <!-- <mescroll-down :option="mescroll.optDown" :type="downLoadType" :rate="downRate"></mescroll-down> --> <view v-if="mescroll.optDown.use" class="mescroll-downwarp" :style="{'background-color':mescroll.optDown.bgColor,'color':mescroll.optDown.textColor}"> <view class="downwarp-content"> <view class="downwarp-progress" :class="{'mescroll-rotate': isDownLoading}" :style="{'border-color':mescroll.optDown.textColor, 'transform': downRotate}"></view> <view class="downwarp-tip">{{downText}}</view> </view> </view> <!-- 列表内容 --> <slot></slot> <!-- 空布局 --> <mescroll-empty v-if="isShowEmpty" :option="mescroll.optUp.empty" @emptyclick="emptyClick"></mescroll-empty> <!-- 上拉加载区域 (下拉刷新时不显示, 支付宝小程序子组件传参给子子组件仍报单项数据流的异常,暂时不通过mescroll-up组件实现)--> <!-- <mescroll-up v-if="mescroll.optUp.use && !isDownLoading" :option="mescroll.optUp" :type="upLoadType"></mescroll-up> --> <view v-if="mescroll.optUp.use && !isDownLoading" class="mescroll-upwarp" :style="{'background-color':mescroll.optUp.bgColor,'color':mescroll.optUp.textColor}"> <!-- 加载中 (此处不能用v-if,否则android小程序快速上拉可能会不断触发上拉回调) --> <view v-show="upLoadType===1"> <view class="upwarp-progress mescroll-rotate" :style="{'border-color':mescroll.optUp.textColor}"></view> <view class="upwarp-tip">{{ mescroll.optUp.textLoading }}</view> </view> <!-- 无数据 --> <view v-if="upLoadType===2" class="upwarp-nodata">{{ mescroll.optUp.textNoMore }}</view> </view> </view> </scroll-view> <!-- 回到顶部按钮 (fixed元素,需写在scroll-view外面,防止滚动的时候抖动)--> <mescroll-top v-model="isShowToTop" :option="mescroll.optUp.toTop" @click="toTopClick"></mescroll-top> </view> </template> <script> // 引入mescroll-uni.js,处理核心逻辑 import MeScroll from './mescroll-uni.js'; // 引入全局配置 import GlobalOption from './mescroll-uni-option.js'; // 引入空布局组件 import MescrollEmpty from './components/mescroll-empty.vue'; // 引入回到顶部组件 import MescrollTop from './components/mescroll-top.vue'; export default { components: { MescrollEmpty, MescrollTop }, data() { return { mescroll: {optDown:{},optUp:{}}, // mescroll实例 viewId: 'id_' + Math.random().toString(36).substr(2), // 随机生成mescroll的id(不能数字开头,否则找不到元素) downHight: 0, //下拉刷新: 容器高度 downRate: 0, // 下拉比率(inOffset: rate<1; outOffset: rate>=1) downLoadType: 4, // 下拉刷新状态 (inOffset:1, outOffset:2, showLoading:3, endDownScroll:4) upLoadType: 0, // 上拉加载状态:0(loading前),1(loading中),2(没有更多了) isShowEmpty: false, // 是否显示空布局 isShowToTop: false, // 是否显示回到顶部按钮 scrollTop: 0, // 滚动条的位置 scrollAnim: false, // 是否开启滚动动画 windowTop: 0, // 可使用窗口的顶部位置 windowBottom: 0, // 可使用窗口的底部位置 windowHeight: 0, // 可使用窗口的高度 statusBarHeight: 0, // 状态栏高度 isSafearea: false, // 支持安全区 scrollToViewId: '' // 滚动到指定view的id } }, props: { down: Object, // 下拉刷新的参数配置 up: Object, // 上拉加载的参数配置 top: [String, Number], // 下拉布局往下的偏移量 (支持20, "20rpx", "20px", "20%"格式的值, 其中纯数字则默认单位rpx, 百分比则相对于windowHeight) topbar: Boolean, // top的偏移量是否加上状态栏高度, 默认false (使用场景:取消原生导航栏时,配置此项可自动加上状态栏高度的偏移量) bottom: [String, Number], // 上拉布局往上的偏移量 (支持20, "20rpx", "20px", "20%"格式的值, 其中纯数字则默认单位rpx, 百分比则相对于windowHeight) safearea: Boolean, // bottom的偏移量是否加上底部安全区的距离, 默认false (需要适配iPhoneX时使用) fixed: { // 是否通过fixed固定mescroll的高度, 默认true type: Boolean, default () { return true } }, height: [String, Number] // 指定mescroll的高度, 此项有值,则不使用fixed. (支持20, "20rpx", "20px", "20%"格式的值, 其中纯数字则默认单位rpx, 百分比则相对于windowHeight) }, computed: { // 是否使用fixed定位 (当height有值,则不使用) isFixed(){ return !this.height && this.fixed }, // mescroll的高度 scrollHeight(){ if (this.isFixed) { return "auto" } else if(this.height){ return this.toPx(this.height) + 'px' }else{ return "100%" } }, // 下拉布局往下偏移的距离 (px) numTop() { return this.toPx(this.top) + (this.topbar ? this.statusBarHeight : 0) }, fixedTop() { return this.isFixed ? (this.numTop + this.windowTop) + 'px' : 0 }, padTop() { return !this.isFixed ? this.numTop + 'px' : 0 }, // 上拉布局往上偏移 (px) numBottom() { return this.toPx(this.bottom) }, fixedBottom() { return this.isFixed ? (this.numBottom + this.windowBottom) + 'px' : 0 }, fixedBottomConstant(){ return this.isSafearea ? "calc("+this.fixedBottom+" + constant(safe-area-inset-bottom))" : this.fixedBottom }, fixedBottomEnv(){ return this.isSafearea ? "calc("+this.fixedBottom+" + env(safe-area-inset-bottom))" : this.fixedBottom }, padBottom() { return !this.isFixed ? this.numBottom + 'px' : 0 }, padBottomConstant(){ return this.isSafearea ? "calc("+this.padBottom+" + constant(safe-area-inset-bottom))" : this.padBottom }, padBottomEnv(){ return this.isSafearea ? "calc("+this.padBottom+" + env(safe-area-inset-bottom))" : this.padBottom }, // 是否为重置下拉的状态 isDownReset(){ return this.downLoadType===3 || this.downLoadType===4 }, // 过渡 transition() { return this.isDownReset ? 'transform 300ms' : ''; }, translateY() { return this.downHight > 0 ? 'translateY(' + this.downHight + 'px)' : ''; // transform会使fixed失效,需注意把fixed元素写在mescroll之外 }, // 是否在加载中 isDownLoading(){ return this.downLoadType === 3 }, // 旋转的角度 downRotate(){ return 'rotate(' + 360 * this.downRate + 'deg)' }, // 文本提示 downText(){ switch (this.downLoadType){ case 1: return this.mescroll.optDown.textInOffset; case 2: return this.mescroll.optDown.textOutOffset; case 3: return this.mescroll.optDown.textLoading; case 4: return this.mescroll.optDown.textLoading; default: return this.mescroll.optDown.textInOffset; } } }, methods: { //number,rpx,upx,px,% --> px的数值 toPx(num){ if(typeof num === "string"){ if (num.indexOf('px') !== -1) { if(num.indexOf('rpx') !== -1) { // "10rpx" num = num.replace('rpx', ''); } else if(num.indexOf('upx') !== -1) { // "10upx" num = num.replace('upx', ''); } else { // "10px" return Number(num.replace('px', '')) } }else if (num.indexOf('%') !== -1){ // 传百分比,则相对于windowHeight,传"10%"则等于windowHeight的10% let rate = Number(num.replace("%","")) / 100 return this.windowHeight * rate } } return num ? uni.upx2px(Number(num)) : 0 }, //注册列表滚动事件,用于下拉刷新和上拉加载 scroll(e) { this.mescroll.scroll(e.detail, () => { this.$emit('scroll', this.mescroll) // 此时可直接通过 this.mescroll.scrollTop获取滚动条位置; this.mescroll.isScrollUp获取是否向上滑动 }) }, //注册列表touchstart事件,用于下拉刷新 touchstartEvent(e) { this.mescroll.touchstartEvent(e); }, //注册列表touchmove事件,用于下拉刷新 touchmoveEvent(e) { this.mescroll.touchmoveEvent(e); }, //注册列表touchend事件,用于下拉刷新 touchendEvent(e) { this.mescroll.touchendEvent(e); }, // 点击空布局的按钮回调 emptyClick() { this.$emit('emptyclick', this.mescroll) }, // 点击回到顶部的按钮回调 toTopClick() { this.mescroll.scrollTo(0, this.mescroll.optUp.toTop.duration); // 执行回到顶部 this.$emit('topclick', this.mescroll); // 派发点击回到顶部按钮的回调 }, // 更新滚动区域的高度 (使内容不满屏和到底,都可继续翻页) setClientHeight() { if (this.mescroll.getClientHeight(true) === 0 && !this.isExec) { this.isExec = true; // 避免多次获取 this.$nextTick(() => { // 确保dom已渲染 let view = uni.createSelectorQuery().in(this).select('#' + this.viewId); view.boundingClientRect(data => { this.isExec = false; if (data) { this.mescroll.setClientHeight(data.height); } else if (this.clientNum != 3) { // 极少部分情况,可能dom还未渲染完毕,递归获取,最多重试3次 this.clientNum = this.clientNum == null ? 1 : this.clientNum + 1; setTimeout(() => { this.setClientHeight() }, this.clientNum * 100) } }).exec(); }) } } }, // 使用created初始化mescroll对象; 如果用mounted部分css样式编译到H5会失效 created() { let vm = this; let diyOption = { // 下拉刷新的配置 down: { inOffset(mescroll) { vm.downLoadType = 1; // 下拉的距离进入offset范围内那一刻的回调 (自定义mescroll组件时,此行不可删) }, outOffset(mescroll) { vm.downLoadType = 2; // 下拉的距离大于offset那一刻的回调 (自定义mescroll组件时,此行不可删) }, onMoving(mescroll, rate, downHight) { // 下拉过程中的回调,滑动过程一直在执行; vm.downHight = downHight; // 设置下拉区域的高度 (自定义mescroll组件时,此行不可删) vm.downRate = rate; //下拉比率 (inOffset: rate<1; outOffset: rate>=1) }, showLoading(mescroll, downHight) { vm.downLoadType = 3; // 显示下拉刷新进度的回调 (自定义mescroll组件时,此行不可删) vm.downHight = downHight; // 设置下拉区域的高度 (自定义mescroll组件时,此行不可删) }, endDownScroll(mescroll) { vm.downLoadType = 4; // 结束下拉 (自定义mescroll组件时,此行不可删) vm.downHight = 0; // 设置下拉区域的高度 (自定义mescroll组件时,此行不可删) }, // 派发下拉刷新的回调 callback: function(mescroll) { vm.$emit('down', mescroll) } }, // 上拉加载的配置 up: { // 显示加载中的回调 showLoading() { vm.upLoadType = 1; }, // 显示无更多数据的回调 showNoMore() { vm.upLoadType = 2; }, // 隐藏上拉加载的回调 hideUpScroll() { vm.upLoadType = 0; }, // 空布局 empty: { onShow(isShow) { // 显示隐藏的回调 vm.isShowEmpty = isShow; } }, // 回到顶部 toTop: { onShow(isShow) { // 显示隐藏的回调 vm.isShowToTop = isShow; } }, // 派发上拉加载的回调 callback: function(mescroll) { vm.$emit('up', mescroll); // 更新容器的高度 (多mescroll的情况) vm.setClientHeight() } } } MeScroll.extend(diyOption, GlobalOption); // 混入全局的配置 let myOption = JSON.parse(JSON.stringify({ 'down': vm.down, 'up': vm.up })) // 深拷贝,避免对props的影响 MeScroll.extend(myOption, diyOption); // 混入具体界面的配置 // 初始化MeScroll对象 vm.mescroll = new MeScroll(myOption); vm.mescroll.viewId = vm.viewId; // 附带id // init回调mescroll对象 vm.$emit('init', vm.mescroll); // 设置高度 const sys = uni.getSystemInfoSync(); if(sys.windowTop) vm.windowTop = sys.windowTop; if(sys.windowBottom) vm.windowBottom = sys.windowBottom; if(sys.windowHeight) vm.windowHeight = sys.windowHeight; if(sys.statusBarHeight) vm.statusBarHeight = sys.statusBarHeight; // 使down的bottomOffset生效 vm.mescroll.setBodyHeight(sys.windowHeight); // 因为使用的是scrollview,这里需自定义scrollTo vm.mescroll.resetScrollTo((y, t) => { vm.scrollAnim = (t !== 0); // t为0,则不使用动画过渡 if(typeof y === 'string'){ // 第一个参数如果为字符串,则使用scroll-into-view vm.scrollToViewId = y; return; } let curY = vm.mescroll.getScrollTop() if (t === 0 || t === 300) { // 当t使用默认配置的300时,则使用系统自带的动画过渡 vm.scrollTop = curY; vm.$nextTick(function() { vm.scrollTop = y }) } else { vm.mescroll.getStep(curY, y, step => { // 此写法可支持配置t vm.scrollTop = step }, t) } }) // 具体的界面如果不配置up.toTop.safearea,则取本vue的safearea值 if(sys.platform == "ios"){ vm.isSafearea = vm.safearea; if (vm.up && vm.up.toTop && vm.up.toTop.safearea != null) {} else { vm.mescroll.optUp.toTop.safearea = vm.safearea; } }else{ vm.isSafearea = false vm.mescroll.optUp.toTop.safearea = false } }, mounted() { // 设置容器的高度 this.setClientHeight() } } </script> <style> @import "./mescroll-uni.css"; @import "./components/mescroll-down.css"; @import './components/mescroll-up.css'; </style>