DCloud-MUI：下拉刷新、上拉加载

ylbtech-DCloud-MUI：下拉刷新、上拉加载

1. 下拉刷新返回顶部

0、

http://dev.dcloud.net.cn/mui/pulldown/

1、

概述

为实现下拉刷新功能，大多数 H5 框架都是通过 DIV 模拟下拉回弹动画，在低端 android 手机上，DIV 动画经常出现卡顿现象（特别是图文列表的情况); mui 通过使用原生 webview 下拉刷新解决这个 DIV 动画的卡顿问题，并且拖动效果更加流畅；

这里提供两种模式的下拉刷新，以适用不同场景：

单 webview 模式

• 效果展示：

  

• 动画原理：

  下拉刷新时，触发的是原生下拉刷新控件，而整个webview位置不会发生变化，所以不会在拖动过程中发生DOM重绘，当控件拖动到一定位置触发动态加载数据以及刷新操作。此模式下拉刷新，相比双webview 模式，不创建额外 webview，性能更优。

• 使用方法：

  mui 初始化时设置pullRefresh各项参数，与双 webview 模式的子页面设置是一样的。

  说明：

  1. DOM结构无特殊要求，只需要指定一个下拉刷新容器标识即可

  mui.init({
    pullRefresh : {
      container:"#refreshContainer",//下拉刷新容器标识，querySelector能定位的css选择器均可，比如：id、.class等
      down : {
        style:'circle',//必选，下拉刷新样式，目前支持原生5+ ‘circle’ 样式
        color:'#2BD009', //可选，默认“#2BD009” 下拉刷新控件颜色
        height:'50px',//可选,默认50px.下拉刷新控件的高度,
        range:'100px', //可选 默认100px,控件可下拉拖拽的范围
        offset:'0px', //可选 默认0px,下拉刷新控件的起始位置
        auto: true,//可选,默认false.首次加载自动上拉刷新一次
        callback :pullfresh-function //必选，刷新函数，根据具体业务来编写，比如通过ajax从服务器获取新数据；
      }
    }
  });

• 模式说明：

  • 优点：
    • 性能更优，体现在两点：
      1. 相比双webview，不创建额外子 webview 性能消耗更少
      2. 下拉拖动过程中不会发生重绘，也减少了性能消耗
  • 缺点：
    • 目前仅支持‘cricle’样式以及该样式的颜色自定义

双 webview 模式

• 效果展示：

  

• 动画原理：

  使用双 webview 模式的下拉刷新，创建一个子 webview 添加列表；拖动时，拖动的是一个完整的 webview，避免了类似 DIV 拖动流畅度不好的问题，回弹动画使用原生动画；在 iOS 平台，H5 的动画已经比较流畅，故依然使用 H5 方案。两个平台实现虽有差异，但 mui 经过封装，可使用一套代码实现下拉刷新。

• 使用方法：

  主页面内容比较简单，只需要创建子页面即可：

  mui.init({
      subpages:[{
        url:pullrefresh-subpage-url,//下拉刷新内容页面地址
        id:pullrefresh-subpage-id,//内容页面标志
        styles:{
          top:subpage-top-position,//内容页面顶部位置,需根据实际页面布局计算，若使用标准mui导航，顶部默认为48px；
          .....//其它参数定义
        }
      }]
  });
            

  iOS平台的下拉刷新，使用的是 mui 封装的区域滚动组件， 为保证两个平台的 DOM 结构一致，内容页面需统一按照如下 DOM 结构构建：

  <!--下拉刷新容器-->
  <div id="refreshContainer" class="mui-content mui-scroll-wrapper">
    <div class="mui-scroll">
      <!--数据列表-->
      <ul class="mui-table-view mui-table-view-chevron">
  
      </ul>
    </div>
  </div>

  其次，通过 mui.init 方法中 pullRefresh 参数配置下拉刷新各项参数，如下：

  mui.init({
    pullRefresh : {
      container:"#refreshContainer",//下拉刷新容器标识，querySelector能定位的css选择器均可，比如：id、.class等
      down : {
        height:50,//可选,默认50.触发下拉刷新拖动距离,
        auto: true,//可选,默认false.首次加载自动下拉刷新一次
        contentdown : "下拉可以刷新",//可选，在下拉可刷新状态时，下拉刷新控件上显示的标题内容
        contentover : "释放立即刷新",//可选，在释放可刷新状态时，下拉刷新控件上显示的标题内容
        contentrefresh : "正在刷新...",//可选，正在刷新状态时，下拉刷新控件上显示的标题内容
        callback :pullfresh-function //必选，刷新函数，根据具体业务来编写，比如通过ajax从服务器获取新数据；
      }
    }
  });

• 模式说明：

  • 优点：
    • 可自定义下拉刷新样式，更改文字等等.参考关于自定义下拉刷新样式问答
  • 缺点：
    • 相比单 webview，性能消耗更大，不过都比 div 模式的要好用
    • DOM结构需要统一配置

• 滚动到特定位置

  下拉刷新组件滚动到特定位置的方法类似区域滚动组件

  目前仅支持 双 webview 模式

  • scrollTo( xpos , ypos [, duration] )

    • xpos
      Type: Integer
      要在窗口文档显示区左上角显示的文档的 x 坐标
    • ypos
      Type: Integer
      要在窗口文档显示区左上角显示的文档的 y 坐标
    • duration
      Type: Integer
      滚动时间周期，单位是毫秒

  示例：在 hello mui 下拉刷新示例中，实现了双击标题栏，让列表快速回滚到顶部的功能；代码如下：

  var contentWebview = null;
  //监听标题栏的双击事件
  document.querySelector('header').addEventListener('doubletap',function () {
    if(contentWebview==null){
      contentWebview = plus.webview.currentWebview().children()[0];
    }
    //内容区滚动到顶部
    contentWebview.evalJS("mui('#pullrefresh').pullRefresh().scrollTo(0,0,100)");
  });

