关注用户体验，分享前端技术

基于jQuery的tooltips插件--poshytip

摘要：

　　分享一款在项目中使用的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: 100
9 });

 

配置参数：

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

$('#demo').poshytip({
　　content: 'Hey, there! This is a tooltip.'
});
className 设置提示框的class String

$('#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上时，不隐藏tip Boolean $('#demo').poshytip({
　　allowTipHover: true
});
followCursor 提示跟随光标移动 Boolean $('#demo').poshytip({
　　followCursor: true
});
fade 使用fade动画 Boolean $('#demo').poshytip({
　　fade: true
});
slide 使用slide动画 Boolean

$('#demo').poshytip({
　　slide: true
});
slideOffset slide动画相抵消 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') 彻底销毁提示框

 小结：

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

posted @ 2014-11-17 08:50  夕阳白雪  阅读(1543)  评论(0)  编辑  收藏  举报