1.1.0 • Published 7 years ago

wheel-picker v1.1.0

Weekly downloads
15
License
MIT
Repository
github
Last release
7 years ago

WheelPicker

仿 iOS UIPickerView 的滚动选择器

演示

DEMO

安装

NPM

npm install wheel-picker --save

CDN

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/wheel-picker/dist/wheelpicker.min.css">
<script src="https://cdn.jsdelivr.net/npm/wheel-picker/dist/wheelpicker.min.js"></script>

使用

var frutis = ["草莓", "柠檬", "菠萝"];
var vegetables = [{
    text: "番茄",
    value: "tomato"
}, {
    text: "蘑菇",
    value: "mushroom"
}, {
    text: "土豆",
    value: "potato"
}];

var picker1 = new WheelPicker({
    title: "最爱的水果",
    data: [frutis],
    onSelect: function(selected) {
    	alert("你选择的是:" +  selected[0].text);
    }
});

var picker2 = new WheelPicker({
    title: "最爱的水果和蔬菜",
    el: "#demo",
    data: [frutis, vegetables],
    value: ["柠檬", "potato"],
    formatValue: function(value) {
    	return "你选择的分别是:" +  value.join("、");
    }
});

选项

参数类型默认值描述
titlestringnull标题
elelementnull选择器对应的 input 元素
hiddenInputbooleanfalse将 el.type 设置为 hidden 并用于保存 value 值;再 clone 一个 el 元素用于显示 text 值
hideOnBackdropbooleanfalse点击遮罩层关闭组件(相当于点击取消按钮)
dataarray[]每列的数据组成的数组
valuearray[]每列的默认值组成的数组
rowsnumber5可见的行数(奇数)
rowHeightnumber34行高
formatValuefunctionval => val.split(" ")从 el 元素获取默认值
parseValuefunctionval => val.join(" ")保存时填充到 el 或 cloneNode 的值
parseHiddenValuefunctionval => val.join(" ")保存时填充到 el 的值(如果 hiddenInput 为 true)
onRenderfunctionnull生成组件 DOM 时触发,参数为组件元素
onShowfunctionnull显示组件时触发
onChangefunctionnull滚动导致值变化时触发,参数为发生变化的列的索引值和选中项
onSelectfunctionnull点击确定时触发,参数为条目数组
onCancelfunctionnull点击取消时触发

方法

picker.getValue(index:number)

返回值数组或指定列的值

picker.setValue(value:array)

picker.setValue(value:string, index:number)

设置各列的值或指定列的值

picker.getSelectedItems()

返回选中的条目数组

picker.getData(index:nubmer)

返回数据数组或指定列的数据

picker.setData(data:array , value:array)

picker.setData(data:array, index:number , value:string)

设置各列或指定列的数据和值

picker.show()

显示组件

picker.hide()

隐藏组件

picker.enable()

启用组件

picker.disable()

禁用组件

picker.destory()

销毁组件

License

MIT

1.1.0

7 years ago

1.0.7

7 years ago

1.0.6

7 years ago

1.0.5

8 years ago

1.0.4

8 years ago

1.0.3

8 years ago

1.0.2

8 years ago

1.0.1

8 years ago

1.0.0

8 years ago