Popover 气泡卡片
uni-appH5微信小程序App
uni-app 跨端气泡卡片。点击触发元素时弹出白底信息卡片,支持标题、内容与四个方位,点击遮罩自动关闭。
何时使用
需要承载比 Tooltip 更丰富的图文信息,且不希望跳转页面:说明、摘要、轻量操作入口。
何时不使用
纯一句话提示用 Tooltip;需要用户做确认决策用 Popconfirm;强交互表单用 Dialog。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
title | string | "" | 卡片标题 |
content | string | "" | 卡片内容,可被 content 插槽覆盖 |
placement | string:'top' | 'bottom' | 'left' | 'right' | "bottom" | 气泡方位 |
trigger | string:'hover' | 'click' | "click" | 触发方式;移动端无 hover,hover 降级为点击切换 |
width | number | 240 | 卡片宽度(px) |
disabled | boolean | false | 禁用,不再弹出卡片 |
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>