el-scroll

A plugin that can makes element scrolling smooth.

Notes | Update | 简体中文

• The parent element of scrolling target, overflow fields must be hidden.

Install

npm i el-scroll  or yarn add el-scroll

Useage

import ElScroll from 'el-scroll'

let scroller = new ElScroll('#J_scroll');

//events
scroller.on('scroll', ({ctx, dist, event})=>{
  console.log('scrolling and scrollY is ', dist);
});

scroller.on('beforeScrollEnd', ({ctx, dist, event})=>{
  console.log('before scrolling stops and scrollY is ', dist);
  //Returns a negative number that determines where the final scrolling stops.
  return dist;
});

scroller.on('scrollEnd', ({ctx, dist, event})=>{
  console.log('scrolling stops and scrollY is ', dist);
});

scroller.on('tap', ({ctx, event})=>{
  console.log('tap event', event);
});

scroller.on('longPress', ({ctx, event})=>{
  console.log('longPress event', event);
});

scroller.on('destroy', ()=>{
  console.log('destroy callback');
});

examples

• examples/index.html

Configuration

• let scroller = new ElScroll(options)
• options(String)

param	type	require	default	desc
options	String	yes	--	scroll target id or class.

• options(HTMLDivElement)

param	type	require	default	desc
options	HTMLDivElement	yes	--	scroll target HTMLDivElement.

• options(Object)

param	type	require	default	desc
options.el	HTMLDivElement	yes	--	scroll target HTMLDivElement.
options.longPressTime	Number	--	350	the interva of long press.
options.stopDefaultEvent	Boolean	--	true	stop browser default events.

• scroller

method	desc
scroller.on('scroll', callback)	scroll event callback.
scroller.on('beforeScrollEnd', callback)	before scrolling stops callback, and you can return a negative number that determines where the final scrolling stops.
scroller.on('scrollEnd', callback)	scrolling stops callback.
scroller.on('tap', callback)	tap callback.
scroller.on('longPress', callback)	long press callback.
scroller.on('destroy', callback)	destroy callback.
scroller.destroy()	plugin destroy.
scroller.resetMaxScrollY()	When the scrolling target height changes, reset the scrollable scrollY.