ListLoading 移动端加载组件

程序名称:ListLoading

授权协议: MIT

操作系统: 跨平台

开发语言: JavaScript

ListLoading 介绍


listloading.js

listloading是一个移动端的上拉、下拉加载更多的组件。主要依赖于iscroll.js
v5.1.2基础上开发的组件,基础库可以使用jquery.js或者zepto.js操作dom节点,目前我是使用了zepto.js作为基础库操作dom,以jquery插件的形式存在。如果不想以插件方式使用,则只需要把listloading直接移植你需要的库里面就ok啦。listloading主要针对移动端而生,在使用浏览器自带滚动,用户体验很不友好,与Android和ios差别甚远,所以选择iscroll.js,它实现方式是使用css3动画translate
2D 转换来实现滚动效果,transform属性使用硬件加速,性能方法得到很大提高。

npm安装

npm install -g listloading

使用方法如下:

1、html结构

<div id=listloading>
    <div>
        <ul id=order-list></ul>
    </div>
</div>

与iscroll创建的结构一样,但是指定的创建的元素节点必须指定ID,因为在组件里面发布订阅模式需要做一个标识。因为iscroll在节点元素创建之前,必须先设定高度,否则会导致无法滚动;iscroll创建完毕是指定给第一个子元素滚动,所以listloading的上拉和下拉刷新也是追加到第一个子元素里面,其实把第一个子元素想象成为html里面的body就可以了。

2、需要引入的js

<script src=../src/jslib/zepto.min.js></script> <script src=../src/jslib/iscroll.js></script> <script src=../build/listloading.min.js></script>

3、调用

var m = 3;
var n = 0;
var hei = $(window).height();
// 创建iscroll之前必须要先设置父元素的高度,否则无法拖动iscroll
$('#listloading, .listloadingClass').height(hei);

// 模板
var createHtml = function(){
    var __html = '';
    for(var i = 0; i < 15; i++){
        var now = new Date().getTime();
        now = new Date(now + i*1000000);

        __html += '<li><span class=icon></span><p class=title><time class=r>' + now.getHours() + ':' + now.getMinutes() + ':' + now.getSeconds() + '</time>listloading' + (n++) + '</p><p class=text>移动端上拉下拉刷新组件...</li>';
    }
    return __html;
}
// demo
// var listloading = $('#listloading').listloading({
//     disableTime: true,  // 是否需要显示时间
//     pullUpAction : function(cb){   //上拉加载更多
//         m--;
//         var flg = false;
//         var __html = createHtml();
//         if(m < 1){
//             flg = true;
//         }else{
//             $('#order-list').append(__html);
//         }
//         // 数据加载完毕需要返回 end为true则为全部数据加载完毕
//         cb(flg);

//     },
//     pullDownAction : function(cb, flag){  //下拉刷新
//         flag 为true 第一次加载
//         if (flag) {
//             // dosomething...
//         }
//         m = 3;
//         var __html = createHtml();
//         $('#order-list').html(__html);
//         // 执行完执行方法之后必须执行回调 回调的作用是通知默认加载已经全部执行完毕,程序需要去创建iscroll
//         cb();
//     },
//     // iscroll的API 
//     iscrollOptions: {
//         //
//     }
// });
// // 点击事件
// listloading.evt('li', 'click', function (dom) {
//     // dom.remove();
//     // $('#order-list').append(createHtml());
//     // listloading.refresh();
// });

// demo
var k = 3;
var listloadingClass = $('.listloadingClass').listloading({
    pullUpAction : function(cb){   //上拉加载更多
        k--;
        var flg = false;
        var __html = createHtml();
        if(k < 1){
            flg = true;
        }else{
            $('#listloadingClass-order-list').append(__html);
        }
        // 数据加载完毕需要返回 end为true则为全部数据加载完毕
        cb(flg);

    },
    pullDownAction : function(cb, flag){  //下拉刷新
        // flag 为true 第一次加载
        if (flag) {
            // dosomething...
        }
        k = 3;
        var __html = createHtml();
        $('#listloadingClass-order-list').html(__html);
        // 执行完执行方法之后必须执行回调 回调的作用是通知默认加载已经全部执行完毕,程序需要去创建iscroll
        cb();
    }
});

效果图


4、API

初始化会执行一次,主要是创建iscroll,之后每次下拉刷新结束之后执行,当在方法里面执行完毕你的程序之后需要执行一个回调函数,告知已经全部程序执行完毕,listloading就会自动去调用iscroll的刷新功能,回调不需要传参。

