寫在前面
由於最近一個移動端項目中許多地方有滾動需求, 橫向,縱向的都有,所以就基於better-scroll封裝了一個通用的滾動組件,期間也踩了一些坑,有時候會滾動失效,初始化的時候就不能滾動等等...
better-scroll地址: https://ustbhuangyi.github.io...
滾動組件代碼
<template>
<div ref="wrapper">
<slot></slot>
</div>
</template>
<script>
import BScroll from "better-scroll";
export default {
props: {
probeType: {
type: Number, // 非實時派發scroll事件, 類型由0,1,2,3
default: 1
},
scrollX: {
type: Boolean, // 是否橫向滾動
default: false
},
scrollY: {
type: Boolean, // 是否縱向滾動
default: true
},
click: {
type: Boolean, // 是否派發點擊事件
default: true
},
listenScroll: {
type: Boolean, // 監聽滾動
default: false
},
data: {
type: Array, // 組件數據,可用於重新刷新scroll組件
default: null
},
pullup: {
type: Boolean, // 上拉加載更多,請求接口
default: false
},
beforeScroll: {
type: Boolean, // 滾動之前做些什麼
default: false
},
refreshDelay: {
type: Number, // scroll刷新時間
default: 20
}
},
mounted() {
// 也可以使用nextTick來初始化
setTimeout(() => {
this.initScroll();
}, 20);
},
methods: {
// 初始化
initScroll() {
if (!this.$refs.wrapper) {
return;
}
// 根據自己的需求傳入配置項
this.scroll = new BScroll(this.$refs.wrapper, {
probeType: this.probeType,
click: this.click,
scrollX: this.scrollX
});
if (this.listenScroll) {
let me = this;
this.scroll.on("scroll", pos => {
me.$emit("scroll", pos);
});
}
if (this.pullup) {
this.scroll.on("scrollEnd", () => {
if (this.scroll.y <= this.scroll.maxScrollY + 50) {
this.$emit("scrollToEnd");
}
});
}
if (this.beforeScroll) {
this.scroll.on("beforeScrollStart", () => {
this.$emit("beforeScroll");
});
}
},
disable() {
this.scroll && this.scroll.disable();
},
enable() {
this.scroll && this.scroll.enable();
},
refresh() {
this.scroll && this.scroll.refresh();
},
scrollTo() {
this.scroll && this.scroll.scrollTo.apply(this.scroll, arguments);
},
scrollToElement() {
this.scroll && this.scroll.scrollToElement.apply(this.scroll, arguments);
}
},
watch: {
// 這個可以設置data來刷新scroll組件
data() {
setTimeout(() => {
this.refresh();
}, this.refreshDelay);
}
}
};
</script>
<style lang="less" scoped>
</style>
當然, 我們還可以添加更多的配置功能, 這個需要依據你自己的需求來了,詳情配置去better-scroll官網看看
使用scroll組件
縱向滾動
<scroll ref="scroll" class="main-content" :data="data">
<div>
添加需要滾動的DOM元素: 如ul>li等, 或者多個子組件
</div>
</scroll>
// 下面是樣式
.main {
width: 100%;
height: calc(100vh - 52px);
background-color: #f7f8fa;
.main-content {
height: 100%;
overflow: hidden;
position: relative;
}
}
縱向滾動主要是要注意的是: scroll下的第一個子元素,它的高度需要讓內容來撐開!!! 否則無法滾動
圖片中已經標識出來了...
橫向滾動
<template>
<div class="app-list-wrapper">
<scroll :scrollX="true" :scrollY="false" ref="scroll" class="icon-content">
<div class="icons">
<div v-for="i in 8" :key="i" class="icon">
<appIcon style="margin-right: 16px"></appIcon>
</div>
</div>
</scroll>
</div>
</template>
// 樣式
<style lang="less" scoped>
.app-list-wrapper {
width: 100%;
.icon-content {
// scroll容器
width: 100%;
overflow: hidden;
.icons {
// 注意scroll容器下的第一個元素
padding-left: 20px;
display: inline-block;
white-space: nowrap;
// 子元素樣式
.icon {
display: inline-block;
}
}
}
}
</style>
橫向滾動下我們傳入配置值就行了; 這裏主要是注意樣式的書寫! 也就是scroll下的第一個子元素的寬度要由內容撐寬纔可以...,代碼塊中也標註出來了.
踩過的坑點
- 純靜態頁面的滾動
舉個栗子,我現在寫了一個彈出層,就是靜態數據渲染,但是需求也需要滾動,因爲單頁可能顯示不下, 雖說better-scroll的原理是第一個子元素超出父盒子就可以實現滾動了, 彈出層只有在點擊彈窗的時候纔會渲染,所以是無法滾動的, 在彈窗出來後再手動刷新scroll組件; 這裏我們就可以通過那個data屬性搞事情了,每次點擊彈窗後,往data中丟個數據,這樣會觸發scroll組件的watch, 然後手動刷新,就可以實現滾動了...
// 部分代碼示例
<t-aside :data="onOff"></t-aside> // 側邊欄彈出層組件
methods: {
showPopup() {
this.onOff.push('1'), // 刷新scroll組件
this.$refs.aside.show();
}
}
-
scroll容器數據變化導致無法正常滾動, 可能情況是:
- 初始化的時候就有問題,去檢查一下第一個子元素高度||寬度是否是由其子元素撐開的
接口數據還未請求回來就初始化了, 比如圖片,此時初始化就沒算上圖片的高度,
這時候就需要手動調用this.$refs.scroll.refresh()來刷新scroll組件, 矯正滾動高度
3.其他坑點待發現...歡迎大佬一起交流