Tooltip 文字提示
uni-appH5微信小程序App
uni-app 跨端文字提示。点击触发元素时弹出深色气泡,支持四个方位与箭头,纯 CSS 定位实现。
何时使用
为图标按钮、截断文本等补充简短说明。
何时不使用
内容较长或需要交互操作时用 Popconfirm/Dialog。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
content | string | "" | 气泡文案;可被 content 插槽覆盖 |
placement | string:'top' | 'bottom' | 'left' | 'right' | "top" | 气泡相对触发元素的方位 |
trigger | string:'hover' | 'click' | "click" | 触发方式;仅为与 Web 版 API 对齐保留,uni-app 端无 hover,点击均切换显隐 |
disabled | boolean | false | 禁用,不再弹出气泡 |
Slots
| 名称 | 说明 |
|---|---|
default | 触发元素 |
content | 自定义气泡内容,覆盖 content 文案 |
示例
基础用法
vue
<Tooltip content="收藏成功">
<Button variant="secondary"><Icon name="star" :size="16" /> 收藏</Button>
</Tooltip>不同方向
vue
<view class="row">
<Tooltip content="上" placement="top"><Tag>top</Tag></Tooltip>
<Tooltip content="下" placement="bottom"><Tag>bottom</Tag></Tooltip>
<Tooltip content="左" placement="left"><Tag>left</Tag></Tooltip>
<Tooltip content="右" placement="right"><Tag>right</Tag></Tooltip>
</view>禁用
vue
<Tooltip content="不会显示" disabled>
<Tag>禁用提示</Tag>
</Tooltip>