首页 > 代码库 > 基于jQuery的tooltips插件--poshytip

基于jQuery的tooltips插件--poshytip

2024-08-02 12:37:20   219人阅读

摘要：

　　分享一款在项目中使用的tooltips插件--poshytip，这是一款基于jQuery的插件，其特点是简单易用，支持浏览器：IE6+, FF 2+, Opera 9+, Safari 3+, Chrome，并且带有六种皮肤的提示框

Install：

　　下载poshytip插件，解压之后将文件夹src拷贝到项目中，然后引入js和css文件。

1 <link rel="stylesheet" href="../src/tip-yellow/tip-yellow.css" type="text/css" />2 <script type="text/javascript" src="includes/jquery-1.4.2.min.js"></script>3 <script type="text/javascript" src="../src/jquery.poshytip.min.js"></script>

 

 注意：文件夹中包含所有样式，只需引自己需要的样式，此处引用的是tip-yellow.css。poshytip是基于jQuery的插件，所以在引用插件之前先引用jQuery，版本需要在1.4+。poshytip包含两个js文件jquery.poshytip.js和jquery.poshytip.min.js，前者是未压缩版，如果在开发中出现错误可以引用这个调试，开发完之后线上引用后者压缩版的。

Demos：

1 <a id="demo" title="Hey, there! This is a tooltip." href="#">2 <script>3 $(‘#demo‘).poshytip();4 </script>

 

如果没有设置poshytip的content，那么它就会将元素的title值作为提示信息。

设置不同皮肤的提示框

$(‘#demo‘).poshytip({
　　className: ‘‘
});

 设置className值来定义皮肤，缺省状态是tip-yellow。取值：tip-yellow，tip-violet，tip-darkgray，tip-skyblue，tip-yellowsimple，tip-twitter，tip-green

注意：设置className同时应将对应的css文件引入。

表单提示：

　　

1 $(‘#demo-form-name‘).poshytip({2     className: ‘tip-yellowsimple‘,3     showOn: ‘focus‘,4     alignTo: ‘target‘,5     alignX: ‘right‘,6     alignY: ‘center‘,7     offsetX: 5,8     showTimeout: 1009 });

 

配置参数：

  类型(时间单位为毫秒)示例
content显示的内容（缺省取值title）String, DOM element, Function, jQuery

$(‘#demo‘).poshytip({
　　content: ‘Hey, there! This is a tooltip.‘
});

className设置提示框的classString

$(‘#demo‘).poshytip({
　　className: ‘tip-yellow‘
});

bgImageFrameSize提示框背景图片的大小Number

$(‘#demo‘).poshytip({
　　className: ‘tip-violet‘,
　　bgImageFrameSize: 9
});

showTimeout延迟显示时间Number

$(‘#demo‘).poshytip({
　　className: ‘tip-violet‘,
　　bgImageFrameSize: 9,
　　showTimeout: 50
});

hideTimeout延迟消失时间Number

$(‘#demo‘).poshytip({
　　className: ‘tip-violet‘,
　　bgImageFrameSize: 9,
　　hideTimeout: 50
});

timeOnScreen自动隐藏之前显示多长时间Number

$(‘#demo‘).poshytip({
　　className: ‘tip-violet‘,
　　bgImageFrameSize: 9,
　　timeOnScreen: 1000
});

//当元素获取到焦点时，提示框显示1秒之后自动隐藏

showOn触发何种事件显示提示框String（‘hover‘, ‘focus‘, ‘none‘）

$(‘#demo‘).poshytip({
　　showOn: ‘focus‘
});

//当获取焦点时显示提示

liveEvents   
alignTo设置箭头位置String（‘cursor‘, ‘target‘）

$(‘#demo‘).poshytip({
　　alignTo: ‘cursor‘
});

//设置箭头位置相对于鼠标位置

alignX水平对齐相对于鼠标光标或目标元素String（ ‘right‘, ‘center‘, ‘left‘, ‘inner-left‘, ‘inner-right‘）$(‘#demo‘).poshytip({
　　alignX: ‘center‘
});
alignY垂直对齐相对于鼠标光标或目标元素String（ ‘bottom‘, ‘center‘, ‘top‘, ‘inner-bottom‘, ‘inner-top‘）$(‘#demo‘).poshytip({
　　alignY: ‘center‘
});
offsetX设置提示框横向偏移Number$(‘#demo‘).poshytip({
　　offsetX: 10
});
offsetY设置提示框纵向偏移Number$(‘#demo‘).poshytip({
　　offsetY: 10
});
keepInViewport设置提示始终显示在窗口Boolean$(‘#demo‘).poshytip({
　　keepInViewport: true
});
allowTipHover当鼠标悬在tip上时，不隐藏tipBoolean$(‘#demo‘).poshytip({
　　allowTipHover: true
});
followCursor提示跟随光标移动Boolean$(‘#demo‘).poshytip({
　　followCursor: true
});
fade使用fade动画Boolean$(‘#demo‘).poshytip({
　　fade: true
});
slide使用slide动画Boolean

$(‘#demo‘).poshytip({
　　slide: true
});

slideOffsetslide动画相抵消Number$(‘#demo‘).poshytip({
　　slideOffset: 1000
});
showAniDuration显示动画时长Number$(‘#demo‘).poshytip({
　　showAniDuration: 1000
});
hideAniDuration隐藏动画的持续时间Number$(‘#demo‘).poshytip({
　　hideAniDuration: 1000
});
refreshAniDuration异步更新提示时，动画的持续时间Number$(‘#demo‘).poshytip({
　　refreshAniDuration: 1000
});

 

 方法：

.poshytip(‘show‘)显示提示框，前提提示框的alignTo参数被设置为‘target‘
.poshytip(‘showDelayed‘, [ timeout ] )设置显示提示框延迟时间
.poshytip(‘hide‘)隐藏提示框
.poshytip(‘hideDelayed‘, [ timeout ] )设置隐藏提示框延迟时间
.poshytip(‘update‘, content, [ dontOverwriteOption ] )更新提示框内容
.poshytip(‘disable‘)禁用提示框
.poshytip(‘enable‘)启用提示框
.poshytip(‘destroy‘)彻底销毁提示框

 小结：

　　提示无处不在，更多的提示才能帮助用户轻松的使用产品，不管是表单注册提示、错误提示等等。希望你能够喜欢这款提示插件。

基于jQuery的tooltips插件--poshytip


联系
我们