跳到主要内容
版本:3.x

PickerView

嵌入页面的滚动选择器 其中只可放置 picker-view-column 组件,其它节点不会显示

支持情况:

参考文档

类型

ComponentType<PickerViewProps>

示例代码

export default class Picks extends Component {

constructor () {
super(...arguments)
const date = new Date()
const years = []
const months = []
const days = []
for (let i = 1990; i <= date.getFullYear(); i++) {
years.push(i)
}
for (let i = 1; i <= 12; i++) {
months.push(i)
}
for (let i = 1; i <= 31; i++) {
days.push(i)
}
this.state = {
years: years,
year: date.getFullYear(),
months: months,
month: 2,
days: days,
day: 2,
value: [9999, 1, 1]
}
}

onChange = e => {
const val = e.detail.value
this.setState({
year: this.state.years[val[0]],
month: this.state.months[val[1]],
day: this.state.days[val[2]],
value: val
})
}

render() {
return (
<View>
<View>{this.state.year}{this.state.month}{this.state.day}</View>
<PickerView indicatorStyle='height: 50px;' style='width: 100%; height: 300px;' value={this.state.value} onChange={this.onChange}>
<PickerViewColumn>
{this.state.years.map(item => {
return (
<View>{item}</View>
);
})}
</PickerViewColumn>
<PickerViewColumn>
{this.state.months.map(item => {
return (
<View>{item}</View>
)
})}
</PickerViewColumn>
<PickerViewColumn>
{this.state.days.map(item => {
return (
<View>{item}</View>
)
})}
</PickerViewColumn>
</PickerView>
</View>
)
}
}

PickerViewProps

参数类型默认值必填说明
valuenumber[]数组中的数字依次表示 picker-view 内的 picker-view-column 选择的第几项(下标从 0 开始),数字大于 picker-view-column 可选项长度时,选择最后一项。
defaultValuenumber[]设置 React 非受控状态下的初始取值
indicatorStylestring设置选择器中间选中框的样式
indicatorClassstring设置选择器中间选中框的类名
maskStylestring设置蒙层的样式
maskClassstring设置蒙层的类名
immediateChangebooleanfalse是否在手指松开时立即触发 change 事件。若不开启则会在滚动动画结束后触发 change 事件。
titlestring选择器标题,建议标题控制在 12 个中文汉字长度内,避免出现截断现象, 截断部分将以 ... 形式展示
ariaLabelstring无障碍访问,(属性)元素的额外描述
onChangeCommonEventFunction<onChangeEventDetail>当滚动选择,value 改变时触发 change 事件,event.detail = {value: value};value为数组,表示 picker-view 内的 picker-view-column 当前选择的是第几项(下标从 0 开始)
onPickStartCommonEventFunction当滚动选择开始时候触发事件
onPickEndCommonEventFunction当滚动选择结束时候触发事件

API 支持度

API微信小程序百度小程序支付宝小程序抖音小程序QQ 小程序京东小程序H5React NativeHarmony
PickerViewProps.value✔️✔️✔️✔️✔️✔️✔️
PickerViewProps.defaultValue✔️✔️✔️✔️✔️✔️✔️
PickerViewProps.indicatorStyle✔️✔️✔️✔️✔️✔️✔️
PickerViewProps.indicatorClass✔️✔️✔️✔️✔️✔️
PickerViewProps.maskStyle✔️✔️✔️✔️✔️✔️
PickerViewProps.maskClass✔️✔️✔️✔️✔️✔️
PickerViewProps.immediateChange✔️✔️✔️
PickerViewProps.title✔️
PickerViewProps.ariaLabel✔️
PickerViewProps.onChange✔️✔️✔️✔️✔️✔️✔️
PickerViewProps.onPickStart✔️✔️✔️✔️
PickerViewProps.onPickEnd✔️✔️✔️✔️

onChangeEventDetail

参数类型
valuenumber[]