saven
Version:
50 lines (40 loc) • 5.69 kB
Markdown
picker
## API
##### 普通选择器:mode = selector
| | 属性 | 类型 | 默认值 | 说明 |
| --- | ---------- | -------------------- | ------ | ------------------------------------------------------------------------------------------- |
| √ | range | Array / Object Array | [] | mode 为 selector 或 multiSelector 时,range 有效 |
| √ | rangeKey | String | | 当 range 是一个 Object Array 时,通过 rangeKey 来指定 Object 中 key 的值作为选择器显示内容 |
| √ | value | Number | 0 | value 的值表示选择了 range 中的第几个(下标从 0 开始) |
| √ | bindchange | EventHandle | | value 改变时触发 change 事件,event.detail = value: value |
| √ | bindcancel | EventHandle | | 取消选择或点遮罩层收起 picker 时触发 |
| √ | disabled | Boolean | false | 是否禁用 |
##### 多列选择器:mode = multiSelector
| | 属性 | 类型 | 默认值 | 说明 |
| --- | ---------------- | ------------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| √ | range | 二维 Array / 二维 Object Array | [] | mode 为 selector 或 multiSelector 时,range 有效。二维数组,长度表示多少列,数组的每项表示每列的数据,如[["a","b"], ["c","d"]] |
| √ | rangeKey | String | | 当 range 是一个 二维 Object Array 时,通过 rangeKey 来指定 Object 中 key 的值作为选择器显示内容 |
| √ | value | Array | [] | value 每一项的值表示选择了 range 对应项中的第几个(下标从 0 开始) |
| √ | bindchange | EventHandle | | value 改变时触发 change 事件,event.detail = value: value |
| √ | bindcolumnchange | EventHandle | | 某一列的值改变时触发 columnchange 事件,event.detail = column: column, value: value,column 的值表示改变了第几列(下标从 0 开始),value 的值表示变更值的下标 |
| √ | bindcancel | EventHandle | | 取消选择时触发 |
| √ | disabled | Boolean | false | 是否禁用 |
##### 多列选择器:mode = time
| | 属性 | 类型 | 默认值 | 说明 |
| --- | ---------- | ----------- | ------ | --------------------------------------------------------- |
| √ | value | String | | 表示选中的时间,格式为"hh:mm" |
| √ | start | String | | 表示有效时间范围的开始,字符串格式为"hh:mm" |
| √ | end | String | | 表示有效时间范围的结束,字符串格式为"hh:mm" |
| √ | bindchange | EventHandle | | value 改变时触发 change 事件,event.detail = value: value |
| √ | bindcancel | EventHandle | | 取消选择或点遮罩层收起 picker 时触发 |
| √ | disabled | Boolean | false | 是否禁用 |
##### 多列选择器:mode = date
| | 属性 | 类型 | 默认值 | 说明 |
| --- | ---------- | ----------- | ---------- | --------------------------------------------------------- |
| √ | value | String | new Date() | 表示选中的日期,格式为"YYYY-MM-DD" |
| √ | start | String | 1970-01-01 | 表示有效日期范围的开始,字符串格式为"YYYY-MM-DD" |
| √ | end | String | 2999-01-01 | 表示有效日期范围的结束,字符串格式为"YYYY-MM-DD" |
| √ | fields | String | day | 有效值 year,month,day,表示选择器的粒度 |
| √ | bindchange | EventHandle | | value 改变时触发 change 事件,event.detail = value: value |
| √ | bindcancel | EventHandle | | 取消选择或点遮罩层收起 picker 时触发 |
| √ | disabled | Boolean | false | 是否禁用 |