Skip to content

Zhouchuanwen/ios-fourth-select

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

四级联动

#webapp模仿ios下拉菜单
html下拉菜单select在安卓和IOS下表现不一样,iosselect正是为统一下拉菜单样式而生

我们以IOS下select的交互和样式为蓝本,开发了这一组件

##特点 可以做到0依赖,只需引用一个js和css即可,样式可自己定制,也可使用默认样式 ##文件说明 src------iosselect基于iscroll5开发,在这个文件夹下可以看到iscroll.js,iosselect.js,iosselect.css,如果项目里有单独使用iscroll5,可以使用这个版本

merge------合并了iscroll与iosselect,做到组件0依赖,方便开发

demo------使用demo,说明如下:

one------一级下拉菜单,以银行选择为实例

two------二级下拉菜单,相互独立,没有关联,以三国杀组合选将为例

three------三级下拉菜单,省市区选择三级联动

four-------四级目前支持,只需要修改一下数据来源,然后对一些方法做简单的修改即可。。。

rem------手机端部分解决方案会使用viewport缩放,这个时候我们需要添加一些样式,页面在缩放的情况下正常显示

datepicker------时间选择器,通过方法筛选数据,实现三级联动,ajax获取数据时可参考此例,但是ajax需要同步获取数据

##使用说明 ###API new IosSelect(level, data, options)

data: [oneLevelArray[, twoLevelArray[, threeLevelArray]]]
options:
     callback: 选择完毕后的回调函数 必选
     title: 选择框title  可选,没有此参数则不显示title
     itemHeight: 每一项的高度,可选,默认 35px
     headerHeight: 组件标题栏高度 可选,默认 44px
     addClassName: 组件额外类名 可选,用于自定义样式
     oneTwoRelation: 第一列和第二列是否通过parentId关联 可选,默认不关联
     twoThreeRelation: 第二列和第三列是否通过parentId关联 可选,默认不关联
     oneLevelId: 第一级选中id 可选
     twoLevelId: 第二级选中id 可选
     threeLevelId: 第三级选中id 可选
     fouthLevelId:第四级选中id,可选
####参数说明
level: 级联等级,支持1,2,3 必选项
data: 数组,前三项分别对应级联1,2,3项,每一项又是一个数组或方法,如果是一级下拉菜单,data长度为1
<!--这里的data可以为空,原来的插件是直接把数据写在js里面,然后通过data传递过去
    现在是可以不使用data参数,而是在js里面请求地址数据(根据不同的需要,大家可以自己去实现请求地址数据)
-->


    如果是数组:
        每一项数组中包含一系列对象,每个对象必须要有id,作为该条数据在该项数组中的唯一标识,parentId是可选属性,作为关联的标志
options.callback(selectOneObj[[, selectTwoObj], selectThreeObj,selectFourObj]) 每个级联选中项,包含对应数据的所有字段及dom对象
    如果是方法:
    传入一个方法,在方法中获取数据
####以地址选择为例:
data为三个数组:
// 省份列表
var iosProvinces = [
    {'id': '130000', 'value': '河北省', 'parentId': '0'}
];

// 城市列表
var iosCitys = [
    {"id":"130100","value":"石家庄市","parentId":"130000"}
];

// 区县列表
var iosCountys = [
    {"id":"130102","value":"长安区","parentId":"130100"}
];
实例化:
var iosSelect = new IosSelect(3, 
        [iosProvinces, iosCitys, iosCountys],
        {
            title: '地址选择',
            itemHeight: 35,
            oneTwoRelation: 1,
            twoThreeRelation: 1,
            oneLevelId: oneLevelId,
            twoLevelId: twoLevelId,
            threeLevelId: threeLevelId,
            callback: function (selectOneObj, selectTwoObj, selectThreeObj) {
                selectOneObj = {
                    atindex:26,
                    dom:li.at,
                    id:"510000",
                    parentid:"0",
                    value:"四川省"
                }
            }
    });
    data为方法:
    var selectDateDom = $('#selectDate');
var showDateDom = $('#showDate');
// 初始化时间
var now = new Date();
var nowYear = now.getFullYear();
var nowMonth = now.getMonth() + 1;
var nowDate = now.getDate();
showDateDom.attr('data-year', nowYear);
showDateDom.attr('data-month', nowMonth);
showDateDom.attr('data-date', nowDate);
// 格式化年
function formatYear (nowYear) {
    var arr = [];
    for (var i = nowYear - 5; i <= nowYear + 5; i++) {
        arr.push({
            id: i + '',
            value: i + '年'
        });
    }
    return arr;
}
// 格式化月
function formatMonth () {
    var arr = [];
    for (var i = 1; i <= 12; i++) {
        arr.push({
            id: i + '',
            value: i + '月'
        });
    }
    return arr;
}
// 格式化日期
function formatDate (count) {
    var arr = [];
    for (var i = 1; i <= count; i++) {
        arr.push({
            id: i + '',
            value: i + '日'
        });
    }
    return arr;
}
// 年数据,方法
var yearData = function () {
    return formatYear(nowYear);
};
// 月数据,方法
var monthData = function () {
    return formatMonth();
};
// 日数据,方法
var dateData = function (year, month) {
    if (/^1|3|5|7|8|10|12$/.test(month)) {
        return formatDate(31);
    }
    else if (/^4|6|9|11$/.test(month)) {
        return formatDate(30);
    }
    else if (/^2$/.test(month)) {
        if (year % 4 === 0 && year % 100 !==0 || year % 400 === 0) {
            return formatDate(29);
        }
        else {
            return formatDate(28);
        }
    }
    else {
        throw new Error('month is illegal');
    }
    
};
selectDateDom.bind('click', function () {
    var oneLevelId = showDateDom.attr('data-year');
    var twoLevelId = showDateDom.attr('data-month');
    var threeLevelId = showDateDom.attr('data-date');
    var iosSelect = new IosSelect(3, 
        [yearData, monthData, dateData],
        {
            title: '地址选择',
            itemHeight: 35,
            oneTwoRelation: 1,
            twoThreeRelation: 1,
            oneLevelId: oneLevelId,
            twoLevelId: twoLevelId,
            threeLevelId: threeLevelId,
            callback: function (selectOneObj, selectTwoObj, selectThreeObj) {
                showDateDom.attr('data-year', selectOneObj.id);
                showDateDom.attr('data-month', selectTwoObj.id);
                showDateDom.attr('data-date', selectThreeObj.id);
                showDateDom.html(selectOneObj.value + ' ' + selectTwoObj.value + ' ' + selectThreeObj.value);
            }
    });
});

##demo说明 一级级联,银行选择

http://zhoushengfe.com/iosselect/demo/one/bank.html

二级级联,三国杀将领组合选

http://zhoushengfe.com/iosselect/demo/two/sanguokill.html

三级级联,省市区选择(现在可以支持四级,等有时间完善)

http://zhoushengfe.com/iosselect/demo/three/area.html

viewport缩放时处理方案

http://zhoushengfe.com/iosselect/demo/rem/bank.html

日期选择器

http://zhoushengfe.com/iosselect/demo/datepicker/date.html

About

A jquery plugin for mobile front-end

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published