uniapp中uview组件库中丰富的Picker 选择器用法

基本使用

• 通过show绑定一个布尔值变量，用于控制组件的弹出与收起。
• 都通过传入数组columns配置选择项。

#多列模式与多列联动

此模式通过传入columns参数，此参数为二维数组，通过change事件完成联动操作。

#加载状态

由于需要多列联动，此模式和上面的"多列模式"基本相同，在加载之前将loading设置为true，数据获取完成之后再置为false即可。

#自定义选项值

参数columns可以传入自定义选项值，可以通过keyName参数控制对应的显示属性。

#默认值

此组件的所有模式，都可以设置默认值，通过defaultIndex数组参数配置，数组元素的0表示选中每列的哪个值(从0开始)，下面分别对几种模式进行说明：

注意： defaultIndex数组的长度，必须与列数相同，否则无效。

1. 单列模式

如设置defaultIndex为[1]表示默认选中第2个(从0开始)，[5]表示选中第6个。

1. 多列模式

如设置defaultIndex为[1, 3]表示第一列默认选中第2个，第二列默认选中第4个。

API

#Props

参数	说明	类型	默认值	可选值
show	用于控制选择器的弹出与收起	Boolean	false	true
showToolbar	是否显示顶部的操作栏	Boolean	true	false
title	顶部中间的标题	String	-	-
columns	设置每一列的数据，见上方说明	Array	-	-
loading	加载状态	Boolean	false	true
itemHeight	各列中，单个选项的高度	String | Number	44	-
cancelText	取消按钮的文字	String	取消	-
confirmText	确认按钮的文字	String	确认	-
cancelColor	取消按钮的颜色	String	#909193	-
confirmColor	确认按钮的颜色	String	#3c9cff	-
visibleItemCount	每列中可见选项的数量	String | Number	5	-
keyName	自定义需要展示的text属性键名	String	text	-
closeOnClickOverlay	是否允许点击遮罩关闭选择器（注意：关闭事件需要自行处理，只会在开启closeOnClickOverlay后点击遮罩层执行close回调）	Boolean	false	true
defaultIndex	各列的默认索引	Array	-	-
immediateChange 2.0.22	是否在手指松开时立即触发change事件。若不开启则会在滚动动画结束后触发change事件，只在微信2.21.1及以上有效	Boolean	false	true

#Methods

名称	说明
setIndexs	(index, setLastIndex) 设置对应列的选择值
setColumnValues	多列联动时需要用到，见上方说明，注意微信小程序的特殊用法

#Events

事件名	说明	回调参数	版本
close	关闭选择器时触发	-	-
confirm	点击确定按钮，返回当前选择的值	Array: 见上方"回调参数"部分说明	-
change	当选择值变化时触发	Array: 见上方"回调参数"部分说明	-
cancel	点击取消按钮	-	-