跳到主要内容

Popover 气泡卡片 ​

uni-appH5微信小程序App

uni-app 跨端气泡卡片。点击触发元素时弹出白底信息卡片,支持标题、内容与四个方位,点击遮罩自动关闭。

何时使用 ​

需要承载比 Tooltip 更丰富的图文信息,且不希望跳转页面:说明、摘要、轻量操作入口。

何时不使用 ​

纯一句话提示用 Tooltip;需要用户做确认决策用 Popconfirm;强交互表单用 Dialog。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
Popover 气泡卡片 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
titlestring""卡片标题
contentstring""卡片内容,可被 content 插槽覆盖
placementstring:'top' | 'bottom' | 'left' | 'right'"bottom"气泡方位
triggerstring:'hover' | 'click'"click"触发方式;移动端无 hover,hover 降级为点击切换
widthnumber240卡片宽度(px)
disabledbooleanfalse禁用,不再弹出卡片

Slots ​

名称说明
default触发元素
content自定义卡片内容,覆盖 content prop

示例 ​

基础用法 ​

vue
<Popover title="组件契约" content="每个组件都自带 meta.json 与 llms.txt。">
  <Button variant="primary">点我</Button>
</Popover>

不同方向 ​

vue
<view class="row">
  <Popover content="顶部" placement="top"><Button size="sm">top</Button></Popover>
  <Popover content="底部" placement="bottom"><Button size="sm">bottom</Button></Popover>
  <Popover content="左侧" placement="left"><Button size="sm">left</Button></Popover>
  <Popover content="右侧" placement="right"><Button size="sm">right</Button></Popover>
</view>

禁用 ​

vue
<Popover content="不会弹出" disabled>
  <Button disabled>禁用气泡</Button>
</Popover>