mobileWindow.js

因为公司的新我的项目须要在手机端实现相似 APP 的操作，为了疾速的开发当然心愿找一个现成的第三方类库来实现相干的性能，然而找了几天，仍然没有找个特地适合的，于是就本人入手开始写一套简略的框架来实现该我的项目泛滥的需要。

此函数库的次要作用为了让用户关上手机端页面，也像是在应用 APP 一样。源码借鉴了 mobileSelect.js 这个第三方工具类，框架的思维借鉴了 Vue。

GitHub 地址：链接

性能

• 滑动抉择框
• 手动输入框，反对内容验证
• 标签切换不同选框

个性

• 原生 js 挪动端抉择控件，不依赖任何库
• 可传入一般数组或者 json 数组
• 可依据传入的参数长度，主动渲染出对应的列数，反对单项到多项抉择
• 自动识别是否级联
• 抉择胜利后，提供自定义回调函数 callback() 返回以后抉择索引地位、以及抉择的数据（数组 /json）
• 每次手势滑动完结后，也提供一个回调函数 transitionEnd() 返回以后抉择索引地位、以及抉择的数据（数组 /json）
• 可能在曾经实例化控件后，提供 update 函数再次渲染，可用于异步获取数据或点击交互后须要扭转所选数据的场景
• 提供重定位函数
• 能够回显（第二次进入页面时，能够显示历史抉择的地位）

演示

手机页面预览：

实在我的项目体验，手机端请关上：链接

可能因为账号问题，某些同学无奈看全功能，能够在本代码库的 demo 目录中查看所有的性能

引入

形式一 标签引入：

<link rel="stylesheet" type="text/css" href="assets/styles/mobileWindow.css">
<script src="assets/scripts/mobileWindow.js" type="text/javascript"></script>

形式二 npm：

npm install mobile-window -D

在你的 js 文件中 import：

import MobileWindow from 'mobile-window'

抉择框（无标签）- 疾速应用

①一般数组格局 - 非联动

<div id="trigger1"></div> <!-- 页面中别漏了这个 trigger-->

<script type="text/javascript">
var mobileSelect1 = new MobileSelect({
    trigger: '#trigger1',
    title: '单项抉择',
    wheels: [{data:['周日','周一','周二','周三','周四','周五','周六']}
            ],
    position:[2] // 初始化定位
});
</script>

②json 格局 - 非联动

<div id="trigger2"></div>

<script type="text/javascript">
var mobileSelect2 = new MobileSelect({
    trigger: '#trigger2',
    title: '地区抉择',
    wheels: [
                {data:[{id:'1',value:'左近'},
                    {id:'2',value:'上城区'},
                    {id:'3',value:'下城区'},
                    {id:'4',value:'江干区'},
                    {id:'5',value:'拱墅区'},
                    {id:'6',value:'西湖区'}
                ]},
                {data:[{id:'1',value:'1000 米'},
                    {id:'2',value:'2000 米'},
                    {id:'3',value:'3000 米'},
                    {id:'4',value:'5000 米'},
                    {id:'5',value:'10000 米'}
                ]}
            ],
    callback:function(indexArr, data){console.log(data); // 返回选中的 json 数据
    }
});
</script>

效果图：

③json 格局 - 联动

<div id="trigger3"></div>

<script type="text/javascript">
  var mobileSelect3 = new MobileSelect({
      trigger: '#trigger3',
      title: '地区抉择 - 联动',
      wheels: [
                  {data:[
                      {
                          id:'1',
                          value:'左近',
                          childs:[{id:'1',value:'1000 米'},
                              {id:'2',value:'2000 米'},
                              {id:'3',value:'3000 米'},
                              {id:'4',value:'5000 米'},
                              {id:'5',value:'10000 米'}
                          ]
                      },
                      {id:'2',value:'上城区'},
                      {id:'3',value:'下城区'},
                      {id:'4',value:'江干区'},
                      {id:'5',value:'拱墅区'},
                      {id:'6',value:'西湖区'}
                  ]}
              ],
      position:[0,1],
      callback:function(indexArr, data){console.log(data); // 返回选中的 json 数据
      }
  });
  </script>

效果图：

④在 vue-cli 中如何应用

npm install mobile-select -D

<template>
    <div>
        <div id="trigger4"> 单项抉择 </div>
    </div>
</template>

<script>
    import MobileSelect from 'mobile-select'

    export default {mounted() {
            var mobileSelect4 = new MobileSelect({
                trigger: "#trigger4",
                title: "单项抉择",
                wheels: [{data: ["周日","周一","周二","周三","周四","周五","周六"]}
                ],
                callback:function(indexArr, data){console.log(data);
                }
            });
        }
    }
</script>

⑤数据字段名映射

