跳到主要内容

Tooltip 文字提示 ​

uni-appH5微信小程序App

uni-app 跨端文字提示。点击触发元素时弹出深色气泡,支持四个方位与箭头,纯 CSS 定位实现。

何时使用 ​

为图标按钮、截断文本等补充简短说明。

何时不使用 ​

内容较长或需要交互操作时用 Popconfirm/Dialog。

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

9:41
Tooltip 文字提示 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
contentstring""气泡文案;可被 content 插槽覆盖
placementstring:'top' | 'bottom' | 'left' | 'right'"top"气泡相对触发元素的方位
triggerstring:'hover' | 'click'"click"触发方式;仅为与 Web 版 API 对齐保留,uni-app 端无 hover,点击均切换显隐
disabledbooleanfalse禁用,不再弹出气泡

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>