vant/docs/markdown/en-US/picker.md

Picker

Install

import { Picker } from 'vant';

Vue.use(Picker);

Usage

Basic Usage

<van-picker :columns="columns" @change="onChange" />

export default {
  data() {
    return {
      columns: ['Delaware', 'Florida', 'Georqia', 'Indiana', 'Maine']
    };
  },
  onChange(picker, value, index) {
    Toast(`Value: ${value}, Index: ${index}`);
  }
};

Disable option

<van-picker :columns="columns" />

export default {
  data() {
    return {
      columns: [
        { text: 'Delaware', disabled: true },
        { text: 'Florida' },
        { text: 'Georqia' }
      ]
    };
  }
};

Show Toolbar

<van-picker
  show-toolbar
  :title="Title"
  :columns="columns"
  @cancel="onCancel"
  @confirm="onConfirm"
/>

export default {
  data() {
    return {
      columns: ['Delaware', 'Florida', 'Georqia', 'Indiana', 'Maine']
    }
  },
  methods: {
    onConfirm(value, index) {
      Toast(`Value: ${value}, Index: ${index}`);
    },
    onCancel() {
      Toast('Cancel');
    }
  }
};

Multi columns

<van-picker :columns="columns" @change="onChange" />

const states = {
  'Group1': ['Delaware', 'Florida', 'Georqia', 'Indiana', 'Maine'],
  'Group2': ['Alabama', 'Kansas', 'Louisiana', 'Texas']
};

export default {
  data() {
    return {
      columns: [
        {
          values: Object.keys(states),
          className: 'column1'
        },
        {
          values: states.Group1,
          className: 'column2',
          defaultIndex: 2
        }
      ]
    };
  },
  methods: {
    onChange(picker, values) {
      picker.setColumnValues(1, states[values[0]]);
    }
  }
};

API

Attribute	Description	Type	Default	Accepted Values
columns	Columns data	Array	[]	-
show-toolbar	Whether to show toolbar	Boolean	false	-
title	Toolbar title	String	''	-
item-height	Option height	Number	44	-
visibile-column-count	Count of visible columns	Number	5	-
value-key	Key of option text	String	text	-

Data struct of columns

key	Description
values	Value of column
defaultIndex	Default value index
className	ClassName for this column

Picker instance

You can get the picker instance in 'change' event, and

Method	Description
getValues()	Get current values of all columns
setValues(values)	Set current values of all columns
getIndexes()	Get current indexes of all columns
setIndexes(indexes)	Set current indexes of all columns
getColumnValue(columnIndex)	Get current value of the column
setColumnValue(columnIndex, value)	Set current value of the column
getColumnIndex(columnIndex)	Get current index of the column
setColumnIndex(columnIndex, optionIndex)	Set current index of the column
getColumnValues(columnIndex)	Get columns data of the column
setColumnValues(columnIndex, values)	Set columns data of the column