# 工具提示/Tooltip
轻松创建一个漂亮的工具提示。
## 用法
要应用这个组件,需要为某个元素添加 `data-uk-tooltip` 属性。你还需要添加一个 title 属性,它的值即是提示文本。
注意 使用此组件需要额外添加 `tooltip.css` 文件,在`css/components`文件夹中。此组件需要额外添加 `tooltip.js` 文件,在`js/components`文件夹中。
### Example
![](https://box.kancloud.cn/2016-05-12_57346f42024e1.jpg)
### Markup
```
<button class="uk-button" data-uk-tooltip title="">...</button>
<span data-uk-tooltip title="">...</span>
```
* * *
## 对齐
添加下列选项之一到 `data-uk-tooltip` 属性中来调整提示组件的文本对齐方式。
| 属性 | 描述 | 示例 |
| --- | --- | --- |
| `pos:'top'` | 将提示组件对齐到顶部。 | ![](https://box.kancloud.cn/2016-05-12_57346f4213436.jpg) |
| `pos:'top-left'` | 将提示组件对齐到左上。 | ![](https://box.kancloud.cn/2016-05-12_57346f4222c63.jpg) |
| `pos:'top-right'` | 将提示组件对齐到右上。 | ![](https://box.kancloud.cn/2016-05-12_57346f4233426.jpg) |
| `pos:'bottom'` | 将提示组件对齐到底部。 | ![](https://box.kancloud.cn/2016-05-12_57346f4244952.jpg) |
| `pos:'bottom-left'` | 将提示组件对齐到左下。 | ![](https://box.kancloud.cn/2016-05-12_57346f4258770.jpg) |
| `pos:'bottom-right'` | 将提示组件对齐到右下。 | ![](https://box.kancloud.cn/2016-05-12_57346f426a159.jpg) |
| `pos:'left'` | 将提示组件对齐到左侧。 | ![](https://box.kancloud.cn/2016-05-12_57346f427afe1.jpg) |
| `pos:'right'` | 将提示组件对齐到右侧。 | ![](https://box.kancloud.cn/2016-05-12_57346f428c80b.jpg) |
### Markup
```
<button class="uk-button" data-uk-tooltip="{pos:'bottom-left'}" title="">...</button>
```
* * *
## JavaScript 选项
这是一个如何通过属性来设置选项的示例:
```
data-uk-tooltip="{pos:'bottom-left'}"
```
| 选项 | 可用的值 | 默认值 | 描述 |
| --- | --- | --- | --- |
| `offset` | integer | 5 | 与源元素之间的偏移量 |
| `pos` | string | 'top' | 工具提示组件定位 |
| `animation` | boolean | false | 工具提示的淡入动画 |
| `delay` | integer | 0 | 提示组件延迟显示多少毫秒 |
| `cls` | string | '' | 显示提示时,添加的自定义class |
| `activeClass` | string | 'uk-active' | 被拨动的选中类名/Toggled active class |
- UIkit 中文文档
- 开始使用
- 初学者
- 开始使用
- 如何自定义
- 布局示例
- 开发者
- 项目结构
- Less & Sass 文件
- 创建主题
- 创建样式
- Customizer.json
- JavaScript
- 自定义前缀
- 核心组件
- 默认
- 基础
- 打印
- 布局类组件
- 网格
- 面板/Panel
- 块/Block
- 文章
- 评论/Comment
- 效果/Utility
- Flex 布局
- 覆盖/Cover
- 导航类组件
- 导航菜单
- 导航栏
- 二级导航
- 面包屑/Breadcrumb
- 分页
- 选项卡
- 缩略图导航/Thumbnav
- 页面元素
- 列表
- 描述列表
- 表格
- 表单
- 常用组件
- 按钮
- 图标
- 关闭/Close
- 徽章/Badge
- 提示框
- 缩略图/Thumbnail
- 遮罩/Overlay
- 文本
- 列
- 动画
- 对比度/Contrast
- JAVASCRIPT组件
- 下拉菜单
- 模态对话框
- 抽屉/Off-canvas
- 切换器/Switcher
- 拨动/toggle
- 滚动监听/Scrollspy
- 平滑滚动
- 附加组件
- 布局类组件
- 动态网格
- 视差网格
- 导航类组件
- 圆点导航
- 滑动导航/Slidenav
- 动态分页
- 常用组件
- 高级表单
- 文件表单/Form file
- 密码表单
- 选择表单
- 占位符
- 进度条/Progress
- JAVASCRIPT组件
- 灯箱/Lightbox
- 自动完成/Autocomplete
- 日期选择器/Datepicker
- HTML 编辑器
- 滚动条/Slider
- 滑块集/Slideset
- 幻灯片/Slideshow
- 视差/Parallax
- 手风琴/Accordion
- 通知/Notify
- 搜索/Search
- 可嵌套/Nestable
- 可排序/Sortable
- 附着/Sticky
- 时间选择器
- 工具提示/Tooltip
- 上传