Tooltip(提示框)

使用$.fn.tooltip.defaults重写默认值对象。(译者注:1.3.3版中新增的plugin)

当用户将鼠标移动到元素上的时候,将会显示一个消息提示框。提示框的内容可以是页面中任何一个HTML元素或者通过Ajax发送后台请求以获取提示框内容。

使用案例

创建提示框

1. 通过标签创建提示框,给元素添加一个"easyui-tooltip"的类名,无需任何Javascript代码。

  1. <a href="#" title="This is the tooltip message." class="easyui-tooltip">Hover me</a>

2. 通过Javascript创建提示框。

  1. <a id="dd" href="javascript:void(0)">Click here</a>
  1. $('#dd').tooltip({
  2. position: 'right',
  3. content: '<span style="color:#fff">This is the tooltip message.</span>',
  4. onShow: function(){
  5. $(this).tooltip('tip').css({
  6. backgroundColor: '#666',
  7. borderColor: '#666'
  8. });
  9. }
  10. });

属性

属性名 属性值类型 描述 默认值
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 销毁提示框。

关注编程学问公众号