PickerView
嵌入页面的滚动选择器 其中只可放置 picker-view-column 组件,其它节点不会显示
支持情况:
类型
ComponentType<PickerViewProps>
示例代码
- React
- Vue
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>
)
}
}
<template>
<view class="taro-example">
<view>{{year}}年{{month}}月{{day}}日</view>
<picker-view indicator-style="height: 30px;" style="width: 100%; height: 300px;" :value="value" @change="onChange">
<picker-view-column>
<view v-for="(item, index) in years" :key="index">{{item}}年</view>
</picker-view-column>
<picker-view-column>
<view v-for="(item, index) in months" :key="index">{{item}}月</view>
</picker-view-column>
<picker-view-column>
<view v-for="(item, index) in days" :key="index">{{item}}日</view>
</picker-view-column>
</picker-view>
</view>
</template>
<script>
export default {
name: "Index",
data() {
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)
}
return {
years: years,
year: date.getFullYear(),
months: months,
month: 2,
days: days,
day: 2,
value: [3, 1, 1]
}
},
methods: {
onChange: function(e) {
const val = e.detail.value
console.log(val)
this.year = this.years[val[0]]
this.month = this.months[val[1]]
this.day = this.days[val[2]]
}
}
}
</script>
PickerViewProps
参数 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
value | number[] | 否 | 数组中的数字依次表示 picker-view 内的 picker-view-column 选择的第几项(下标从 0 开始),数字大于 picker-view-column 可选项长度时,选择最后一项。 | |
defaultValue | number[] | 否 | 设置 React 非受控状态下的初始取值 | |
indicatorStyle | string | 否 | 设置选择器中间选中框的样式 | |
indicatorClass | string | 否 | 设置选择器中间选中框的类名 | |
maskStyle | string | 否 | 设置蒙层的样式 | |
maskClass | string | 否 | 设置蒙层的类名 | |
immediateChange | boolean | false | 否 | 是否在手指松开时立即触发 change 事件。若不开启则会在滚动动画结束后触发 change 事件。 |
title | string | 否 | 选择器标题,建议标题控制在 12 个中文汉字长度内,避免出现截断现象, 截断部分将以 ... 形式展示 | |
ariaLabel | string | 否 | 无障碍访问,(属性)元素的额外描述 | |
onChange | CommonEventFunction<onChangeEventDetail> | 否 | 当滚动选择,value 改变时触发 change 事件,event.detail = {value: value};value为数组,表示 picker-view 内的 picker-view-column 当前选择的是第几项(下标从 0 开始) | |
onPickStart | CommonEventFunction | 否 | 当滚动选择开始时候触发事件 | |
onPickEnd | CommonEventFunction | 否 | 当滚动选择结束时候触发事件 |
API 支持度
API | 微信小程序 | 百度小程序 | 支付宝小程序 | 抖音小程序 | QQ 小程序 | 京东小程序 | H5 | React Native | Harmony |
---|---|---|---|---|---|---|---|---|---|
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
参数 | 类型 |
---|---|
value | number[] |