Back to Taro

taro-picker-group

packages/taro-components/src/components/picker/readme.md

4.2.07.6 KB
Original Source

taro-picker-group

API

普通选择器:mode = selector
属性类型默认值说明
rangeArray / Object Array[]mode 为 selector 或 multiSelector 时,range 有效
rangeKeyString当 range 是一个 Object Array 时,通过 rangeKey 来指定 Object 中 key 的值作为选择器显示内容
valueNumber0value 的值表示选择了 range 中的第几个(下标从 0 开始)
bindchangeEventHandlevalue 改变时触发 change 事件,event.detail = value: value
bindcancelEventHandle取消选择或点遮罩层收起 picker 时触发
disabledBooleanfalse是否禁用
多列选择器:mode = multiSelector
属性类型默认值说明
range二维 Array / 二维 Object Array[]mode 为 selector 或 multiSelector 时,range 有效。二维数组,长度表示多少列,数组的每项表示每列的数据,如[["a","b"], ["c","d"]]
rangeKeyString当 range 是一个 二维 Object Array 时,通过 rangeKey 来指定 Object 中 key 的值作为选择器显示内容
valueArray[]value 每一项的值表示选择了 range 对应项中的第几个(下标从 0 开始)
bindchangeEventHandlevalue 改变时触发 change 事件,event.detail = value: value
bindcolumnchangeEventHandle某一列的值改变时触发 columnchange 事件,event.detail = column: column, value: value,column 的值表示改变了第几列(下标从 0 开始),value 的值表示变更值的下标
bindcancelEventHandle取消选择时触发
disabledBooleanfalse是否禁用
多列选择器:mode = time
属性类型默认值说明
valueString表示选中的时间,格式为"hh:mm"
startString表示有效时间范围的开始,字符串格式为"hh:mm"
endString表示有效时间范围的结束,字符串格式为"hh:mm"
bindchangeEventHandlevalue 改变时触发 change 事件,event.detail = value: value
bindcancelEventHandle取消选择或点遮罩层收起 picker 时触发
disabledBooleanfalse是否禁用
多列选择器:mode = date
属性类型默认值说明
valueStringnew Date()表示选中的日期,格式为"YYYY-MM-DD"
startString1970-01-01表示有效日期范围的开始,字符串格式为"YYYY-MM-DD"
endString2999-01-01表示有效日期范围的结束,字符串格式为"YYYY-MM-DD"
fieldsStringday有效值 year,month,day,表示选择器的粒度
bindchangeEventHandlevalue 改变时触发 change 事件,event.detail = value: value
bindcancelEventHandle取消选择或点遮罩层收起 picker 时触发
disabledBooleanfalse是否禁用
<!-- Auto Generated Below -->

Properties

PropertyAttributeDescriptionTypeDefault
columnIdcolumn-idstringundefined
heightheightnumberundefined
modemode"date" | "time"undefined
range--any[][]
rangeKeyrange-keystringundefined
updateDay--((value: number, fields: number) => void) | undefinedundefined
updateHeight--(height: number, columnId: string, needRevise?: boolean | undefined) => voidundefined

Events

EventDescriptionType
columnChangeCustomEvent<any>

Methods

handleMoveEnd(clientY: number) => Promise<void>

Returns

Type: Promise<void>

handleMoveStart(clientY: number) => Promise<void>

Returns

Type: Promise<void>

handleMoving(clientY: number) => Promise<void>

Returns

Type: Promise<void>

Dependencies

Used by

Graph

mermaid
graph TD;
  taro-picker-core --> taro-picker-group
  style taro-picker-group fill:#f9f,stroke:#333,stroke-width:4px

Built with StencilJS