Tooltip 文字提示
常用于展示鼠标 hover 时的提示信息。
基础用法
在这里我们提供 9 种不同方向的展示方式,可以通过以下完整示例来理解,选择你要的效果。
▼显示代码
主题
Tooltip 组件提供了两个不同的主题:dark
和light
,你也可以自行添加样式。
▼显示代码
高级扩展
▼显示代码
参数
你可以通过修改$.fn.tooltip.defaults
来修改全局默认配置,也可以在初始化时传入指定配置$(#id).tooltip({xx: xx})
。
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
effect | 默认提供的主题 | String | dark/light | 'dark' |
content | 显示的内容,支持html | String | - | - |
placement | Tooltip 的出现位置 | String | top/top-start/top-end/bottom/bottom-start/bottom-end/left/left-start/left-end/right/right-start/right-end | 'bottom' |
disabled | Tooltip 是否可用 | Boolean | - | false |
offset | 出现位置的偏移量 | Number | - | 0 |
visibleArrow | 是否显示 Tooltip 箭头, | Boolean | - | true |
openDelay | 延迟出现,单位毫秒 | Number | - | 0 |
manual | 手动控制模式,设置为 true 后,mouseenter 和 mouseleave 事件将不会生效 | Boolean | - | false |
tooltipClass | 为 Tooltip 添加类名 | String | - | - |
enterable | 鼠标是否可进入到 tooltip 中 | Boolean | - | true |
hideAfter | Tooltip 出现后自动隐藏延时,单位毫秒,为 0 则不会自动隐藏 | number | - | 0 |
方法
你可以通过调用$(el).tooltip('xxx')
来调用已被初始化过的元素的 Tooltip 方法。
方法 | 说明 | 举例 |
---|---|---|
set | 重新设置 Tooltip 参数,若传入字符串则当做content 处理 | $(el).tooltip('set', {xx: xx}) |
show | 显示加载特效 | $(el).tooltip('show') |
hide | 隐藏加载特效 | $(el).tooltip('hide') |