LEGO-Mobile

一个两列瀑布流布局实现的组件，支持上拉加载更多，下拉刷新

快速使用¶

1.样式依赖¶

如果你有sass编译环境，可以通过 LegoUI-mobi Github 克隆一份_lego.scss 文件到你的sass目录下

然后用引入该scss，并且@include mod-falls;

// 引入LegoUI-mobi
@import 'lego';
// 引用瀑布流组件mixin
@include mod-falls;

如果没安装sass，你也可以直接在 head 里面引入 mod.falls.css 文件

<head>
    ...
    <link rel="stylesheet" href="http://assets.dwstatic.com/legomobi/3.0.0/css/mod.falls.css">
</head>

2.HTML Layout¶

配置 id 作为组件的快速入口以及唯一标识 , data-js 是js钩子

<div class="mod-falls" id="falls">
    <div class="mod-falls__main">
        <div class="mod-falls__bd">
            <ul class="mod-falls__col" data-js="col">
                <a href="#">
                    <li class="mod-falls__item">
                        <div class="custom">
                            ...
                        </div>
                    </li>
                </a>
                ...
                <a href="#">
                    <li class="mod-falls__item">
                        <div class="custom">
                            ...
                        </div>
                    </li>
                </a>
            </ul>
            <ul class="mod-falls__col" data-js="col">
                <a href="#">
                    <li class="mod-falls__item">
                        <div class="custom">
                            ...
                        </div>
                    </li>
                </a>
                ...
                <a href="#">
                    <li class="mod-falls__item">
                        <div class="custom">
                            ...
                        </div>
                    </li>
                </a>
            </ul>
        </div>
        <div class="mod-falls__ft">
            <div class="mod-falls__loadTip" data-js="tip"></div>
            <div class="mod-falls__loading" data-js="loading"></div>
        </div>
    </div>
</div>

3.最佳实践¶

组件依赖 seajs , 调用组件前必须引入 sea-lego.js 文件

<body>
    ...
    <script src="http://assets.dwstatic.com/mobile/src/js/main/seajs/sea-lego.js" id="seajsnode"></script>
</body>

如果你已经在项目中使用了seajs，你可以直接extand一份config配置来使用

seajs.config({
    paths: {
        'legoPath': 'http://assets.dwstatic.com/mobile/src/js/',
        'modulePath': 'http://assets.dwstatic.com/legomobi/3.0.0/js/'
    },
    alias: {
        'zepto': 'legoPath/main/zepto/zepto.min.js',
        'touch': 'legoPath/main/zepto/zepto.touch.js',
        'iscroll': 'legoPath/module/iscroll/iscroll.js'
    }
});

注意： paths 的配置是依赖必须的， alias 中的配置项如果你在项目中已有使用，你可以选择使用自己项目的路径或者使用CDN上的路径

调用方式1：你可以直接在页面中通过 seajs.use() 来调用该组件

<script>
    seajs.use(['modulePath/falls'], function(Falls) {
        var falls = new Falls('#falls',{
            top: 0,
            bottom:200
        });
    });
</script>

调用方式2：也可以在自定义的模块中通过 require 来调用

define(function(require, exports, module) {
    var Falls = require('modulePath/falls');
    var falls = new Falls('#falls',{
        top: 0,
        bottom:200
    });
});

配置说明¶

1.属性列表¶

options.top `Number`¶

该属性设置距离屏幕顶部的长度，单位为：px

Default: 0

options.bottom `Number`¶

该属性设置距离屏幕底部的长度，单位为：px

Default: 0

2.事件列表¶

pullUpLoading `Callback`¶

组件封装了一套上拉加载的机制，如果要重新定制的话就要重写这套机制

查看Demo¶

chrome模拟器查看 Demo

Falls