Skip to content

选择器 Picker

选择器常用于选择一些已知选项。

基础使用

显示代码
vue
<template>
  <weui-picker
    v-model="pickerData"
    :options="pickerOptions"
    placeholder="请选择内容"
  ></weui-picker>
</template>

<script lang="ts" setup>
import { ref } from 'vue';

const pickerData = ref(1);
const pickerOptions = [
  { label: 'label1', value: 1, disabled: true },
  { label: 'label2', value: 2 },
  { label: 'label3', value: 3 },
  { label: 'label4', value: 4 },
  { label: 'label5', value: 5 }
];
</script>

API

Picker Props

名称类型默认值说明版本
modelValueany-选择器的值-
optionsPickerItem<T>[]PickerItem<T>[][];[]选择项
disabledbooleanfalse选择器是否禁用-
placeholderstring-默认占位提示-
isMultiboolean-是否多列选择器-
delimiterstring'/'多列选择值分割符-
confirmTextstring'确定'选择器确认按钮-
titlestring-选择器标题-
descstring-选择器描述-
containerstring'body'picker挂载节点-

Picker Events

名称描述参数版本
update:modelValue选择器选择值变更时回调((val: T | T[]) => void)-
selectChange选择器选择值改变时回调((val: PickerItem<T>[] | PickerItem<T>) => void)-
change选择器选择值确认时回调((val: PickerItem<T>[] | PickerItem<T>) => void)-