Home > Article > Web Front-end > Learn to use jquery iScroll.js mobile scroll bar plug-in_jquery
What is the most commonly used plug-in in your daily work, jQurey? Lazyload? But these are all on the PC side, but the most commonly used plug-in on the mobile side is iScroll. What exactly is iScroll and how should it be used? iScroll is a very powerful plug-in, and I only have a superficial understanding of it. Here we will briefly introduce it.
Generation of iScroll:
iScroll was created entirely because of mobile webkit browsers, such as on iPhone and Android mobile devices.
How to use iScroll:
The principle of iScroll is that there is an overflow hidden (overflow:hidden;) DOM in the outer layer, and then the first DOM structure in this area will be instantiated, and the wrapped content can be scrolled vertically or horizontally, so in When using iScroll, the scrolling elements should be as simple as possible, reduce the number of DOMs, and reduce nesting, because the more complex the DOM structure is, the more difficult it will be for iScroll to run, which may cause some nodes to display abnormally. Therefore, the recommended DOM structure is as follows:
<div id="wrapper">//overflow:hidden; <ul> //只有第一个DOM结构(ul)被实例化,这个DOM可以纵向或者横向的滚动, //多出的内容会被wrapper的样式hidden。 <li>1</li> <li>2</li> <li>3</li> </ul> </div>
Note: Again, only the first child element (ul) in the wrapper can be instantiated for scrolling, and scrolling must be achieved in conjunction with the outer DOM (wrapper).
What if there are multiple uls in the wrapper? It's very simple. Remember that sentence, only the first child element (ul) in the wrapper can be instantiated and scrolled:
<div id="wrapper">//overflow:hidden; <div id="first"> //只有第一个DOM结构(ul)被实例化,这个DOM可以纵向或者横向的滚动, //多出的内容会被wrapper的样式hidden <ul> <li>1</li> <li>2</li> <li>3</li> </ul> <ul> <li>4</li> <li>5</li> <li>6</li> </ul> </div> </div>
As you can see, only first will be instantiated. Note: The ID of the first DOM structure (first) does not need to be written here. I only wrote an ID to facilitate everyone's identification, but the outermost ID (wrapper) must be written because it is needed when JS is instantiated. Fill in this ID:
var myScroll = new iScroll("wrapper");
How iScroll should be instantiated:
Since we talked about instantiation, when should we instantiate it? It is said that there are many methods of instantiation, but I have never used it. I will only mention one:
(1) Load iscroll.js and uw3c.js of the current page at the bottom of the HTML (uw3c.html) page (after body and before html) to ensure that the DOM structure of HTML can be loaded.
(2) Instantiate iScroll before JS inserts the page DOM structure and data, that is, instantiate it at the very beginning of JS, because JS may be used to insert DOM or data later. This ensures that iScroll has been instantiated before inserting data. .
HTML://HTML structure
<html > <body> ...code... </body> //插入iscroll.js文件 <script type="text/javascript" src="js/iscroll.js" > </script > //插入本页面JS文件 <script type="text/javascript" src="js/uw3c.js" > </script > </html>
JS://JS file content
var myscroll; function iscroll(data){ //实例化iScroll myscroll=new iScroll("wrapper"); pageData(data); } function pageData(obj){ $("body").html(obj); myscroll.refresh();//当DOM结构发生变化的时候,需要刷新iScroll } iscroll("<div>pagedata</div>");
Parameters in iScroll:
When instantiating iScroll, you can pass in two parameters. The first parameter is the ID of the instantiated outer DOM, and the second parameter is the object of the iScroll execution method:
var myscroll=new iScroll("wrapper",{hScrollbar:false}); 或者 var opts = { vScroll:false,//禁止垂直滚动 snap:true,//执行传送带效果 hScrollbar:false//隐藏水平方向上的滚动条 }; var myscroll = new iScroll("wrapper",opts);
The content of the second parameter is as follows. This parameter will control the effect of iScroll:
hScroll false 禁止横向滚动 true横向滚动 默认为true vScroll false 禁止垂直滚动 true垂直滚动 默认为true hScrollbar false隐藏水平方向上的滚动条 vScrollbar false 隐藏垂直方向上的滚动条 fadeScrollbar false 指定在无渐隐效果时隐藏滚动条 hideScrollbar 在没有用户交互时隐藏滚动条 默认为true bounce 启用或禁用边界的反弹,默认为true momentum 启用或禁用惯性,默认为true,此参数在你想要保存资源的时候非常有用 lockDirection false取消拖动方向的锁定,true拖动只能在一个方向上(up/down 或者left/right)
Methods in iScroll:
Of course, in the second parameter, there are also some methods that can be executed:
(1)scrollTo(x, y, time, relative) method: Pass in 4 parameters: X-axis scrolling distance, Y-axis scrolling distance, effect time, and whether it is relative to the current position. So for example:
//在200毫秒的时间内,Y轴向上滚动100像素; uw3c.scrollTo(0, -100, 200) //在200毫秒的时间内,相对于当前位置,X轴向左滚动100像素; uw3c.scrollTo(-100, 0, 200, true)
(2)refresh() method: After the DOM structure changes, iScroll needs to be refreshed, otherwise the scrolling plug-in will be instantiated inaccurately:
uw3c.refresh();//刷新iScroll
(3)onPosChange, is there a method that can return the change of position? You can check if there is an onPosChange method in the iScroll you are using:
onPosChange:function(x,y){ if(y < -200){ //如果Y周向上滚动200像素,$("#uw3c")就显示,否则就隐藏。 $("#uw3c").show(); }else{ $("#uw3c").hide(); } }
(4) onScrollEnd: event executed when the scroll ends. If you want to trigger an event when the scroll ends, this method will be useful:
//滚动结束后,执行的方法,滚动后会出现提示框alert("uw3c.com") onScrollEnd:function(){ alert("uw3c.com"); }
(5) onRefresh: After the DOM structure changes, iScroll needs to be refreshed, otherwise the scrolling plug-in will be instantiated inaccurately. onRefresh is the method that will be executed after iScroll is refreshed.
(6) onBeforeScrollStart: The time callback before starting scrolling. The default is to prevent the browser's default behavior.
(7) onScrollStart: callback to start scrolling.
(8) onBeforeScrollMove: Callback before content moves.
(9) onScrollMove: callback for content movement.
(10) onBeforeScrollEnd: callback before the end of scrolling.
(11) onTouchEnd: callback after the hand leaves the screen.
(12) onDestroy: callback to destroy the instance.
The above is the entire content of this article. I hope it will help everyone to use the iScroll.js mobile scroll bar plug-in proficiently.