Skip to content

PickerGroup 选择器组

介绍

用于结合多个 Picker 选择器组件,在一次交互中完成多个值的选择。

PickerGroup 中可以放置以下组件:

基础用法

通过 active 激活标签栏。

html
<vd-picker-group
  title="选择日期时间"
  @confirm="handleConfirm"
  @cancel="handleCancel"
>
  <vd-picker-date v-model="picker.date" title="选择日期" />
  <vd-picker-time v-model="picker.time" title="选择时间" />
</vd-picker-group>
ts
import { PickerGroupSelectData } from 'vital-design';

const picker = reactive({
  date: [],
  time: [],
});

// 确认操作
function handleConfirm(data: PickerGroupSelectData) {
  ...
}

// 取消操作
function handleCancel(data: PickerGroupSelectData) {
  ...
}

下一步按钮

为了保证用户能够依次选择所有的 Picker,你可以通过 next-step-text 定义下一步按钮操作,如果用户未切换到最后一个标签页,那么右上角的按钮会变成 「下一步」,当用户切换到最后一个标签页时,右上角的按钮会变为 「确认」

html
<vd-picker-group
  title="选择日期时间"
  next-step-text="下一步"
  @confirm="handleConfirm"
  @cancel="handleCancel"
>
  <vd-picker-date v-model="picker.date" title="选择日期" />
  <vd-picker-time v-model="picker.time" title="选择时间" />
</vd-picker-group>
ts
import { PickerGroupSelectData } from 'vital-design';

const picker = reactive({
  date: [],
  time: [],
});

// 确认操作
function handleConfirm(data: PickerGroupSelectData) {
  ...
}

// 取消操作
function handleCancel(data: PickerGroupSelectData) {
  ...
}

API

Props

参数说明类型默认值
active激活标签number-
title标题string-
titles标题列表,用于标签页展示,默认根据子选择器标题自动生成string-
title标题string-
next-step-text下一步按钮文字string-
confirm-button-text确认按钮文字string-
cancel-button-text取消按钮文字string-

代替原始 Props

参数说明类型默认值
custom-id根节点idstring-
custom-class根节点类名ClassValue-
custom-style根节点样式StyleValue-

Events

事件名说明回调参数
click点击时触发MouseEvent
confirm确认时触发PickerGroupSelectData[]
cancel取消时触发PickerGroupSelectData[]

Slots

名称说明
default选择器内容
toolbar工具栏

赣ICP备2025061025号-1