<div id="trigger5"></div>

<script type="text/javascript">
    // 如果你的数据的字段名为 id,title,children
    // 与 mobileSelect 的 id,value,childs 字段名不匹配
    // 能够用 keyMap 属性进行字段名映射
    var mobileSelect5 = new MobileSelect({
        trigger: '#trigger5',
        title: '数据字段名映射',
        wheels: [
                    {data:[
                        {
                            id:'1',
                            title:'A',
                            children:[{id:'A1',title:'A-a'},
                                {id:'A2',title:'A-b'},
                                {id:'A3',title:'A-c'}
                            ]
                        },
                        {
                            id:'1',
                            title:'B',
                            children:[{id:'B1',title:'B-a'},
                                {id:'B2',title:'B-b'},
                                {id:'B3',title:'B-c'}
                            ]
                        },
                    ]}
                ],
        keyMap: {
            id:'id',
            value: 'title',
            childs :'children'
        },
        callback:function(indexArr, data){console.log(data);
        }
    });
</script>

输入框（无标签）- 疾速应用

输出内容

<div id="trigger-input"></div>

var mobileWindowInput = new MobileWindow({
    // trigger: '#lease-type-trigger',
    // title: '租房类型选项',
    trigger: {
        type: 'input',
        element: '#trigger-input',
    },
    title: '请输出内容',
    transitionEnd:function(indexArr, data){//console.log(data);
    },
    callback:function(data){console.log(data);
        // mobileWindowRental.validateRegex(123);
        // if(regInt.test(data.valueInput)) {document.getElementById('trigger-input').innerHTML = data['valueInput']

    }
});

输出内容 – 验证内容格局

<div id="month-amount-wrapper"></div>

var mobileWindowRental = new MobileWindow({
    // trigger: '#lease-type-trigger',
    // title: '租房类型选项',
    trigger: {
        type: 'input',
        element: '#month-amount-wrapper',
    },
    title: '请输出金额',
    inputTrim: true,
    inputCheckType: ['number'],
    transitionEnd:function(indexArr, data){//console.log(data);
    },
    callback:function(data){console.log(data);
        // mobileWindowRental.validateRegex(123);
        // if(regInt.test(data.valueInput)) {if(data['checkType'][0]) {document.getElementById('month-amount-wrapper').style.color = '#000000';
            document.getElementById('month-amount-wrapper').innerHTML = data.valueInput;
        } else {
            var strPrompt = '请填写整数';
            document.getElementById('month-amount-wrapper').style.color = '#000000';
            document.getElementById('month-amount-wrapper').innerHTML = strPrompt;
        }

    }
});

抉择框（有标签）- 疾速应用

<div id="trigger6" class="trigger-tag-selector">
    <div id="house-floor-container"> 楼层 </div>
    <div id="house-elevator-container"> 电梯 </div>
</div>

var floorArr = [];
var floorTotalArr = [];

var floorNeed = 53; // 共 50 层
for(var iFloor = 0; iFloor<floorNeed; iFloor++) {floorArr[iFloor] = iFloor-2 + '层';
}

for(var iFloor = 0; iFloor<floorNeed-3; iFloor++) {floorTotalArr[iFloor] = '共' + (iFloor+1) +'层';
}

var arrHouseFloor = [
    floorArr,
    floorTotalArr,
];

var arrHouseElevator = ['有电梯', '无电梯'];

var arrTypes = [arrHouseFloor, arrHouseElevator];
var mobileSelectFloorElevator = new MobileWindow({
    // trigger: '#lease-type-trigger',
    // title: '租房类型选项',
    trigger: {type: ['select', 'select'],
        element: ['#house-floor-container', '#house-elevator-container'],
        tags:['楼层', '电梯'],
    },
    title: ['请抉择楼层', '请抉择电梯'],
    wheels: [
        {data: arrTypes,},
    ],
    position:[0, 0], // 初始化定位 关上时默认选中的哪个 如果不填默认为 0
    transitionEnd:function(indexArr, data){//console.log(data);
    },
    beforeCreate: function() {},
    created: function () {
        // `this` 指向 vm 实例
        console.log('a is:' + this.a)
    },
    beforeMount: function() {},
    callback: function(tagIndex, indexArr, data){console.log(tagIndex, '/', indexArr, '/', data);

    }
});

参数

注：回调函数中返回的参数含意如下

• indexArr 是以后选中的索引数组 如 [0,0,1] 代表有三个轮子 选中的数据是第一个轮子的第 0 个数据、第二个轮子的第 0 个数据、第三个轮子的第 1 个数据
• data 是以后选中的 json 数据 如 [{id:’1′,value:’hello’},{id:’2′,value:’world’}]

性能函数：

注：性能函数中须要传递的参数含意如下

• sliderIndex 代表的是要批改的轮子的索引
• posIndex 代表地位索引

①性能函数 demo：

<div id="day"></div>

var mySelect = new MobileSelect({
    trigger: '#day',
    wheels: [{data:['周日','周一','周二','周三','周四','周五','周六']},
                {data:['08:00','09:00','10:00','11:00','12:00','13:00','14:00']}
            ],
    position:[1,1] // 初始化定位 两个轮子都选中在索引 1 的选项
});

//----------------------------------------------
// 进行根底的实例化之后，对实例用性能函数操作

// mySelect.setTitle('啦啦啦 (๑•̀ㅁ•́ฅ)');
// 设置控件的题目

// mySelect.updateWheel(0,['sunday','Monday','Tuesday','Wednesday','Thursday','Friday','Saturday']);
// 更新第 0 个轮子的数据，数据变为英文的星期几

// mySelect.locatePosition(1,0);
// 从新定位第 1 个轮子的地位，将第 1 个轮子的第 0 个数据改为以后选中。// (第 1 个轮子是指左边的轮子，右边的轮子是第 0 个)

根底实例 → 性能函数操作后

②ajax 异步填充数据 demo

<!-- ************ 非级联格局 ************ -->

<div id="trigger6"></div>

<script type="text/javascript">
    var mobileSelect6 = new MobileSelect({
        trigger: '#trigger6',
        title: 'ajax 填充数据 - 非级联',
        wheels: [
                    {data:[{id:'1',value:'请抉择地区'},
                    ]},
                    {data:[{id:'1',value:'请抉择间隔'},
                    ]}
                ],
        callback:function(indexArr, data){console.log(data);
        }
    });

    $.ajax({
        type: "POST",
        url: "xxxx",
        data: {},
        dataType: "json",
        success: function(res){
            // 这里假如获取到的 res.data.area 为：// [//     {id:'1',value:'左近'},
            //     {id:'2',value:'福田区'},
            //     {id:'3',value:'罗湖区'},
            //     {id:'4',value:'南山区'}
            // ]

            // 这里假如获取到的 res.data.distance 为：// [//     {id:'1',value:'200 米'},
            //     {id:'2',value:'300 米'},
            //     {id:'3',value:'400 米'}
            // ]

            mobileSelect6.updateWheel(0, res.data.area); // 更改第 0 个轮子
            mobileSelect6.updateWheel(1, res.data.distance); // 更改第 1 个轮子
        }
    });
</script>
</script>

<!-- ************ 级联格局 ************ -->

<div id="trigger7"></div>

<script type="text/javascript">
    var mobileSelect7 = new MobileSelect({
        trigger: '#trigger7',
        title: 'ajax 填充数据 - 级联',
        wheels: [
                    {data:[
                        {
                            id:'1',
                            value:'',
                            childs:[{id:'A1',value:''},
                            ]
                        }
                    ]}
                ],
        callback:function(indexArr, data){console.log(data);
        }
    });

    $.ajax({
        type: "POST",
        url: "xxxx",
        data: {},
        dataType: "json",
        success: function(res){
            // 这里假如获取到的 res.data 为：// [{
            //     id:'1',
            //     value:'更新后数据',
            //     childs:[//         {id:'A1',value:'apple'},
            //         {id:'A2',value:'banana'},
            //         {id:'A3',value:'orange'}
            //     ]
            // }]
            mobileSelect7.updateWheels(res.data);
        }
    });
</script>

如何回显抉择的地位

callback 回调函数里有一个 indexArr 参数，它是一个数组，记录着以后选中的地位：
把这个数组转化为字符串之后，能够用 <input type=”hidden” value=””> 暗藏域或者别的其余形式保留下来，传给后盾。
下次关上页面时，
MobileWindow 实例化的时候，读取这个字符串，再转成数组，传给 position，实现初始化定位即可。

我的项目 demo：

应用 transitionEnd()、callback()、updateWheel()、locatePosition() 函数实现如下性能：

• 抉择当天日期时，不得超过明天已过时刻。
• 抉择取车工夫后，还车工夫不得超过取车工夫（包含日期和工夫）。

更新日志

2020-07-03[更新]

• 减少应用标签切换不同滑动框性能
• 去除点击某选项后，主动扭转 div 的内容，改为返回点选的后果

2020-07-05[更新 + 修改]

• 修复标签切换后，多级联显示谬误的问题
• 减少弹出输入框性能

2020-07-08[更新 + 修改]

• 减少输入框内容验证

2020-07-10[修改]

• 调整我的项目构造

2020-07-11[修改]

• 优化例子代码
• 编写例子阐明

许可证

Copyright (c) 2020-present, Abbott Liu