options.pullDownAction = function(cb, flag){ 
    // 下拉刷新 
    // flag 为true 第一次加载 
    if (flag) { // dosomething... } // 执行完执行方法之后必须执行回调 
    cb();
}

每次上拉加载更多结束之后执行,同样的在执行完你的程序之后需要执行一个回调函数,回调里面需要回调一个布尔值,如果为true则怎么已经全部加载完毕,就已经拉到底了。

options.pullUpAction = function(cb){ // 上拉加载更多 ..... 
    // 执行完执行方法之后必须执行回调 true为上拉到底 
    cb(true);
}
listloading.destroy();

滚动区域节点有增删则需要在操作完毕之后调用此方法

listloading.refresh();

true下拉显示时间,距离上次刷新的时间

options.disableTime = true
options.upLoadmoretxt = '上拉加载更多文字'; // 里面可以放html标签
options.pullDrefreshtxt = '下拉刷新文字'; // 里面可以放html标签
options.loadertxt = '正在加载中文字'; // 里面可以放html标签
options.Realtimetxt = '松开刷新文字'; // 里面可以放html标签
options.loaderendtxt = '已经全部加载完毕文字'; // 里面可以放html标签
options.iscrollOptions = {};

ListLoading 官网

https://github.com/gtdalp/listloading

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。

相关推荐


MuPlayer 是一款跨平台、轻量级的音频播放解决方案,是百度@音乐前端团队开发维护的浏览端音频播放内核,它基于HTML5
OS FLV 是一个 开源和可嵌入网页的flv播放器。 这个播放器拥有大量的选项可以通过嵌入代码进行设置.
DewPlayer音乐播放器,样式很简单,而且很实用.播放器可以根据自己的喜好改变颜色,也算比较个性化吧.但唯一的不足就是只支持MP3格式的音乐。
JW FLV MEDIA PLAYER是一个开源的在网页上使用的Flash视频、音频以及图片播放器,支持 Sliverlight
Speakker 是一个基于 Web 浏览器的音乐播放器,只提供很多高级播放功能包括播放列表管理和分享。
Player Framework 是一个开源的支持 HTML5 的视频播放器框架,同时也支持 Silverlight 和 Windows Phone
Sewise Player是一款专业的免费网页视频、流播放器,它功能强大,体积小,跨平台,使用方便简洁、随心所欲:
SoundManager 2 利用 HTML5 和 Flash 技术提供了稳定和阔平台的音乐播放功能,只有 10K 的 JS 包。
xPlayer v1.0 特性: 文件大小 9.78kb; 可以自定义皮肤; 3.支持 http 和 rtmp 视频; 4.音量调节,全屏播放,拖拽播放;
XPlayer 豆瓣音乐播放器 特点: 1.自动侦测Douban网页的歌曲 2.Douban网页关闭,歌曲能够继续播放
歌词 插件 最新更新,扩展性能稍微有点提升了, 不多说了,更多敬请查看首页http://luochunzong.sinaapp.com/?p=84
ABPlayerHTML5是一个在HTML5下的弹幕播放器(同步显示视频于评论)实现。类似功能的播放器可以参考基于Flash的MukioPlayer和PADPlayer。
AudioPlayer.js 是一个 jQuery 的插件,实现了 HTML5 的音乐播放器,无需任何图片,实现了响应式布局,支持触摸操作。
替换中国大陆主流视频网站的 Flash 播放器为 HTML5 播放器 使用 Mac 的同学都可能碰到过在线看视频引起机子风扇狂转、机身发烫等情况,这是因为 Flash 占用了过多系统资源的缘故。
AetherPlayer 是一个类CD的轻量HTML5播放器,特别适合博客及个人站点使用。它漂亮得不像……咳,这边吹牛的话就不说了。
专注、极致、智慧,国内外为数不多不依赖开源框架、跨平台(windows/android/iOS)、公网推送(支持rtmp)-播放(支持rtmp/rtsp)业界真正靠谱 的超低延迟。
node-kugou-client 是 Node.js 酷狗客户端。 安装 npm install node-kugou-client 使用 var kugou = require(\"node-kugou-client\");
Youku HTML5 播放器扩展 —— 告别 flash 和广告 关于官方内测 html5 播放器 Firefox ( xpi 直接安装) ( firefox 50.0+)
Chimee 由奇舞团研制的 h5 播放器,它支持 mp4、m3u8、flv 等多种格式。通过插件式开发,能满足业务方快速迭代、灰度发布等要求。让开发者能够轻松快捷地完成视频场景的开发。
OneVideo是一款基于OneBase+UniApp开发的小视频播放移动应用。