jQuery-Tools--tooltip
老规矩，先上html和css,还是用官方的，只是去掉了些东西。
HTML
View Code
<!DOCTYPE html>
<html>
<head>
<title>jQuery Tools standalone demo</title>
<!-- include the Tools -->
<script src="http://cdn.jquerytools.org/1.2.7/full/jquery.tools.min.js"></script>
<link rel="stylesheet" type="text/css"
href="./tooltip-generic.css"/>
<style>
#myform {
border:1px outset #ccc;
background:#fff repeat-x;
padding:20px;
margin:20px auto;
width:350px;
font-size:12px;
-moz-border-radius:4px;
}
#myform h3 {
text-align:center;
margin:0 0 10px 0;
}
/* http://www.quirksmode.org/css/forms.html */
#inputs label, #inputs input, #inputs textarea, #inputs select {
display: block;
width: 150px;
float: left;
margin-bottom: 20px;
}
#inputs label {
text-align: right;
width: 75px;
padding-right: 20px;
}
#inputs br {
clear: left;
}
</style>
</head>
<body><form id="myform" action="#">
<h3>Registration Form</h3>
<div id="inputs">
<!-- username -->
<label for="username">Username</label>
<input id="username" title="Must be at least 8 characters."/>
<br />
<!-- password -->
<label for="password">Password</label>
<input id="password" type="password" title="Make it hard to guess." />
<br />
<!-- email -->
<label for="email">Email</label>
<input id="email" title="We won't send you any marketing material." />
<br />
<!-- message -->
<label for="body">Message</label>
<textarea id="body" title="What's on your mind?"></textarea>
<br />
<!-- message -->
<label for="where">Select one</label>
<select id="where" title="Select one of these options">
<option>-- first option --</option>
<option>-- second option --</option>
<option>-- third option --</option>
</select>
<br />
</div>
<!-- email -->
<label>
I accept the terms and conditions
<input type="checkbox" id="check" title="Required to proceed" />
</label>
<p>
<button type="button" title="This button won't do anything">
Proceed
</button>
</p>
</form>
<!-- javascript coding -->
<script>
// execute your scripts when the DOM is ready. this is a good habit
$(function() {
// select all desired input fields and attach tooltips to them
$("#myform :input").tooltip({
// place tooltip on the right edge
position: "center right",
// a little tweaking of the position
offset: [-2, 10],
// use the built-in fadeIn/fadeOut effect
effect: "fade",
// custom opacity setting
opacity: 0.7
});
});
</script>
</body>
</html>
CSS
View Code
/* simple css-based tooltip */ .tooltip { background-color:#000; border:1px solid #fff; padding:10px 15px; width:200px; display:none; color:#fff; text-align:left; font-size:12px; /* outline radius for mozilla/firefox only */ -moz-box-shadow:0 0 10px #000; -webkit-box-shadow:0 0 10px #000; }
CSS可以不需要，这样显示的样子恶心了点。
关键代码：
View Code
// select all desired input fields and attach tooltips to them $("#myform :input").tooltip({ // place tooltip on the right edge position: "center right", // a little tweaking of the position offset: [-2, 10], // use the built-in fadeIn/fadeOut effect effect: "fade", tipClass:'tooltip', // 省却值：tooltip，少了这一行效果也是一样 // custom opacity setting opacity: 0.7 });
使用
这里是可能存在的最简单的工具提示的初始化:
$("#myform :input").tooltip();
配置
| 属性 | 默认值 | 描述 |
|---|---|---|
| cancelDefault | true |
自从1.1.0版。 当工具提示内容抓取 从 标题 触发器元素的属性 这个属性取消默认工具提示执行的行为 浏览器。 这是通过简单的移除 这个 标题 属性从触发器。
你仍然可以检索/修改标题值通过调用 jQuery的 数据('title') 方法为触发。 |
| effect | 'toggle' |
指定了如何显示和隐藏的提示。 有两个 内置的效果,可以用作值:
toggle 。 一个简单的显示/隐藏效果。 这是 默认 fade 。 一个简单的淡入/淡出效果 |
| delay | 30 |
指定工具提示依然可见多久后鼠标 叶子触发器。 这是必需的,如果tootip已 互动的内容和用户将需要时间去 tootip区域。 通过设置0工具提示也会消失 鼠标离开就从触发器元素。 |
| events | Object |
一个配置对象,它指定当工具提示会 显示和隐藏。 您可以指定不同的事件不同 类型的元素。 这里有默认值为这个 属性:
events: {
JavaScript 你可以阅读更多关于这方面的内容 这个 事件管理 一章。 |
| layout | '<div/>' |
自从1.2.0 HTML布局为生成的 工具提示。 可以很复杂的HTML布局如你所愿。 你 可以,例如,添加一个嵌套的 跨度 元素作为 箭的占位符。 |
| offset | [0, 0] |
精细地调节工具提示指定位置 这个 位置 属性。 看到 这个 定位细节 更多的 信息。 |
| opacity | 1
|
透明的工具提示。 例如,0意味着不可见, 1意味着没有透明度(完全可见)和0.4意味着40% 工具提示显示的。 如果你的工具提示使用CSS背景 图像,你可以设置透明度的形象,如果它已经 保存在PNG24图形格式。 记住,互联网 IE 6不支持原生透明的PNG。 |
| position | 'top center' |
指定位置的工具提示。 看到 这个 定位细节 更多的 信息。 旧的格式:['top', 'center'] 是废弃,在未来将会被移除。 |
| predelay | 0
|
自从1.1.0版。 指定了延迟(在 毫秒)工具提示显示之前。 默认情况下有 没有延迟。 |
| relative | false |
自从1.1.1。 默认情况下,工具提示位置 现在决定相对于文档(通过使用 这个 relative)的方法。 通过启用这个 产权工具提示的位置是相对确定的 父元素 |
| tip | 一个jQuery选择器为一个单一的工具提示的元素。 对于 示例 # mytip 。 该选项仅有效如果你 要手动定义一个工具提示多个触发器 同时元素。 因为1.2.5 标题 属性仍然可以被用作工具提示内容。 | |
| tipClass | 'tooltip' |
自从1.2.0。 CSS类名生成的 工具提示的元素。 |
事件
确保你已经阅读 大约 事件 jQuery工具 。 所有事件监听器接收 这个 事件 对象 作为第一个参数。
| 事件 | 触发事件 |
|---|---|
| onbeforeshow | 在工具提示显示。 第二个参数是工具提示 要使用位置。 这是一个对象的值{top: integer, left: integer} |
| onShow | 在工具提示显示。 |
| onBeforeHide | 在工具提示是隐藏的 |
| onHide | 当这个工具提示是隐藏的。 |
下面的示例是一个onShow 回调函数, 淡出触发器元素当工具提示显示:
$("label").tooltip({
// change trigger opacity slowly to 0.8
onShow: function() {
this.getTrigger().fadeTo("slow", 0.8);
}
});
事件管理
jQuery工具提示可以让你完全控制 当 工具提示 将显示或隐藏。 您可以指定不同的事件 不同类型的元素。 你可以控制这种行为 这个 事件 配置变量,它具有以下 默认值:
events: {
def: "mouseenter,mouseleave", // default show/hide events for an element
input: "focus,blur", // for all input elements
widget: "focus mouseenter,blur mouseleave", // select, checkbox, radio, button
tooltip: "mouseenter,mouseleave" // the tooltip element
}
脚本 api
首先确保你已经了解你自己 与 jQuery工具 脚本 。
以下列出的是所有API方法:
| 方法 | 返回值 | 描述/例子 |
|---|---|---|
| show() | api |
显示工具提示。 |
| hide() | api |
隐藏工具提示。 |
| isShown(fully) | 布尔 |
返回 真正的 如果这个工具提示是可见的。 自从1.2.0 你也可以使用一个布尔型参数,保证了 函数返回 真正的 只有当这个工具提示是充分的 可见(在它的最终位置和不透明性)。 |
| getTip() | jQuery |
返回tooltip作为一个jQuery对象。 |
| getTrigger() | jQuery |
返回元素作为一个jQuery对象的触发。 |
| getConf() | 对象 |
返回工具提示配置。 |
内置的效果: fade
内置的效果“渐”有它自己的一组配置选项 如下:
| 属性 | 默认值 | 描述 |
|---|---|---|
| fadeInSpeed | 400 | 淡入时速度显示工具提示,以毫秒为单位。 |
| fadeoutspeed | 200 | 当工具提示的淡出速度是隐藏着的,以毫秒为单位。 |
