Primitives

跨端无样式交互契约：@varo-ui/headless 管状态，目标端 primitives 管渲染。

安装

# H5
pnpm add @varo-ui/headless @varo-ui/h5

# 小程序
pnpm add @varo-ui/headless @varo-ui/weapp

小程序接入

全局样式与 Tailwind 配置见 Wevu Registry。

运行时

包	用途
@varo-ui/headless	平台中立状态与事件
@varo-ui/h5/primitives	DOM、键盘与 ARIA
@varo-ui/weapp/primitives	WXML、触摸与原生事件

目录

基础控件

2

Button打开文档

统一 pressed、disabled、loading 与原生激活语义。

Parts ButtonRoot / usePressableRoot

Input打开文档

文本值、格式化、只读、校验与输入事件基座。

Parts InputRoot / useFieldRoot

选择与切换

6

Number Field打开文档

数值边界、步进、精度与组合式加减控件。

Parts NumberFieldRoot / Decrement / Input / Increment

Checkbox打开文档

选中态、禁用态与 indicator 渲染契约。

Parts CheckboxRoot / CheckboxIndicator

Radio Group打开文档

单选组 value 与选项级 disabled 语义。

Parts RadioGroup / RadioItem / RadioIndicator

Switch打开文档

开关态、loading 与 disabled 契约。

Parts SwitchRoot / SwitchThumb

Tabs打开文档

当前 tab value、orientation 与 panel 关联。

Parts TabsRoot / TabsList / TabsTrigger / TabsContent

Select打开文档

选择器状态、open 契约与选项组合。

Parts SelectRoot / Trigger / Value / Content / Item

内容与布局

3

Image打开文档

图片加载、失败、占位与尺寸适配状态。

Parts ImageRoot / useImageRoot

Cell打开文档

列表行、设置项、链接行与键盘激活契约。

Parts CellGroupRoot / CellRoot

Sticky打开文档

吸顶状态、偏移量与滚动事件适配。

Parts StickyRoot

展开与轻浮层

3

Collapsible打开文档

单个展开区域的 open 状态契约。

Parts CollapsibleRoot / Trigger / Content

Accordion打开文档

single/multiple 展开集合与 item disabled。

Parts AccordionRoot / Item / Trigger / Content

Popover打开文档

轻量浮层开关与显式 dismiss 契约。

Parts PopoverRoot / Trigger / Content / Close

遮罩与弹层

3

Dialog打开文档

模态打开态、遮罩、内容与退出动作。

Parts DialogRoot / Trigger / Overlay / Content / Close

Overlay打开文档

遮罩可见态、点击关闭与滚动锁定。

Parts OverlayRoot

Popup打开文档

带定位、遮罩、安全区与关闭行为的弹出层。

Parts PopupRoot