工具提示(Tooltip)插件
当您想要描述一个链接的时候,工具提示(Tooltip)就显得非常有用。工具提示(Tooltip)插 件是受 Jason Frame 写的 jQuery.tipsy 的启发。工具提示(Tooltip)插件做了很多改进,例如不需 要依赖图像,而是改用 CSS 实现动画效果,用 data 属性存储标题信息。
如果您想要单独引用该插件的功能,那么您需要引用 popover.js,它依赖于 工具提示(Tooltip) 插件。或者,正如 Bootstrap 插件概览 一章中所提到,您可以引用 bootstrap.js 或压缩版 的 bootstrap.min.js。
用法
工具提示(Tooltip)插件根据需求生成内容和标记,默认情况下是把工具提示(tooltip)放在它 们的触发元素后面。您可以有以下两种方式添加工具提示(tooltip):
1.通过 data 属性:如需添加一个工具提示(tooltip),只需向一个锚标签添加 data-toggle="tooltip" 即可。 锚的 title 即为工具提示(tooltip)的文本。默认情况下,插件把工具提示(tooltip)设置在顶部。
<a href="#" data-toggle="tooltip" title="Example tooltip">请悬停在我的上面</a>
2.通过 JavaScript:通过 JavaScript 触发工具提示(tooltip):
//show:显示 hide:隐藏
$('#identifier').tooltip(options)
重点
工具提示(Tooltip)插件不像之前所讨论的下拉菜单及其他插件那样,它不是纯 CSS 插件。 如需使用该插件,您必须使用 jquery 激活它(读取 javascript)。使用下面的脚本来启用页面中 的所有的工具提示(tooltip):
$(function () { $("[data-toggle='tooltip']").tooltip(); });
选项
有一些选项是通过 Bootstrap 数据 API(Bootstrap Data API)添加或通过 JavaScript 调用的。 下表列出了这些选项:
下面是一些工具提示(Tooltip)插件中有用的方法:
事件
代码实例
<!DOCTYPE html>
<html lang="zh-cn">
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>工具提示(Tooltip)插件</title>
<!-- Bootstrap -->
<link rel="stylesheet" href="../css/bootstrap.min.css">
<script src="../js/jquery-1.11.1.min.js"></script>
<script src="../js/bootstrap.min.js"></script>
</head>
<body>
<div class="container" style="padding:50px">
<div class="col-xs-3">
<ul class="nav nav-pills nav-stacked">
<li><button type="button" id="xiaofeifei" class="btn btn-success">调用飞飞标签显示</button></li>
<li><button type="button" id="xiaolele" class="btn btn-primary">调用乐乐标签显示</button></li>
<li><button type="button" id="show" class="btn btn-danger">显示所有ToolTip.Show</button></li>
<li><button type="button" id="hide" class="btn btn-warning">隐藏所有ToolTip.Hide</button></li>
</ul>
</div>
<div class="col-xs-9">
<ul>
<!-- data-toggle="tooltip":定义标题插件,鼠标移入显示title属性内容,移除隐藏title属性内容
title="*":填写显示标签内容
data-placement="":top、left、right、bottom分别定义标签显示方向
class="tooltip-html":title属性内可以写入HTML代码 -->
<li>这是一个 <a href="#" class="tooltip-top" data-toggle="tooltip" data-placement="top" title="上方显示Tooltip小飞飞">小飞飞标签</a></li>
<li>这是一个 <a href="#" class="tooltip-left" data-toggle="tooltip" data-placement="left" title="左方显示Tooltip小喵喵">小喵喵标签</a></li>
<li>这是一个 <a href="#" class="tooltip-right" data-toggle="tooltip" data-placement="right" title="左方显示Tooltip小猪猪">小猪猪标签</a></li>
<li>这是一个 <a href="#" class="tooltip-bottom" data-toggle="tooltip" data-placement="bottom" title="下方显示Tooltip小乐乐">小乐乐标签</a></li>
<br><br><br><br><br>
<li>这是一个放大的 <a href="#" class="tooltip-html-false" data-toggle="tooltip" title="<h4>包裹h4中的标签</h4>">Tooltip 方法 options</a></li>
</ul>
</div>
</div>
</body>
<script>
$(function () {
//使用tooltip必须JS先调用$("").tooltip()
//$("[data-toggle='tooltip']").tooltip();
//html:true?false 标题title属性中,true-可以写入HTML代码,false-禁用HTML代码
$("[data-toggle='tooltip']").tooltip({html:true});
//显示小飞飞标签
$("#xiaofeifei").click(function(){
$('.tooltip-top').tooltip('show');
})
//显示小乐乐标签
$("#xiaolele").click(function(){
$('.tooltip-bottom').tooltip('show');
})
//显示所有标签
$("#show").click(function(){
$('a').tooltip('show');
})
//隐藏所有标签
$("#hide").click(function(){
$('a').tooltip('hide');
})
$("[data-toggle='tooltip']").on("show.bs.tooltip",function(){
//tooltip('show')显示之前执行事件
console.info("show.bs.tooltip");
}).on("shown.bs.tooltip",function(){
//tooltip('show')显示之前执行事件
console.info("shown.bs.tooltip");
}).on("hide.bs.tooltip",function(){
//tooltip('hide')显示之前执行事件
console.info("hide.bs.tooltip");
}).on("hidden.bs.tooltip",function(){
//tooltip('hide')显示之前执行事件
console.info("hidden.bs.tooltip");
});
});
</script>
</html>
显示效果: