乐趣区

前端mobileWindowjs框架001版正式发布不足之处望指出

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);

    }
});

参数

选项 默认值 类型 形容
trigger 必填参数 无默认值 String 触发对象的 id/class/tag
wheels 必填参数 无默认值 Array 数据源, 须要显示的数据
callback function(indexArr, data){} function 抉择胜利后触发的回调函数,返回 indexArr、data
transitionEnd function(indexArr, data){} function 每一次手势滑动完结后触发的回调函数, 返回 indexArr、data
cancel function(indexArr, data){} function 返回的是 indexArr 和 data 是上一次点击确认按钮时的值
onShow function(e){} function 显示控件后触发的回调函数, 返回参数为对象自身
onHide function(e){} function 暗藏控件后触发的回调函数, 返回参数为对象自身
title '' String 控件题目
position [0,0,0,…] Array 初始化定位
connector ' ' String 多个轮子时,多个值两头的连接符,默认是空格
ensureBtnText '确认' String 确认按钮的文本内容
cancelBtnText '勾销' String 勾销按钮的文本内容
ensureBtnColor '#1e83d3' String 确认按钮的文本色彩
cancelBtnColor '#666666' String 勾销按钮的文本色彩
titleColor '#000000' String 控件题目的文本色彩
titleBgColor '#ffffff' String 控件题目的背景色彩
textColor '#000000' String 轮子内文本的色彩
bgColor '#ffffff' String 轮子背景色彩
maskOpacity 0.7 Number 遮罩透明度
keyMap {id:'id', value:'value', childs:'childs'} Object 字段名映射,实用于字段名不匹配 id,value,childs 的数据格式
triggerDisplayData true Boolean 在点击确认时,trigger 的 innerHtml 是否变为抉择的数据。
(如果 trigger 外面还有其余元素,则能够设置为 false;如果须要在别的中央显示数据,则可用 callback 返回的数据自行拼接)

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

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

性能函数:

函数名 参数 形容
show() 无参 手动显示弹窗组件
hide() 无参 手动暗藏弹窗组件
setTitle() string 设置控件的题目
locatePosition() sliderIndex, posIndex 传入地位数组,从新定位轮子选中的地位
updateWheel() sliderIndex, data 从新渲染指定的轮子
updateWheels() data 从新渲染所有轮子 (仅限级联数据格式应用)
getValue() 无参 获取组件抉择的值

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

  • 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

退出移动版