Tooltip 文字提示

常用于展示鼠标 hover 时的提示信息。

基础用法

在这里我们提供 9 种不同方向的展示方式,可以通过以下完整示例来理解,选择你要的效果。

显示代码

主题

Tooltip 组件提供了两个不同的主题:darklight,你也可以自行添加样式。

显示代码

高级扩展

显示代码

参数

你可以通过修改$.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')