PickerView - 《Taro 文档帮助手册教程》

sidebar_label: PickerView
类型
示例代码
PickerViewProps
- API 支持度
- onChangeEventDetail

title: PickerView

sidebar_label: PickerView

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

支持情况： PickerView - 图1 PickerView - 图2 PickerView - 图3 PickerView - 图4 PickerView - 图5 PickerView - 图6

参考文档

类型

ComponentType<PickerViewProps>

示例代码

import Tabs from ‘@theme/Tabs’ import TabItem from ‘@theme/TabItem’

tsx
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>
    )
  }
}

html
<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 可选项长度时，选择最后一项。
indicatorStyle	`string`		否	设置选择器中间选中框的样式
indicatorClass	`string`		否	设置选择器中间选中框的类名
maskStyle	`string`		否	设置蒙层的样式
maskClass	`string`		否	设置蒙层的类名
immediateChange	`boolean`	`false`	否	是否在手指松开时立即触发 change 事件。若不开启则会在滚动动画结束后触发 change 事件。
onChange	`CommonEventFunction<onChangeEventDetail>`		否	当滚动选择，value 改变时触发 change 事件，event.detail = {value: value}；value为数组，表示 picker-view 内的 picker-view-column 当前选择的是第几项（下标从 0 开始）
onPickStart	`CommonEventFunction`		否	当滚动选择开始时候触发事件
onPickEnd	`CommonEventFunction`		否	当滚动选择结束时候触发事件

API 支持度

API	微信小程序	百度小程序	支付宝小程序	字节跳动小程序	React Native
PickerViewProps.value	✔️	✔️	✔️	✔️	✔️
PickerViewProps.indicatorStyle	✔️	✔️	✔️	✔️	✔️
PickerViewProps.indicatorClass	✔️	✔️	✔️
PickerViewProps.maskStyle	✔️	✔️	✔️	✔️
PickerViewProps.maskClass	✔️	✔️	✔️
PickerViewProps.immediateChange	✔️
PickerViewProps.onChange	✔️	✔️	✔️	✔️	✔️
PickerViewProps.onPickStart	✔️
PickerViewProps.onPickEnd	✔️

onChangeEventDetail

参数	类型
value	`number[]`