Skip to content

Commit

Permalink
init
Browse files Browse the repository at this point in the history
  • Loading branch information
Cople committed Jun 11, 2016
0 parents commit c27cd2d
Show file tree
Hide file tree
Showing 11 changed files with 978 additions and 0 deletions.
8 changes: 8 additions & 0 deletions LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
The MIT License (MIT)
Copyright (c) 2016 Cople

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
99 changes: 99 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,99 @@
# WheelPicker

仿 iOS UIPickerView 的滚动选择器

## 演示

[DEMO](http://cople.github.io/WheelPicker)

## 安装

```sh
npm install wheel-picker --save
```

## 使用

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

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

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

## 选项

| 参数 | 类型 | 默认值 | 描述 |
|-----|-----|-------|-------|
| title | string | null | 标题 |
| el | element | null | 选择器对应的 input 元素 |
| hideOnBackdrop | boolean | false | 点击遮罩层关闭组件(相当于取消) |
| data | array | [] | 每列的数据组成的数组 |
| value | array | [] | 每列的默认值组成的数组 |
| rows | number | 5 | 可见的行数(奇数) |
| rowHeight | number | 34 | 行高 |
| parseValue | function | `val => val.join(" ")` | 保存时填充到 el 元素的值 |
| onRender | function | null | 生成组件 DOM 时触发,参数为组件元素 |
| onShow | function | null | 显示组件时触发 |
| onChange | function | null | 滚动导致值变化时触发,参数为选中值和该列的索引值 |
| onSelect | function | null | 点击确定时触发,参数为值数组 |
| onCancel | function | null | 点击取消时触发 |

## 方法
### picker.getVal([index:number])
返回值数组或指定列的值

### picker.setVal(value:array)
### picker.setVal(value:string, index:number)
设置各列的值或指定列的值

### 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](http://opensource.org/licenses/MIT)
1 change: 1 addition & 0 deletions dist/wheelpicker.min.css

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

1 change: 1 addition & 0 deletions dist/wheelpicker.min.js

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading

0 comments on commit c27cd2d

Please sign in to comment.