ionic-JS:Scroll（滚动）

ion-scroll

授权: $ionicScrollDelegate

创建一个包含所有内容的可滚动容器。

用法

...

API

属性	类型	详情
delegate-handle(可选)	字符串	该句柄利用$ionicScrollDelegate指定滚动视图。
direction(可选)	字符串	滚动的方向。 'x' 或 'y'。默认 'y'。
paging(可选)	布尔值	分页是否滚动。
on-refresh(可选)	表达式	调用下拉刷新，由ionRefresher触发。
on-scroll(可选)	表达式	当用户滚动时触发。
scrollbar-x(可选)	布尔值	是否显示水平滚动条。默认为false。
scrollbar-y(可选)	布尔值	是否显示垂直滚动条。默认为true。
zooming(可选)	布尔值	是否支持双指缩放。
min-zoom(可选)	整数	允许的最小缩放量（默认为0.5）
max-zoom(可选)	整数	允许的最大缩放量（默认为3）

ion-infinite-scroll

隶属于ionContent 或 ionScroll

当用户到达页脚或页脚附近时，ionInfiniteScroll指令允许你调用一个函数。
当用户滚动的距离超出底部的内容时，就会触发你指定的on-infinite。

用法

function MyController($scope, $http) { 
  $scope.items = []; 
  $scope.loadMore = function() { 
    $http.get('/more-items').success(function(items) { 
      useItems(items); 
      $scope.$broadcast('scroll.infiniteScrollComplete');
    }); 
  }; 

  $scope.$on('stateChangeSuccess', function() { 
    $scope.loadMore(); 
  });
}

当没有更多数据加载时，就可以用一个简单的方法阻止无限滚动，那就是angular的ng-if 指令:

API

属性	类型	详情
on-infinite	表达式	当滚动到底部时触发的时间。
distance(可选)	字符串	从底部滚动到触发on-infinite表达式的距离。默认: 1%。
icon(可选)	字符串	当加载时显示的图标。默认: 'ion-loading-d'。

$ionicScrollDelegate

授权控制滚动视图（通过ionContent
和 ionScroll
指令创建）。
该方法直接被$ionicScrollDelegate服务触发，来控制所有滚动视图。用 $getByHandle方法控制特定的滚动视图。

用法

function MainCtrl($scope, $ionicScrollDelegate) { 
  $scope.scrollTop = function() { 
    $ionicScrollDelegate.scrollTop(); 
  };
}

高级用法的例子，用带有两个滚动区域的delegate-handle来特殊控制。

function MainCtrl($scope, $ionicScrollDelegate) { 
  $scope.scrollMainToTop = function() { 
    $ionicScrollDelegate.$getByHandle('mainScroll').scrollTop(); 
  }; 
  $scope.scrollSmallToTop = function() { 
    $ionicScrollDelegate.$getByHandle('small').scrollTop(); 
  };
}

方法
resize()
告诉滚动视图重新计算它的容器大小。

scrollTop([shouldAnimate])

参数	类型	详情
shouldAnimate(可选)	布尔值	是否应用滚动动画。

scrollBottom([shouldAnimate])

参数	类型	详情
shouldAnimate(可选)	布尔值	是否应用滚动动画。

scrollTo(left, top, [shouldAnimate])

参数	类型	详情
left	数值	水平滚动的值。
top	数值	垂直滚动的值。
shouldAnimate(可选)	布尔值	是否应用滚动动画。

scrollBy(left, top, [shouldAnimate])

参数	类型	详情
left	数值	水平滚动的偏移量。
top	数值	垂直滚动的偏移量。
shouldAnimate(可选)	布尔值	是否应用滚动动画。

getScrollPosition()

返回: 对象滚动到该视图的位置，具有一下属性：

{数值} left 从左侧到用户已滚动的距离(开始为 0)。
{数值} top 从顶部到用户已滚动的距离 (开始为 0)。

anchorScroll([shouldAnimate])

告诉滚动视图用一个带有id的滚动元素匹配window.location.hash。
如果没有匹配到元素，它会滚动到顶部。

参数	类型	详情
shouldAnimate(可选)	布尔值	是否应用滚动动画。

getScrollView()

返回: 对象匹配具有授权的滚动视图。

rememberScrollPosition(id)

当滚动视图被销毁时（用户离开页面），页面最后的滚动位置会被指定的索引保存。
注意：根据一个ion-nav-view将页面和一个视图关联，rememberScrollPosition自动保存它们的滚动。
相关方法：scrollToRememberedPosition, forgetScrollPosition (低)。
在下面的例子中，ion-scroll元素的滚动位置会被保留，甚至当用户切换开关时。


 
   
     
      {{i}}

function ScrollCtrl($scope, $ionicScrollDelegate) { 
  var delegate = $ionicScrollDelegate.$getByHandle('myScroll'); 

  // 这里可以放任何唯一的ID。重点是：要在每次重新创建控制器时 
  // 我们要加载当前记住的滚动值。 
  delegate.rememberScrollPosition('my-scroll-id'); 
  delegate.scrollToRememberedPosition(); 
  $scope.items = [];
   for (var i=0; i<100; i++) { 
    $scope.items.push(i); 
  }
}

参数	类型	详情
id	字符串	保留已滚动位置的滚动视图的id。

forgetScrollPosition()

停止保存这个滚动视图的滚动位置。

scrollToRememberedPosition([shouldAnimate])

如果这个滚动视图有个和它的滚动位置关联的id（通过调用rememberScrollPosition方法），然后记住那个位置，加载那个位置然后滚动到那个位置。

参数	类型	详情
shouldAnimate(可选)	布尔值	是否应用滚动动画。

$getByHandle(handle)

参数	类型	详情
handle	字符串

返回: delegateInstance一个代表性实例就是只控制带有delegate-handle
的滚动视图来匹配给定的句柄。

例如: $ionicScrollDelegate.$getByHandle('my-handle').scrollTop();