选择器 Picker
表单 · 可交互组件
基础选项选择器
按需导入
wbbb-ui/components/picker基础用法
<script setup lang="ts">
import { ref } from 'vue'
import { WbbbPicker } from 'wbbb-ui/components/picker'
import 'wbbb-ui/styles/picker'
const value = ref('')
</script>
<template>
<WbbbPicker v-model="value" />
</template>状态与交互
以下状态均可在右侧的真实 Playground 中操作与验收。
默认已填写焦点禁用错误
API 参考
属性(Props)
| 属性 | 说明 | 类型 | 默认值 | 必填 |
|---|---|---|---|---|
disabled | 是否禁止用户与组件交互。 | boolean | false | 否 |
locale | 覆盖组件内置文案使用的语言。 | WbbbLocaleInput | — | 否 |
modelValue | 提供 v-model 使用的当前值。 | string \| number | '' | 否 |
options | 提供可选择的选项数据。 | WbbbPickerOption[] | () => [] | 否 |
placeholder | 设置尚未输入或选择时的占位文案。 | string | 由 locale 决定 | 否 |
事件(Events)
update:modelValuechange
插槽(Slots)
无
双向绑定
支持 v-model(modelValue)。
平台说明
构建验证:H5、App Vue、微信小程序、支付宝小程序与抖音小程序。
运行时差异:H5 支持键盘焦点与减弱动效;小程序端使用等价触控交互。上传、日期选择和服务弹层应在目标端再次验收。
使用提示:更多状态组合和跨端表现请在 Playground 中验证。
