uni-tooltip 文字提示
常用于展示鼠标 hover 时的提示信息。
遮挡不住原生组件
# 介绍
# 安装方式
本组件符合easycom (opens new window)规范，HBuilderX 2.5.5起，只需将本组件导入项目，在页面template中即可直接使用，无需在页面中import和注册components。
如需通过npm方式使用uni-ui组件，另见文档：https://ext.dcloud.net.cn/plugin?id=55 (opens new window)
# 基本用法
在 template 中使用组件
<uni-tooltip :content="tooltip显示的内容" placement="left">
<button>被包裹的组件</button>
</uni-tooltip>
1
2
3
2
3
# API
# Tooltip Props
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| content | String | 弹出层显示的内容 | |
| placement | String | left | Tooltip 的出现位置, 支持 left,right,top,bottom |
# Tooltip Slots
| 名称 | 说明 |
|---|---|
| default | 被 Tooltip 包裹的组件 |
| content | 弹出层插槽 |
# 示例
注意
直接拷贝示例代码，无法运行 ，示例依赖了 uni-card uni-section uni-scss 等多个组件。
请到 组件下载页面 (opens new window) ，在页面右侧选择 使用 HBuilderX导入示例项目 ，体验完整示例演示 (opens new window)。
<template>
<view class="container">
<uni-card is-full :is-shadow="false">
<text class="uni-h6">常用于展示鼠标 hover 时的提示信息，注意：无法覆盖原生组件</text>
</uni-card>
<uni-section title="基础用法" type="line" padding>
<uni-tooltip content="提示文字" />
</uni-section>
<uni-section title="自定义弹出层方向" type="line" padding>
<view class="direction-container">
<uni-tooltip content="示例文字" placement="top">
<view class="item">上</view>
</uni-tooltip>
<uni-tooltip class="item" content="示例文字" placement="bottom">
<view class="item">下</view>
</uni-tooltip>
<uni-tooltip class="item" content="示例文字" placement="left">
<view class="item">左</view>
</uni-tooltip>
<uni-tooltip class="item" content="示例文字" placement="right">
<view class="item">右</view>
</uni-tooltip>
</view>
</uni-section>
</view>
</template>
<script>
export default {
components: {},
data() {
return {};
},
};
</script>
<style lang="scss">
.direction-container {
display: flex;
width: 100px;
margin: 0 auto;
flex-wrap: wrap;
}
.item {
display: flex;
justify-content: center;
align-items: center;
width: 40px;
height: 40px;
background-color: #ebebeb;
border-radius: 10px;
margin: 5px;
}
</style>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
// Make sure to add code blocks to your code group
编辑此页 (opens new window)
上次更新: 2025/02/03, 00:09:13