工具提示插件的选项
Bootstrap为工具提示插件提供了 10 个选项,所有的选项都可以通过 data 属性或JavaScript进行设置。这些选项详细见表 4‑5:
名称 | 类型 | 默认值 | 说明 |
---|---|---|---|
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使用以下语法格式来触发工具提示:
$('#example').tooltip(options)
其中,'#example' 为需要显示工具提示的页面元素,options 为使用对象表示的的选项。如,以下代码将以HTML文本格式显示一幅图像作为工具提示的内容,并延迟一秒显示、延迟半秒隐藏:
<a href="#">美女</a>
<script>
$('a').tooltip({
html: true,
title: '<img src="beauty.jpg" />',
placement: 'bottom',
delay: { show: 500, hide: 100 }
});
</script>
运行效果如图 4‑7所示:
图4-7 自定义工具提示选项
关于作者
歪脖先生,十五年以上软件开发经验,酷爱Web开发,精通 HTML、CSS、JavaScript、jQuery、JSON、Python、Less、Bootstrap等,著有《HTML宝典》、《揭秘CSS》、《Less简明教程》、《JSON教程》、《Bootstrap2用户指南》、《Bootstrap3实用教程》,并全部在 GitHub 上开源。