Skip to content

Popover

轻量浮层运行时:Root 持有 open,Trigger 打开,Content 展示,Close 显式关闭。

运行时

状态契约由 @varo-ui/headless 提供;渲染 Parts 分别来自 @varo-ui/h5/primitives@varo-ui/weapp/primitives

演示

安装包@varo-ui/headless

安装

bash
pnpm add @varo-ui/headless @varo-ui/h5
# 或
pnpm add @varo-ui/headless @varo-ui/weapp

基础用法

通过上方演示面板切换 H5 实时预览,以及小程序运行时契约/代码。

Dismiss 契约

H5 可处理 Escape/外部点击;小程序没有浏览器 document,应优先 PopoverClose、页面遮罩或页面级 dismiss adapter。

Parts

Part作用
PopoverRootopen 状态
PopoverTrigger打开入口
PopoverContent浮层内容
PopoverClose显式关闭

Props

Prop类型默认值描述
openboolean | undefinedundefined受控打开态
defaultOpenbooleanfalse非受控初始态
disabledbooleanfalse禁用

Events

EventPayload描述
update:openboolean受控同步
openChangeboolean打开态变化

无障碍

  • Trigger 打开浮层。
  • Close 提供显式退出。
  • disabled 时不打开。

平台说明

  • H5 与小程序共享 open/close 契约。
  • 定位、碰撞检测与 portal 留给 UI wrapper。

相关文档