JQTbox.js插件是提示语弹框插件,一般作用于 提交成功、警告等 情况下出现,该插件目前有 4 套不同的样式表,可根据项目情况选择或者自定义样式。
一、使用方法
1. 引用 jQuery.js / JQTbox.js / JQTbox.css
<link href="css/JQTbox.css" rel="stylesheet" type="text/css"> <script type="text/javascript" src="dist/jquery.min.js"></script> <script type="text/javascript" src="dist/JQTbox.min.js"></script>
2. 引用
<div class="wrapper"> <div class="tool btn-error" data-tbox='0'>点击出现 error 弹框</div> <div class="tool btn-success" data-tbox='1'>点击出现 success 弹框</div> <div class="tool btn-warning" data-tbox='2'>点击出现 warning 弹框</div> <div class="tool btn-ask" data-tbox='3'>点击出现 ask 弹框</div> <div class="tool btn-normal" data-tbox='4'>表单验证完后出现提示弹框(例子)</div> </div> <script type="text/javascript">
/// 插件初始加载
$('.btn-error').JQTbox({ state: 'error', isShowHd: true, boxTitle: '提交失败', boxDoc: '请检查您的信息重新提交。', onConfirmFun: function(){ alert('jisad') } }) $('.btn-success').JQTbox({ state: 'success', isShowHd: true, boxTitle: '提交成功', boxDoc: '您提交的信息已经成功上传,24小时内我们会联系您,感谢您的支持!', onInitFun: function(){ console.log('我是成功模式哦!!') } }) $('.btn-warning').JQTbox({ state: 'warning', isShowHd: true, boxTitle: '提交为空', boxDoc: '您的信息为空。' }) $('.btn-ask').JQTbox({ state: 'ask', isShowHd: true, isShowCancel: true, boxTitle: '你确定吗', boxDoc: '是否确定删除?' }) $('.btn-normal').JQTbox({ state: 'normal', trigger: 'directOpen', isShowHd: true, boxDoc: '我是正常模式' }) </script>
插件的引用需要绑定到相对应的按钮上,而按钮的属性 " data-tbox " 必须得填写,该值为数字。
如果提示框选择的是 “ directOpen ” 模式,则在需要显示提示框的时候,输入代码
$('.btn-normal').data('JQTbox')._showBox(state); // state为需要显示的状态,如 'success', 'error'
3. CSS样式
JQTbox有4套独立的样式表,每个样式表所对应呈现的弹框样式是不一样的,使用时可根据项目情况选择不同样式表或者可自行定义。
二、参数说明
参数 | 默认值 | 说明 |
state | ' normal ' | **弹框状态 |
trigger | ' click ' | ** 弹框出现形式,有两种形式 |
imgUrl | ' images/ ' | // 设置图标引用路径 |
closeTime | 0 | // 设置弹框自动关闭时间 |
isShowHd | false | // 是否显示弹框头部 |
headTitle | ' 温馨提示 ' | // 头部标题 |
isShowConfirm | true | // 是否显示确定按钮 |
btnConfirmTxt | ' 确认 ' | // 确认按钮文本设置,若是不显示按钮,则设置无效 |
isShowCancel | false | // 是否显示取消按钮 |
btnCancelTxt | ' 取消 ' | // 取消按钮文本设置,若是不显示按钮,则设置无效 |
boxTitle | null | // 弹框标题 |
boxDoc | null | // 弹框内容 |
onInitFun | null | // 设置加载完成后事件 |
onConfirmFun | null | // 设置确认事件 |
onCancelFun | null | // 设置取消事件 |
三、事件
1. 弹框显示事件:
$('.btn-normal').data('JQTbox')._showBox(state); // state为需要显示的状态,如 'success', 'error'
2. 参数更新:
$('.btn-submit').data('JQTbox').updateOptFun({ state: 'success', boxDoc: 'Thank you contacting Century! We will respond to your inquiry as soon as possible.', onConfirmFun: function () {} });
四、代码文件
github下载:https://github.com/TammyViola/JQTboxJS (最新版本: v1.2)