更新记录

6.0(2019-09-18)

修复date类型下设置dateFormatArray无效问题

5.0(2019-09-07)

1、新增mode、zIndex、lineHeight、bgColor_title、autoHide、titleColor、contentColor等属性 详见1.

2、buttonSet中 新增 cancleColor、confirmColor等属性 详见1.0.2

4.0(2019-06-22)

修复从后端获取数据拼接并赋值后不能正常使用问题

查看更多

平台兼容性

可直接拖进项目运行

QQ交流群: 750104037 点我加入


作者想说

如果该插件有什么问题还请大家说出来哦,还有如果有什么建议的话也可以提下呐 ~ 如果觉得好用,可以回来给个五星好评么~~(❁´◡`❁)*✲゚* 蟹蟹~拜托啦~


组件简介

提取了inputs组件的picker类型合集,参考了Color-Ui的模态框展示方式

该插件在支付宝小程序不能运行, 推荐使用QS-inputs-split中的picker,兼容性更强,并且更好用


更新说明

版本号 更新说明
6.0 修复date类型下设置dateFormatArray无效问题
5.0 1、新增mode、zIndex、lineHeight、bgColor_title、autoHide、titleColor、contentColor等属性 详见1.
2、buttonSet中 新增 cancleColor、confirmColor等属性 详见1.0.2
4.0 修复从后端获取数据拼接赋值后不能使用问题
3.0 1、废弃show属性,展示方式请使用ref调用show方法
2、新增title属性,为picker的标题, title文字的大小为picker内的文字大小系数上加.002
3、优化button按钮的文字大小为picker内的文字大小系数上加.005
4、新增并更改@showQSPicker、@hideQSPicker为picker显示或隐藏时的回调
2.0 1、新增showReset属性(每次显示是否重置)
2、修复date类型
3、完善文档

显示picker:this.$refs.自定义的ref名称.show();

隐藏picker:this.$refs.自定义的ref名称.hide(); (一般不用,选择后自动隐藏)

1. 传给QS-picker的属性

属性名 是否必填 值类型 默认值 说明
show(废弃, 请使用ref调用show方法) Boolean false 控制picker显示或隐藏
type String picker的类型, 详见1.0.0
dataSet Object 各类型携带的数据, 详见1.0.1
pickerId String 自定义的picker标识
height Number .3 picker的高度, 设备的高度乘以此数值
indicator_style String 'height:' + (Sys.screenHeight*.09) + 'px;' picker的单行样式
fontscale Number .02 picker内的字体大小, 设备高度乘以此数值
width Number .8 picker的宽度, 设备宽度乘以此数值
fontscale Number .02 picker内的字体大小, 设备高度乘以此数值
buttonSet Object 按钮设置, 详见1.0.2
@hideQSPicker Function 取消或确定选择的隐藏picker回调
@showQSPicker Function 取消或确定选择的隐藏picker回调
@confirm Function 确定选择时的回调, 携带用户选择的数据并自动触发@hideQSPicker
showReset(2.0新增) Boolean 每次显示时是否重置picker的value为初始化
title(3.0新增) String picker的标题
v5.0新增
mode String middle 展示模式, 详见 1.0.3
zIndex Number|String 9999 z-index属性
lineHeight Number .09 picker内单行高度系数
bgColor_title Color #F8F8F8 title块背景颜色
autoHide Boolean true 用户确定选择后是否自动隐藏
titleColor Color #999 title的文字颜色
contentColor Color black picker-view内的文字颜色

1.0.0 type属性说明

说明
date 日期时间
city 省市区
provincialStreet 省市区乡镇街道
custom 自定义
custom2 自定义2, 比custom返回数据更简单

1.0.1 dataSet属性说明

1.0.1.0.1 date类型

属性名 是否必填 值类型 默认值 说明
startYear Number new Date().getFullYear() - 5 开始年数
endYear Number new Date().getFullYear() + 5 结束年数
defaultValue String 此刻 格式为2019/05/27 10:54:002019/05/27的初始日期
dateMode Number 3 取值为1-6的值,依次从左向右为年、月、日、时、分、秒的列数
dateFormatArray Array ['-', '-', ' ', ':', ':'] 确认选择后返回的格式,依次是年、月、日、时、分、秒之间的分隔符

示例代码:

{
  startYear: 2018,
  endYear: 2020,
  defaultValue: "2019/05/27 10:54:00",
  dateMode: 3,
  dateFormatArray: ['-', '-', ' ', ':', ':']
}

1.0.1.0.2 city类型

属性名 是否必填 值类型 默认值 说明
defaultValue Array [0,0,0] 初始值

示例代码:

{
 defaultValue: [0,0,0]
}

1.0.1.0.3 provincialStreet类型

属性名 是否必填 值类型 默认值 说明
defaultValue Array [0,0,0,0] 初始值

示例代码:

{
 defaultValue: [0,0,0,0]
}

1.0.1.0.4 custom类型

属性名 是否必填 值类型 默认值 说明
itemArray Array 需循环展示的数据
defaultValue Array 初始值
linkage Boolean false 是否联动
linkageNum Number 联动级数
steps Object 自定义阶级变量名,详见下方示例与说明

1.0.1.0.4.0.1 custom的steps属性说明

属性名 是否必填 值类型 默认值 说明
step_1_value String 一级显示属性名
step_2_value String 二级显示属性名
step_2_item String 二级联动数组属性名
step_3_value String 三级显示属性名
step_3_item String 三级联动数组属性名

注:详见下方示例

示例代码:

{
  itemArray: [{
  value_1: "江西", //value_1变量名需与下方steps.steps_1_value相同
  /*
  可添加多项自定义想要的数据
  */
  item_2: [{ //item_2变量名需与下方steps.steps_2_item相同
    value_2: "南昌", //value_2变量名需与下方steps.steps_2_value相同
    /*
    可添加多项自定义想要的数据
    */
    item_3: [{ //item_3变量名需与下方steps.steps_3_item相同
        name: "东湖", //name变量名需与下方steps.steps_3_value相同
        /*
        可添加多项自定义想要的数据
        */
    }]
  }, {
    value_2: "九江",
    item_3: [{
        "name": "德安"
    }]
  }]
  }, {
  value_1: "山东",
  item_2: [{
    value_2: "济南",
    item_3: [{
        name: "历下"
    }],
  }, {
    value_2: "青岛",
    item_3: [{
        name: "市南"
    }]
  }]
  }],
  steps: {
  step_1_value: "value_1",
  step_2_value: "value_2",
  step_2_item: "item_2",
  step_3_value: "name",
  step_3_item: "item_3"
  },
  linkageNum: 3, //3 表示为3级联动
  linkage: true //true 表示开启联动
}

1.0.1.0.5 custom2类型

属性名 是否必填 值类型 默认值 说明
itemArray Array 需循环展示的数据(无联动使用此属性)
itemObject Object 需循环展示的数据(联动使用此属性)
defaultValue Array 初始值
linkage Boolean false 是否联动
linkageNum Number 联动级数
steps Object 自定义阶级变量名,详见下方示例与说明

1.0.1.0.5.0.1 custom2的steps属性说明

属性名 是否必填 值类型 默认值 说明
step_1_value String 一级显示属性名
step_2_value String 二级显示属性名
step_3_value String 三级显示属性名

注:详见下方示例

示例代码:

{
  itemObject: {
    step_1: [{
        name: "江西"
    }, {
        name: "山东"
    }],
    step_2: [
        ["南昌", "九江"], //对应step_1的江西
        ["济南", "青岛"] //对应step_1的山东
    ],
    step_3: [
        [
            [ //对应step_2的南昌
                "东湖"
            ],
            [ //对应step_2的九江
                "德安"
            ]
        ],
        [
            [ //对应step_2的济南
                "历下",
            ],
            [ //对应step_2的青岛
                "市南",
            ]
        ]
    ]
  },
  steps: {
    step_1_value: "name", //第一级显示的属性名
    step_2_value: "", //第二级显示的属性名
    step_3_value: "" //第三级显示的属性名
  },
  defaultValue: [1, 0, 0], //初始数据
  linkageNum: 3, //3 表示为3级联动
  linkage: true //true 表示开启联动
}

1.0.2 buttonSet属性说明

值类型 默认值 说明
cancelType String default 取消按钮的类型
confirmType String primary 确定按钮的类型
cancelStyle cssStyle 取消按钮的样式, 只支持middle模式
confirmStyle cssStyle 确定按钮的样式, 只支持middle模式
cancelName String 取消 取消按钮名称
confirmName String 确定 确定按钮名称
v5.0更新
cancleColor Color #ADADAD 取消按钮的颜色,不支持middle模式
confirmColor Color #3399FF 确定按钮的颜色,不支持middle模式

1.0.3 mode属性说明

说明
middel 从中间渐出
top 从顶部弹出
bottom 从底部弹出(默认)

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问