• 更改下拉刷新文字位置

  *可以解决修改下拉刷新子页面默认top值后,下拉刷新提示框位置异常问题

  根据实际需求在父页面给mui-content设置top属性

  目前仅支持 双 webview 模式

  .mui-bar-nav ~ .mui-content .mui-pull-top-pocket{
    top: 180px !important;
  }

自动触发下拉刷新

mui 支持设置首次加载时自动触发一次下拉刷新，配置如下auto参数为:true即可，上拉加载同样支持此配置

mui.init({
  pullRefresh : {
    container:"#refreshContainer",//下拉刷新容器标识，querySelector能定位的css选择器均可，比如：id、.class等
    down : {
      auto: true,//可选,默认false.首次加载自动下拉刷新一次
    },
    up : {
      auto: true //可选,默认false.首次加载自动上拉加载一次
    }
  }
});

下拉刷新结束

两种模式在下拉刷新过程中，当获取新数据后，都需要执行 endPulldown 方法， 该方法的作用是关闭“正在刷新”的样式提示，内容区域回滚顶部位置，如下：

function pullfresh-function() {
     //业务逻辑代码，比如通过ajax从服务器获取新数据；
     ......
     //注意，加载完新数据后，必须执行如下代码，注意：若为ajax请求，则需将如下代码放置在处理完ajax响应数据之后
     //没有更多内容了，endPulldown 传入true， 不再执行下拉刷新
     mui('#refreshContainer').pullRefresh().endPulldown();
}

扩展阅读

问答社区话题讨论： 下拉刷新

代码块激活字符:

mpull (DOM结构)

minitpull (初始化组件)

mmpull(组件方法)

2、

3、

2. 上拉加载返回顶部

0、

http://dev.dcloud.net.cn/mui/pullup/

1、

概述

mui的上拉加载和下拉刷新类似，都属于pullRefresh插件，使用过程如下：

• 1、页面滚动到底，显示“正在加载...”提示（mui框架提供）
• 2、执行加载业务数据逻辑（开发者提供）
• 3、加载完毕，隐藏"正在加载"提示（mui框架提供）

开发者只需关心业务逻辑，实现加载更多数据即可。

初始化

初始化方法类似下拉刷新，通过mui.init方法中pullRefresh参数配置上拉加载各项参数，如下：

mui.init({
  pullRefresh : {
    container:refreshContainer,//待刷新区域标识，querySelector能定位的css选择器均可，比如：id、.class等
    up : {
      height:50,//可选.默认50.触发上拉加载拖动距离
      auto:true,//可选,默认false.自动上拉加载一次
      contentrefresh : "正在加载...",//可选，正在加载状态时，上拉加载控件上显示的标题内容
      contentnomore:'没有更多数据了',//可选，请求完毕若没有更多数据时显示的提醒内容；
      callback :pullfresh-function //必选，刷新函数，根据具体业务来编写，比如通过ajax从服务器获取新数据；
    }
  }
});

结束上拉加载

加载完新数据后，需要执行endPullupToRefresh()方法，结束转雪花进度条的“正在加载...”过程

• .endPullupToRefresh( nomore )

  • nomore
    Type: Boolean
    是否还有更多数据；若还有更多数据，则传入false; 否则传入true，之后滚动条滚动到底时，将不再显示“上拉显示更多”的提示语，而显示“没有更多数据了”的提示语；

示例：

function pullfresh-function() {
     //业务逻辑代码，比如通过ajax从服务器获取新数据；
     ......
     //注意：
     //1、加载完新数据后，必须执行如下代码，true表示没有更多数据了：
     //2、若为ajax请求，则需将如下代码放置在处理完ajax响应数据之后
     this.endPullupToRefresh(true|false);
}

重置上拉加载

若部分业务中，有重新触发上拉加载的需求（比如当前类别已无更多数据，但切换到另外一个类别后，应支持继续上拉加载），此时调用.refresh(true)方法，可重置上拉加载控件，如下代码：

//pullup-container为在mui.init方法中配置的pullRefresh节点中的container参数；
//注意：refresh()中需传入true
mui('#pullup-container').pullRefresh().refresh(true);

禁用上拉刷新

在部分场景下希望禁用上拉加载，比如在列表数据过少时，不想显示“上拉显示更多”、“没有更多数据”的提示语，开发者可以通过调用disablePullupToRefresh()方法实现类似需求，代码如下：

//pullup-container为在mui.init方法中配置的pullRefresh节点中的container参数；
mui('#pullup-container').pullRefresh().disablePullupToRefresh();

启用上拉刷新

使用disablePullupToRefresh()方法禁用上拉加载后，可通过enablePullupToRefresh()方法再次启用上拉加载，代码如下：

//pullup-container为在mui.init方法中配置的pullRefresh节点中的container参数；
mui('#pullup-container').pullRefresh().enablePullupToRefresh();

扩展阅读

• 1、上拉加载时，怎么隐藏底部的“没有更多数据了”?
• 2、问答社区话题讨论：上拉加载

2、

3.返回顶部

 

4.返回顶部

 

5.返回顶部

 

 

6.返回顶部

 

7.返回顶部

 

8.返回顶部

 

9.返回顶部

 

10.返回顶部

 

 

11.返回顶部

 

12.返回顶部

 

13.返回顶部

 

14.返回顶部

 

15.返回顶部

 

 

16.返回顶部

 

作者：ylbtech 出处：http://ylbtech.cnblogs.com/ 本文版权归作者和博客园共有，欢迎转载，但未经作者同意必须保留此段声明，且在文章页面明显位置给出原文连接，否则保留追究法律责任的权利。