What is iScroll? Detailed explanation of iScroll usage examples

The creation of iScroll:

The creation of iScroll is entirely due to the mobile webkit browser, 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 its wrapper The content can be scrolled vertically or horizontally, so 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 show abnormal behavior. Therefore, the recommended DOM structure is as follows:

//overflow:hidden;
 

 //只有第一个DOM结构（ul）被实例化，这个DOM可以纵向或者横向的滚动，
 //多出的内容会被wrapper的样式hidden。
  
1
  
2
  
3
 

Note: Once again, only the first child element (ul) in the wrapper can be instantiated and scrolled, and To achieve scrolling, it must be combined 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:

//overflow:hidden;
 

  //只有第一个DOM结构(ul)被实例化，这个DOM可以纵向或者横向的滚动，
  //多出的内容会被wrapper的样式hidden
  

   
1
   
2
   
3
  
  

   
4
   
5
   
6
  
 

See, only the first will be instantiated. Note: You don’t need to write the ID of the first DOM structure here (first). I just 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 should iScroll be instantiated:

Now that instantiation is mentioned, when should we instantiate it? change? It is said that there are many methods of instantiation, but I have never used them. I will only say one:
(1) Load iscroll.js and uw3c of the current page at the bottom of the HTML (uw3c.html) page (after body and before html) .js, this ensures that the HTML DOM structure can be loaded.
(2) Instantiate iScroll before JS inserts the page DOM structure and data, that is, instantiate it at the beginning of JS, because JS may be used to insert DOM or data later, so as to ensure that iScroll is inserted before data is inserted. Already instantiated.

HTML://HTML structure

 
  ...code...
 
  //插入iscroll.js文件
 
 //插入本页面JS文件
 

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("
pagedata
");

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 The 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, 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 When you touch an event, this method will be useful:

//滚动结束后，执行的方法，滚动后会出现提示框alert("phpcn")
onScrollEnd:function(){
 alert("phpcn");
}

(5) onRefresh: After the DOM structure changes, iScroll needs to be refreshed, otherwise The scrolling plug-in will be instantiated inaccurately, and 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 detailed content of What is iScroll? Detailed explanation of iScroll usage examples. For more information, please follow other related articles on the PHP Chinese website!