## Tooltip 文字提示
文字提示气泡框,在鼠标悬停时显示,代替了系统的`title`提示。
### 代码示例
基础用法
![](https://img.kancloud.cn/d5/38/d5381bf6e68d49f5b06a27deeb23262e_1914x181.png)
```html
<cvu-tooltip content="当鼠标经过这段文字时,会显示一个气泡框">
当鼠标经过这段文字时,会显示一个气泡框
</cvu-tooltip>
```
省略号显示
![](https://img.kancloud.cn/c1/b5/c1b5122ba3f44bbd422c0d2cfbbaee83_1911x303.png)
>[info] 设置属性`width`固定文本内容宽度,超出省略号显示
```html
<cvu-tooltip :width="200" content="提示框内容">
原始文本固定宽度,超出省略号显示
</cvu-tooltip>
```
位置
![](https://img.kancloud.cn/27/f9/27f9edcd9d3b6461be15f6f06123a9d6_1903x473.png)
>[info] 设置`placement`参数,具体可选值参考api
```html
<cvu-tooltip placement="top-start" content="Top Left 文字提示">
<cvu-button>上左</cvu-button>
</cvu-tooltip>
```
自定义内容
![](https://img.kancloud.cn/c6/65/c6650a842a2d8247ffdf09bbd600f01c_1906x198.png)
>[info] 通过自定义 slot 显示多行文本或更复杂的样式。
```html
<cvu-tooltip>
自定义内容
<div slot="content">
<p>显示多行信息</p>
<p>可以自定义样式</p>
</div>
</cvu-tooltip>
```
禁用
>[info] 通过设置属性`disabled`可以禁用文字提示。
```html
<cvu-tooltip :disabled="disabled" content="提示框内容">
禁止弹出提示框
</cvu-tooltip>
```
延时显示
>[info] 通过设置属性`delay`可以延时显示文字提示,单位毫秒。
```html
<cvu-tooltip :delay="1000" content="提示框内容">
延时显示提示框
</cvu-tooltip>
```
自动换行
![](https://img.kancloud.cn/3e/cd/3ecda375f1572d13efccab4d3f21dc53_1907x290.png)
>[info] 设置属性`max-width`,当超出最大值后,文本将自动换行,并两端对齐。
- 属性`max-width`默认为空,文本固定一行显示,自动撑开宽度。
```html
<cvu-tooltip :max-width="200" content="Steven Paul Jobs was an American entrepreneur and business magnate. He was the chairman, chief executive officer, and a co-founder of Apple Inc.">
文本换行提示框
</cvu-tooltip>
```
### props
| 属性 | 说明 | 类型 | 默认值 |
| --- | --- | --- | --- |
| content | 显示的内容 | String | Number | 空 |
| placement | 提示框出现的位置,可选值为top / top-start / top-end / bottom / bottom-start / bottom-end / left / left-start / left-end / right / right-start / right-end | String | top |
| width | 原始文字内容宽度 | String \| Number | \- |
| disabled | 是否禁用提示框 | Boolean | false |
| delay | 延迟显示,单位毫秒 | Number | 0 |
| always | 是否总是可见 | Boolean | false |
| theme | 主题,可选值为 dark 或 light | String | dark |
| max-width | 最大宽度,超出最大值后,文本将自动换行,并两端对齐 | String | Number | \- |
| offset | 出现位置的偏移量 | Number | 0 |
| dis-arrow | 是否隐藏小三角 | Boolean | false |
| transfer | 是否将弹层放置于 body 内,在 Tabs、带有 fixed 的 Table 列内使用时,建议添加此属性,它将不受父级样式影响,从而达到更好的效果 | Boolean | false |
| transfer-class-name | 开启 transfer 时,给浮层添加额外的 class 名称 | String | \- |
| events-enabled | 是否开启 Popper 的 eventsEnabled 属性,开启可能会牺牲一定的性能 | Boolean | false |
### events
| 事件名 | 说明 | 返回值 |
| --- | --- | --- |
| on-popper-show | 在提示框显示时触发 | 无 |
| on-popper-hide | 在提示框消失时触发 | 无 |
### slots
| 名称 | 说明 |
| --- | --- |
| 无 | 主体内容 |
| content | 提示框的内容,定义此 slot 时,会覆盖 props`content`。 |
- 介绍
- 安装
- 快速上手
- 组件
- 基础
- Button 按钮
- ButtonGroup 按钮组
- 布局
- Card 卡片
- Col 列
- Collapse 折叠面板
- Divider 分割线
- Empty 空数据
- Row 行
- 导航
- Paginator 分页
- PaginatorMini 分页
- Tab 标签页
- 表单
- Cascader 级联选择
- PasswordStrength 密码强度
- Print 局部打印
- Table 表格
- Upload 文件上传
- 视图
- Calendar 日历
- Drawer 抽屉
- Loading 加载
- Message 全局提示
- Modal 对话框
- Notification 通知菜单
- Poptip 气泡提示
- Preview 图片预览
- PreviewPdf pdf文件预览
- Tooltip 文字提示
- Tree 树形控件
- 方法
- Copy 复制到剪贴板
- DescNotice 桌面消息通知
- Html2Pdf 导出pdf
- Storage 定时存储
- 其他
- BackTop 返回顶部
- NumberScroll 数字动画
- NumberZero 数字前补零
- Spin 局部加载
- Tcplayer 播放器