jc-task-mini/miniprogram_npm/tdesign-miniprogram/picker/README.md

title	description	spline	isComponent
Picker 选择器	用于一组预设数据中的选择。	form	true

引入

全局引入，在 miniprogram 根目录下的app.json中配置，局部引入，在需要引入的页面或组件的index.json中配置。

"usingComponents": {
  "t-picker": "tdesign-miniprogram/picker/picker",
  "t-picker-item": "tdesign-miniprogram/picker-item/picker-item",
}

代码演示

组件类型

基础选择器

单项和多选选择

{{ base }}

地区选择器

支持省市区切换，支持数据联动

{{ area }}

组件状态

是否带标题

{{ with-title }}

API

Picker Props

名称	类型	默认值	说明	必传
auto-close	Boolean	true	自动关闭；在确认、取消、点击遮罩层自动关闭，不需要手动设置 visible	N
cancel-btn	String / Boolean / Object	true	取消按钮文字。TS 类型：boolean | string | ButtonProps	N
columns	Array / Function	[]	必需。配置每一列的选项。TS 类型：Array<PickerColumn> | ((item: Array<PickerValue>) => Array<PickerColumn>) type PickerColumn = PickerColumnItem[] interface PickerColumnItem { label: string,value: string}。详细类型定义	Y
confirm-btn	String / Boolean / Object	true	确定按钮文字。TS 类型：boolean | string | ButtonProps，Button API Documents。详细类型定义	N
footer	Slot	-	已废弃。底部内容	N
header	Boolean / Slot	true	头部内容。值为 true 显示空白头部，值为 false 不显示任何内容，值类型为 TNode 表示自定义头部内容	N
render-label	String / Function	-	自定义label。TS 类型：(item: PickerColumnItem) => string	N
title	String	''	标题	N
value	Array	-	选中值。TS 类型：Array<PickerValue> type PickerValue = string | number。详细类型定义	N
default-value	Array	undefined	选中值。非受控属性。TS 类型：Array<PickerValue> type PickerValue = string | number。详细类型定义	N
visible	Boolean	false	是否显示	N

Picker Events

名称	参数	描述
cancel	-	点击取消按钮时触发
change	(value: Array<PickerValue>, label: string, columns: Array<{ column: number; index: number }> )	选中变化时候触发，即确认变化时触发
close	(trigger: TriggerSource)	1.0.1。关闭时触发。详细类型定义。 type TriggerSource = 'overlay' | 'cancel-btn' | 'confrim-btn'
confirm	(value: Array<PickerValue>, label: string, columns: Array<{ column: number; index: number }> )	点击确认按钮时触发
pick	(value: Array<PickerValue>, label: string, column: number, index: number)	任何一列选中都会触发，不同的列参数不同。column 表示第几列变化，index 表示变化那一列的选中项下标

PickerItem Props

名称	类型	默认值	说明	必传
format	Function	-	格式化标签。TS 类型：(option: PickerItemOption) => string	N
options	Array	[]	数据源。TS 类型：PickerItemOption[] interface PickerItemOption { label: string; value: string | number }。详细类型定义	N