365 lines
14 KiB
Vue
365 lines
14 KiB
Vue
<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>
|