better-scroll1.15.2 • Public • Published
What is better-scroll ?
better-scroll is a plugin which is aimed at solving scrolling circumstances on the mobile side (PC supported already). The core is inspired by the implementation of iscroll, so the APIs of better-scroll are compatible with iscroll on the whole. What's more, better-scroll also extends some features and optimizes for performance based on iscroll.
The most common application scenario of better-scroll is list scrolling. Let's see its HTML:
.........<!-- you can put some other DOMs here, it won't affect the scrolling -->
In the code above, better-scroll is applied to the outer
wrapper container, and the scrolling part is
content element. Pay attention that better-scroll only handles the scroll of the first child element (content) of the container (
wrapper), which means other elements will be ignored.
The simplest initialization code is as follow:
const wrapper = documentconst scroll = wrapper
better-scroll provides a class whose first parameter is a plain DOM object when instantiated. Certainly, better-scroll inside would try to use querySelector to get the DOM object, so the initiazation code can also be like the following:
const scroll = '.wrapper'
The core of scrolling
Many developers have used better-scroll, but the most common problem they have met is:
I have initiated better-scroll, but the content can't scroll.
The phenomenon is 'the content can't scroll' and we need to figure out the root cause. Before that, let's take a look at the browser's scrolling principle: everyone can see the browser's scroll bar. When the height of the page content exceeds the viewport height, the vertical scroll bar will appear; When the width of page content exceeds the viewport width, the horizontal bar will appear. That is to say, when the viewport can't display all the content, the browser would guide the user to scroll the screen with scroll bar to see the rest of content.
The principle of better-scroll is samed as the browser. We can feel about this more obviously using a picture:
The green part is the wrapper, also known as the parent container, which has fixed height. The yellow part is the content, which is the first child element of the parent container and whose height would grow with the size of its content. Then, when the height of the content doesn't exceed the height of the parent container, the content would not scroll. Once exceeded, the content can be scrolled. That is the principle of better-scroll.
Using better-scroll with MVVM frameworks
I wrote an article When better-scroll meets Vue (in Chinese). I also hope that developers can contribute to share the experience of using better-scroll with other frameworks.
A fantastic mobile ui lib implement by Vue: cube-ui
Using better-scroll in the real project
If you want to learn how to use better-scroll in the real project，you can learn my two practical courses(in Chinese)。
Visit better-scroll document
Type declaration(since 1.13.0+)
npm i @types/better-scroll -D
Or scan QR Code：
Detailed changes for each release are documented in the release notes.