消息提示
$.Msg(content, time)
参数 | 说明 |
---|---|
content | (string) 必填 需要提示的文本信息 |
class | (string) 提示框的class |
time | (int) 显示时长 单位:毫秒,默认:2000毫秒 |
codewebstr.top
/*默认时间*/
$.Msg("我是提示框");
/*自定义时间*/
$.Msg("我能消失5秒",5000);
加载提示
$.loading(content)
参数 | 说明 |
---|---|
content | (string)必填 加载提示的文本信息 |
type | (number) 加载方式,0覆盖重载,1内容追加,2替换最后一行文本,默认:0 |
style | (string) 文本css |
codewebstr.top
$.loading("加载中");
错误提示,警告提示
$.alert(content, title, aftertitle)
参数 | 说明 |
---|---|
content | (string) 必填 alert的文本信息 |
title | (string) 标题 |
aftertitle | (string) 副标题 |
callback | (function) 回调函数 |
codewebstr.top
$.alert("必填项不能为空!");
对话提示框
$.confirm(content, title, okback, noback)
参数 | 说明 |
---|---|
content | (string) 必填 对话框的文本信息 |
title | (string) 标题 |
okback | (function) 确定按钮回调函数 |
noback | (function) 取消按钮回调函数 |
codewebstr.top
$.confirm("你要关闭吗?", "重要提示", function(){ $.Msg("你选择关闭"); }, function(){ $.Msg("你放弃了"); });
内容弹出层
$.popup(content, object)
参数 | 说明 |
---|---|
content | (string) 必填 内容信息,可HTML。 |
object | (object) 配置信息 type:弹出方式,center,left,right,top,bottom。默认“center” title:标题 titleHtml:html格式的头部 bottomHtml:html格式的底部 class:附加css类名 after:弹出层加载后回调函数 closeCallback:弹出层关闭后回调函数 shadeClose:点击遮幕关闭,默认true |
codewebstr.top
var popDom=$.popup("弹出层内容",{title:"我是标题"});
TAB切换框
codewebstr.top
<div class="tab_list"> <a href="#tab1" class="tab_link active">TAB1</a> <a href="#tab2" class="tab_link">TAB2</a> <a href="#tab3" class="tab_link">TAB3</a> </div> <div class="tabs"> <ul id="tab1" class="tab active">this is TAB1</ul> <ul id="tab2" class="tab">this is TAB2</ul> <ul id="tab3" class="tab">this is TAB3</ul> </div>
元素吸顶或置底效果/TAB切换吸顶
$(dom).fixedTab(object)
参数 | 说明 |
---|---|
object.unit | (string) 数字单位,默认px |
object.space | (number) 距离,置顶或置底的距离 |
object.relDom | (object) 相对元素的DOM对象,当为空时,则为吸顶效果。 |
codewebstr.top
/** data-space:距离顶部/底部的距离 data-unit:单位,默认px **/ //注意:当元素设置有data-space,data-unit自定义属性时,将会覆盖object的配置 <div class="fixed_tab" data-space="55" data-unit="px">距离顶部55px的时候吸顶</div> PS:$(".fixed_tab").fixedTab()激活
ajax post/get请求
$.ajaxpost(url, params, callback, errCallback, async)
$.ajaxget(url, params, callback, errCallback, async)
参数 | 说明 |
---|---|
url | (url) 请求地址 |
params | (string/object) 请求参数 |
callback | (function) success回调函数 |
errCallback | (function) ajax错误回调函数 |
async | (number/boolean) ture:异步;false:同步 |
codewebstr.top
$.ajaxpost("./test",{name:"测试", code:"4567"},function(res){ console.log(res) //进行你的逻辑操作 });
异步加载页面
$.ajaxpage(url, isReturn)
参数 | 说明 |
---|---|
url | (url)必填 请求地址 |
params | (number/boolean) ture:返回HTML代码;false:HTML写入config.ajaxPageDom定义的元素内 |
codewebstr.top
//返回HTML代码
var html=$.ajaxpage("./test.html",true);
$(".demo").html(html)
//默认异步
/**
*data-page:触发标识,页面链接地址
*data-title:页面的title
*JS变量window.param,POST提交参数
**/
<a data-page="./test.html" data-title="这是异步加载">异步加载页面</a>
设置网页cookie
$.setcookie(name, value, time, path, domain)
参数 | 说明 |
---|---|
name | (string)必填 cookie名称 |
value | (string)必填 cookie值 |
time | (number)必填 cookie保存时间(天),支持小数 |
path | (string) cookie保存的服务器路径 |
domain | (string) cookie保存的域名 |
codewebstr.top
$.setcookie("name","username",1);
获取网页指定cookie
$.getcookie(name)
参数 | 说明 |
---|---|
name | (string) cookie名称 |
codewebstr.top
$.getcookie("name");
获取当前时间,多种选择
$.gettime(string)
参数 | 说明 |
---|---|
string | (string) 可获取指定时间,默认当前时间。 格式支持:时间戳/年月日(三个参数) |
返回实例
方法 | 说明 |
---|---|
getDateObj() | 格式化后的时间,包括:年月日时分秒周 |
getMonthDays() | 获取月的天数 |
getWeek() | 获取周(汉字) |
getLunarDate() | 获取农历,包含:农历、干支年月日、属相、节气、节日 |
getCalendarNow() | 获取当月日历数据 |
getCalendarPrev() | 获取上月日历数据(补齐,非全月数据) |
getCalendarNext() | 获取下月日历数据(补齐,非全月数据) |
codewebstr.top
var dateTime=$.gettime(); console.log(dateTime.getDateObj())
输入数据验证
$.checkform(content, type)
参数 | 说明 |
---|---|
content | (string) 需要验证的数据 |
type | (string) 验证的类型 email:邮箱 phone:手机 qq:QQ telephone:固话 number:数字 en:大小写英文字母 url:网址 |
codewebstr.top
$.checkform("22ff@qq.com","email");
手机振动(仅限安卓)
$.m_vibration(time, c)
参数 | 说明 |
---|---|
time | (string/object) 数字:连续振动指定秒 数组:间歇振动,格式[振动,暂停,振动...] |
c | (string) 忘记这个参数干什么了...... |
网络状态提示
$.m_line(onlineFun,offlineFun)
参数 | 说明 |
---|---|
onlineFun | (function) 网络上线回调 |
offlineFun | (function) 网络掉线回调,默认$.Msg('掉线了') |
摇一摇(仅手机端),默认事件结束后不在继续监听,如果需要再次使用,可在业务处理完成后调用reset()
$.m_shake(callback, config)
config参数 | 说明 |
---|---|
threshold | (number) 阙值,可理解为灵敏度 |
time | (number) 时间差,可理解为速度 |
codewebstr.top
var shake=$.m_shake(function(){ alert("触发了摇一摇"); shake.reset(); });
设置全屏显示
$.fullScreen(DOM,isFull)
参数 | 说明 |
---|---|
DOM | (object) 全屏显示的DOM元素,默认document.documentElement |
isFull | (boolean) 是否退出全屏,默认false |
永久性本地缓存操作
设置本地缓存
$.localStorage.set(name,value,expire)
参数 | 说明 |
---|---|
name | (string) 缓存名称 |
value | (string/object) 缓存值,可字符串、数组、josn对象 |
expire | (number) 时效,单位秒 |
获取本地缓存
$.localStorage.get(name)
参数 | 说明 |
---|---|
name | (string) 缓存名称 |
删除/清空本地缓存,当key为true(非字符串)时,清空全部缓存
$.localStorage.dele(key)
参数 | 说明 |
---|---|
name | (string) 缓存名称 |
本地缓存更新回调
$.localStorage.change(function(a){if(a.key == "key1"){alert("key1值发生变化");}})
会话性本地缓存操作
设置本地缓存
$.sessionStorage.set(name,value)
参数 | 说明 |
---|---|
name | (string) 缓存名称 |
value | (string/object) 缓存值,可字符串、数组、josn对象 |
获取本地缓存
$.sessionStorage.get(name)
参数 | 说明 |
---|---|
name | (string) 缓存名称 |
删除/清空本地缓存,当key为true(非字符串)时,清空全部缓存
$.sessionStorage.dele(key)
参数 | 说明 |
---|---|
name | (string) 缓存名称 |
获取浏览器名称及版本
$.ua.browser()
返回参数 | 说明 |
---|---|
name | 浏览器名称(weixin/uc/360/qq/sogou/chrome/ie/edge...) |
v | 版本号 |
获取操作系统名称及版本
$.ua.os()
返回参数 | 说明 |
---|---|
name | 系统名称(win/mac/ios/android) |
v | 版本号 |
判断手机端
$.ua.isWap(true|false)
参数 | 说明 |
---|---|
boolean | 是否严格判断,为ture时,将对屏幕宽度进行判断。 |
判断浏览器窗口状态,支持自定义提示语或方法
$.winVS(title)
参数 | 说明 |
---|---|
title | (string/function) 可以提示语,也可以自定义方法(传参:状态true/false) |
codewebstr.top
$.winVS("你现在不在这里");
重置浏览器部分功能,单json参数或json数组
单json格式:{'key':重置功能名称,'fun':自定义方法,'param':非重置参数}
json数组格式:[{'key':重置功能名称,'fun':自定义方法,'param':非重置参数},{...}]
$.winProhibit(object)
参数 | 说明 |
---|---|
object.key | (string) rightClick:右键 keyCode:指定按键 copy:复制 cut:剪切 paste:粘贴 print:打印 devTools:开发者工具 |
object.fun | (function) 自定义方法 keyCode返回ASCII值 devTools返回booleans |
object.param | (array) 参数 rightClick,copy,cut,paste为非重置标签(支持标签名、类名、ID),如:['input','.input'] keyCode为需要重置按键的ASCII值 print的参数:{ dom:打印区域,默认:.printBox; no:非打印元素,所有.noPrint均不被打印; start:打印开始的回调,可以做自定义更改内容。 } |
codewebstr.top
$.winProhibit([ {"key":"rightClick","fun":function(a){$.alert('你点击了右键,在左边菜单处右键试试')},"param":['ul','li']}, {"key":"keyCode","fun":function(a){$.alert('F12已经屏蔽')},"param":['123']}, {"key":"copy","fun":function(a){$.alert('你进行了复制操作,在左边菜单处选中复制试试')},"param":['ul','li']}, {"key":"devTools","fun":function(a){ a != devToolsStatus && (devToolsStatus = a,$.alert('DevTools已' + (a ? '打开' : '关闭')))}}, ]);
元素加载过场动画
$(dom).scrollAnim(object)
参数 | 说明 |
---|---|
object.dom | (string) 动画的DOM,通常使用className,默认:.fl_animated,如:".className" |
object.className | (string) 指定动画的名称,元素属性data-anim-class缺省时使用,默认:fadeIn |
object.loop | (boolean) 是否循环,否:过场动画只加载一次 |
object.direction | (string) 模式,vertical:竖屏,否则为横屏,可配合$.fn.xswitch使用 |
元素属性说明 | data-anim-class:过场动画类名称,推荐animate.min.css data-anim-delay:延迟播放时间,单位秒,默认0 data-anim-duration:动画执行时间,单位秒,默认1 |
codewebstr.top
<p class="fl_animated" data-anim-class="slideInLeft">第1动画</p> <p class="fl_animated" data-anim-class="fadeInRight" data-anim-delay="1">第2动画,延迟1秒播放</p> <p class="fl_animated" data-anim-class="fadeInRight" data-anim-duration="5">第3动画,指定动画时长为5秒</p> <p class="fl_animated" data-anim-class="fadeInRight" data-anim-delay="1" data-anim-duration="5">第4动画,延迟1秒播放,动画时长为5秒</p> <script> $(document).scrollAnim({loop:true}); </script>
全屏滚动,滚屏效果
$(dom).xswitch(object)
参数 | 说明 |
---|---|
object.section | (string) 滚屏的DOM,通常使用className,默认:.section,如:".className" |
object.page | (string) 分屏导航,默认:.xs_nav |
object.active | (boolean) 分屏导航高亮的类名 |
object.index | (string) 默认屏,默认:0 |
object.easing | (string) 过场动画模式,默认:ease |
object.duration | (number) 过场动画速度,单位:毫秒,默认:500 |
object.loop | (boolean) 是否循环,默认:false |
object.pagination | (boolean) 是否开启分屏导航,默认:false |
object.keyboard | (boolean) 是否按键控制,默认:true |
object.direction | (boolean) 模式,vertical:竖屏,否则为横屏,默认:vertical |
object.callback | (boolean) 回调,返回当前屏的索引(index) |
其他说明 | 可配置$(dom).scrollAnim(object)使用 PS:direction请保持一致 |
codewebstr.top
<div class="main"> <div class="section"> <p class="fl_animated" data-anim-class="slideInLeft">第1屏动画进入视线</p> </div> <div class="section"> <p class="fl_animated" data-anim-class="fadeInLeft" data-anim-delay="1" data-anim-duration="5">第2-1屏动画进入视线,延迟播放</p> <p class="fl_animated" data-anim-class="fadeIn">第2-2屏动画进入视线</p> <p class="fl_animated" data-anim-class="slideInRight">第2-3屏动画进入视线</p> <p class="fl_animated" data-anim-class="slideInLeft">第2-4动画进入视线</p> </div> <div class="section"> <p class="fl_animated" data-anim-class="fadeInRight">第3屏动画进入视线</p> </div> </div> <script> $(".main").xswitch({ "pagination":true, "callback":function(a){ $.Msg(a) } }) $(".main").scrollAnim({loop:true});//可配合scrollAnim,达到更好的效果 //PS:请使用DIV包含住主体框架,否则translate3d是导致分屏导航fixed失效 </script>
对表单的数据进行初步验证。
$.formFilter(Dom, object)
参数 | 说明 |
---|---|
Dom | (string) 需要验证的表单DOM,支持类名/ID,如:".className" 或 "#formPost" |
object.all | (boolean) 是否全部验证,默认:false。单项逐步验证 当设置为true时,会将表单中所有需要验证的内容全部验证后返回信息。 |
object.msg | (boolean) 是否提示框提示信息,默认:true。 当设置为false时,会返回包含错误数据的json数组。 |
参数 | 说明 |
---|---|
object.code | (boolean) 表单元素内容的验证结果,false为验证不通过。 |
object.title | (string) msg为true是不返回此项。表单元素的标题名称,可通过data-title设置。 |
object.obj | (object) msg为true是不返回此项。表单元素的DOM对象。 |
object.msg | (string) msg为true是不返回此项。错误信息。 |
object.data | (object) msg为true返回此项。表单数据。 |
对字符串的占位符格式化。
$.stringFormat(string, json)
参数 | 说明 |
---|---|
string | (string) 要进行格式化的字符串,占位符用{name}表示。 |
json | 占位符的替换值,json数组,暂不支持二维数组。 |
codewebstr.top
var str=$.stringFormat("字符串占位符{arg1},占位符{arg2}",{'arg1':'a','arg2':'b'});
获取表单数据,自动数组化。
$(dom).serializeObject()
图片懒加载,自动匹配标签,非img标签使用background。
$(dom).imglazy(object)
参数 | 说明 |
---|---|
object.attr | (string) 图片地址属性,默认:data-src |
object.error | (string) 图片加载错误替换图片,请确保此图片存在 |
object.container | (object) 滚动条Dom,默认$(window) |
object.callback | (function) 回调函数 |
object.timer | (number) 图片加载间隔时间,单位:毫秒,默认:10毫秒 |
object.scrollDelay | (number) 滚动条延时响应时间,单位:毫秒,默认:200毫秒 |
元素如果含有data-node=true属性,则为其加载图片内容(load方法)
codewebstr.top
<img class="imglazy" data-src="img1.png"/> <script> $(".imglazy").imglazy(); </script>
select下拉搜索。
$(dom).inputSearch(object)
参数 | 说明 |
---|---|
object.delay | (number) 防抖延迟事件,单位:毫秒 |
object.defalut | (boolean) 点击默认显示列表,默认:false |
object.url | (object) 数据交互请求的URL,提交参数字段名为:`key` |
object.parent | (string) 父层元素,如`.parent` |
object.valueDom | (string) 赋值元素,如`.inputId` |
object.className | (string) 下拉框的类名,可以定义。默认:ws_searchList |
object.callback | (function) 下拉选择后的回调,会返回API响应的所有参数 |
codewebstr.top
{ "data": [ { "id": 1, "title": "网络游客博客" }, { "id": 2, "title": "我的快捷工具包" } ] }
codewebstr.top
<div class="parent"> <input class="selectSearch_text"/> <input type="hidden" class="selectSearch_val"/> <div> <script> $(".selectSearch_text").inputSearch({ url:"xx.com", parent:".parent", valueDom:".selectSearch_val" }); </script>
浏览器通知
初始化,向用户询问通知
如果使用自定义通知声音,需调用此函数,触使用户主动行为
发生通知
$.notify.send(object)
参数(object) | 说明 |
---|---|
title | (string) 通知名称 |
message | (string) 消息内容 |
icon | (string) 消息图标 |
sound | (string) 自定义通知声音 |
唤醒APP,如果打开失败则提示下载APP
$.openApp(object)
参数(object) | 说明 |
---|---|
name | (string) APP名称 |
tipDefault | (string) 初始化提示文本 |
tipJump | (string) 唤醒时提示文本 |
tipError | (string) 唤醒失败提示文本 |
appUrl | (string/json) app唤醒链接,支持android和ios分别配置(json格式) |
downUrl | (string/json) app下载链接,支持android和ios分别配置(json格式) |
btnAutoHide | (number) 是否自动隐藏APP按钮,单位毫秒,0表示不隐藏 |
callback | (function) 唤醒事件回调(返回状态参数true/false) |
手势操作
$(dom).gestureListener(object)
参数(object) | 说明 |
---|---|
onStart | (function) 开始事件回调函数 |
onMove | (function) 移动事件回调函数 |
onEnd | (function) 结束事件回调函数 |
throttleTime | (number) move时间防抖延迟,毫秒级 |
$.config(object)
参数 | 说明 |
---|---|
link | (object) url: 外部CSS链接, media: 显示设备,默认ALL, charset: 文件编码,默认UTF-8 |
ajaxPageDom | (string) 异步加载页面的容器,默认.page_centent |
ajaxConfig | (object) ajax配置,如:xhrFields和beforeSend |
根据设备自动设置HTML文件字体大小
codewebstr.top
$.setsize();
关闭msg弹框(包括:$.Msg(),$.alert(),$.loading(),$confirm())
获取URL信息,格式:$.url.fun,如:$.url.getUrlFragment("url")
方法 | 说明 |
---|---|
getUrlFragment | 获取URL锚点 |
getAbsoluteUrl | 获取完整的绝对URL |
getBaseUrl | 获取非锚点的URL |
getParam | 获取URL参数 |
对事件的扩展
参数 | 说明 |
---|---|
object | copy事件返回对象 |
str | 自定义内容 |
param | 布尔类型时:true为覆盖内容,false为追加内容;也可以是function,对复制的内容进行二次处理。 |
注意:dom的copy事件需return false;
参数 | 说明 |
---|---|
str | 复制的内容 |
type | html/text:带样式图片等的html格式和纯text文本格式,默认html。 |
codewebstr.top
$(".text").click(function(){ $.winEvent.copyD("我是复制文本"); })
添加history
监听历史记录popstate
监听元素动画结束
监听元素CSS动画结束
将内容(支持HTML)以文件(doc、xls、txt)方式下载,如
codewebstr.top
$.downLoad("a.txt", '<p>这是测试内容</p>')
防抖操作