better-scroll
官网 https://better-scroll.github.io/docs/zh-CN/guide/base-scroll-api.html#属性
如果想要彻底了解 BetterScroll,就需要了解其实例的常用属性、灵活的方法以及提供的事件与钩子。
BetterScroll 托管在 NPM 上,执行如下命令安装:
npm install @better-scroll/core —save // or yarn add @better-scroll/core
接下来就可以在代码中引入了,webpack(opens new window)等构建工具都支持从 node_modules 里引入代码:
import BScroll from ‘@better-scroll/core’
如果是 commonjs 的语法,如下:
var BScroll = require(‘@better-scroll/scroll’)
1.案例
2.注意事项
任何时候如果出现无法滚动的情况,都应该首先查看 content 元素高度/宽度是否大于 wrapper 的高度/宽度。这是内容能够滚动的前提条件。
如果内容存在图片的情况,可能会出现 DOM 元素渲染时图片还未下载,因此内容元素的高度小于预期,出现滚动不正常的情况。此时你应该在图片加载完成后,比如 onload 事件回调中,调用 bs.refresh 方法,它会重新计算最新的滚动距离。属性
有时候我们想基于 BetterScroll 做一些扩展,需要对 BetterScroll 的一些属性有所了解,下面介绍几个常用属性。
x
类型:number
作用:bs 横轴坐标。
y
类型:number
作用:bs 纵轴坐标。
maxScrollX
类型:number
作用:bs 最大横向滚动位置。
备注:bs 横向滚动的位置区间是 [minScrollX, maxScrollX],并且 maxScrollX 是负值。
minScrollX
类型:number
作用:bs 最小横向滚动位置。
备注:bs 横向滚动的位置区间是 [minScrollX, maxScrollX],并且 minScrollX 是正值。
maxScrollY
类型:number
作用:bs 最大纵向滚动位置。
备注:bs 纵向滚动的位置区间是 [minScrollY, maxScrollY],并且 maxScrollY 是负值。
minScrollY
类型:number
作用:bs 最小纵向滚动位置。
备注:bs 纵向滚动的位置区间是 [minScrollY, maxScrollY],并且 minScrollY 是正值。
movingDirectionX
类型:number
作用:判断 bs 滑动过程中的方向(左右)。
备注:-1 表示手指从左向右滑,1 表示从右向左滑,0 表示没有滑动。
movingDirectionY
类型:number
作用:判断 bs 滑动过程中的方向(上下)。
备注:-1 表示手指从上往下滑,1 表示从下往上滑,0 表示没有滑动。
directionX
类型:number
作用:判断 bs 滑动结束后相对于开始滑动位置的方向(左右)。
备注:-1 表示手指从左向右滑,1 表示从右向左滑,0 表示没有滑动。
directionY
类型:number
作用:判断 bs 滑动结束后相对于开始滑动位置的方向(上下)。
备注:-1 表示手指从上往下滑,1 表示从下往上滑,0 表示没有滑动。
enabled
类型:boolean,
作用:判断当前 bs 是否处于启用状态,不再响应手指的操作。
pending
类型:boolean,
作用:判断当前 bs 是否处于滚动动画过程中。