Wheel Picker

从旋转滚轮中选择数值,支持惯性与行吸附。

适用场景

  • 当界面需要以下行为时使用 Wheel Picker:从旋转滚轮中选择数值,支持惯性与行吸附。

安装

选择安装方式,用法示例将同步更新导入路径。

$ bunx --bun shadcn-vue@2.8.2 add https://orvui.efu.me/r/wheel-picker.json https://orvui.efu.me/r/switch.json

首次使用时,将安装的 src/components/orvui/styles.css 导入项目样式入口。

示例

预览

Born June 9, 2004
January
February
March
April
May
June
July
August
September
October
November
December
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
1980
1981
1982
1983
1984
1985
1986
1987
1988
1989
1990
1991
1992
1993
1994
1995
1996
1997
1998
1999
2000
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
2027
2028
2029
2030
2031
2032
2033
2034
2035
2036
2037
2038
2039

状态与事件

需要由表单、路由或父组件管理时,绑定下列状态并接收对应更新。v-model 是属性与 update 事件的简写;值的类型应与 API 一致。

组件状态绑定
组件Vue 绑定更新事件
WheelPickerv-modelstringupdate:modelValue

可选受控属性未传入时,按组件文档的默认行为工作;不要用固定的 false 或空值代替未传入。异步请求和持久化在应用中处理,再把结果传回组件。

API 参考

options
WheelPickerOption[]
—
modelValue?
string
—
defaultValue?
string
—
visibleCount?
number
5
itemHeight?
number
36
disabled?
boolean
false
sound?
boolean
false
ariaLabel?
string
—

事件

update:modelValue
—
@update:modelValue
change
—
@change

无障碍

为交互控件提供明确的无障碍名称。保留文档中的键盘路径、可见焦点与减少动态效果状态;自定义插槽应继续保留所替代部件的语义。

常见问题

如何配置 Wheel Picker?
通过 options、modelValue、defaultValue、visibleCount、itemHeight、disabled、sound、ariaLabel 配置 Wheel Picker;API 表列出其类型与默认值。
如何连接到应用状态?
监听 update:modelValue、change,将组件连接到应用状态。
可以在服务端渲染吗?
可以在 Vue SSR 应用中正常渲染。服务端与客户端的初始 props 应保持一致;浏览器测量与交互资源在挂载后启动。

更新于