Bootstrap3 工具提示插件的选项

工具提示插件的选项

Bootstrap为工具提示插件提供了 10 个选项，所有的选项都可以通过 data 属性或JavaScript进行设置。这些选项详细见表 4‑5：

表 4‑5 tooltip插件的选项

名称	类型	默认值	说明
animation	boolean	true	为工具提示应用CSS淡入淡出过渡效果
container	string | false	false	将提示条附加到特定元素，如 container: 'body'
delay	number | object	0	延迟显示和隐藏提示条的时间（毫秒）——手动触发提示条时无效如果只指定一个数值，则隐藏和显示都使用该数值。   对象的结构为 delay: { show: 500, hide: 100 }
html	boolean	false	提示条支持插入 HTML。如果取值为 false，则使用 jQuery 的 text 方法插入文本。如果担心XSS攻击，那就使用文本
placement	string | function	'top'	设置提示条的位置，取值：top | bottom | left | right
selector	string	false	如果提供了选择器，在触发该选择器时才显示提示信息
template	string	[1]	使用HTML面板创建工具提示。工具提示的title将被注入到.tooltip-inner中。.tooltip-arrow成为工具提示的箭头。最外层的包装元素应该拥有.tooltip类
title	string | function	''	如果title属性不存在，则使用默认值 ''
trigger	string	'hover focus'	工具提示的触发方式：click | hover | focus | manual。可以传入多个触发方式，以空格分隔。manual不能与其他触发方式组合使用
viewport	string | object | function	{ selector: 'body', padding: 0 }	使工具提示始终在元素的边界之内。

[1] '<div class="tooltip" role="tooltip"><div class="tooltip-arrow"></div><div class="tooltip-inner"></div></div>'

使用选项时，JavaScript使用以下语法格式来触发工具提示：

1. $('#example').tooltip(options)

其中，'#example' 为需要显示工具提示的页面元素，options 为使用对象表示的的选项。如，以下代码将以HTML文本格式显示一幅图像作为工具提示的内容，并延迟一秒显示、延迟半秒隐藏：

1. <a href="#">美女</a>
2. <script>
3. $('a').tooltip({
4.   html: true,
5.   title: '<img src="beauty.jpg" />',
6.   placement: 'bottom',
7.   delay: { show: 500, hide: 100 }
8. });
9. </script>

运行效果如图 4‑7所示：

图4-7 自定义工具提示选项

关于作者

歪脖先生，十五年以上软件开发经验，酷爱Web开发，精通 HTML、CSS、JavaScript、jQuery、JSON、Python、Less、Bootstrap等，著有《HTML宝典》、《揭秘CSS》、《Less简明教程》、《JSON教程》、《Bootstrap2用户指南》、《Bootstrap3实用教程》，并全部在 GitHub 上开源。