Tooltip(提示框)
使用$.fn.tooltip.defaults重写默认值对象。(译者注:1.3.3版中新增的plugin)
当用户将鼠标移动到元素上的时候,将会显示一个消息提示框。提示框的内容可以是页面中任何一个HTML元素或者通过Ajax发送后台请求以获取提示框内容。
使用案例
创建提示框
1. 通过标签创建提示框,给元素添加一个"easyui-tooltip"的类名,无需任何Javascript代码。
<a href="#" title="This is the tooltip message." class="easyui-tooltip">Hover me</a>
2. 通过Javascript创建提示框。
<a id="dd" href="javascript:void(0)">Click here</a>
$('#dd').tooltip({
position: 'right',
content: '<span style="color:#fff">This is the tooltip message.</span>',
onShow: function(){
$(this).tooltip('tip').css({
backgroundColor: '#666',
borderColor: '#666'
});
});
属性
属性名 |
属性值类型 |
描述 |
默认值 |
position |
string |
消息框位置。可用值有:"left","right","top","bottom" |
bottom |
content |
string |
消息框内容。 |
null |
trackMouse |
boolean |
为true时,允许提示框跟着鼠标移动。 |
false |
deltaX |
number |
水平方向提示框的位置。 |
0 |
deltaY |
number |
垂直方向提示框的位置。 |
0 |
showEvent |
string |
当激发什么事件的时候显示提示框。 |
mouseenter |
hideEvent |
string |
当激发什么事件的时候隐藏提示框。 |
mouseleave |
showDelay |
number |
延时多少秒显示提示框。 |
200 |
hideDelay |
number |
延时多少秒隐藏提示框。 |
100 |
事件
事件名称 |
事件参数 |
描述 |
onShow |
e |
在显示提示框的时候触发。 |
onHide |
e |
在隐藏提示框的时候触发。 |
onUpdate |
content |
在提示框内容更新的时候触发。 |
onPosition |
left,top |
在提示框位置改变的时候触发。 |
onDestroy |
none |
在提示框被销毁的时候触发。 |
方法
方法名 |
方法参数 |
描述 |
options |
none |
返回控件属性对象。 |
tip |
none |
返回tip元素对象。 |
arrow |
none |
返回箭头元素对象。 |
show |
e |
显示提示框。 |
hide |
e |
隐藏提示框。 |
update |
content |
更新提示框内容。 |
reposition |
none |
重置提示框位置。 |
destroy |
none |
销毁提示框。 |
,