js 的常用工具类库

/**
*
* @desc 常用工具类库，为widget、plugin等功能性库提供依赖
*
*/
;(function (root) {

"use strict";

var _util = root.util = {};
//缓存原型句柄
var ArrayProto = Array.prototype, ObjProto = Object.prototype, FunProto = Function.prototype;
//缓存原型句柄中的常用方法
var slice = ArrayProto.slice,
toString = ObjProto.toString,
hasOwnProperty = ObjProto.hasOwnProperty;
//原生方法 ECMAScript 5
var nativeIsArray = Array.isArray,
nativeKeys = Array.keys;

/**
* @method isString
* @param obj
* @returns {boolean}
* @desc 判断传入对象是否是字符串类型
*/
_util.isString = function (obj) {
return toString.call(obj) == '[object String]';
};

/**
* @method isArray
* @type {Function|*|_.isArray}
* @desc 判断当前对象是否是数组类型
*/
_util.isArray = nativeIsArray || function (obj) {
return toString.call(obj) == '[object Array]';
};

/**
* @method isObject
* @param obj
* @returns {boolean}
* @desc 判断当前对象是否是对象类型
*/
_util.isObject = function (obj) {
var type = typeof obj;
return type === 'function' || type === 'object' && !!obj;
};

/**
* @method isDate
* @param obj!
* @returns {boolean}
* @desc 判断当前对象是否是时间类型
*/
_util.isDate = function (obj) {
return toString.call(obj) == '[object Date]';
};

/**
* @method getQueryVal
* @param name 参数名
* @param url (可选)如果从当前页面URL中获取参数值，url参数可以不用指定
* @returns {string}
* @desc 根据参数名从当前地址或指定地址中获取参数值
*/
_util.getQueryVal = function (name,url) {
var reg = new RegExp("(^|&)" + name + "=([^&]*)(&|$)", "i");
var r;
//如果url有指定，那么从指定的地址中取值
if(url && url.indexOf('?') != -1){
r = url.split('?')[1].match(reg);
}else{
//默认从当前页面地址中取值
r = window.location.search.substr(1).match(reg);//r = ['匹配到的主串', $1, $2, $3, index, input]$1..9为正则表达式圆括号匹配的子串
}
if (r != null) return decodeURIComponent(r[2]);
return '';
};

/**
* @method trim
* @param obj
* @returns {string}
* @desc 清除字符串两边的空白字符
*/
_util.trim = function (obj) {
return _util.isString(obj) ? obj.replace(/^\s+|\s+$/g, '') : '';
};

/**
* @method extend
* @param obj
* @returns {*}
* @desc 对象属性的扩展
* @example _util.extend({aa:'abc',cc:'like that'},{aa:'cba',bb:'like this'})
*          结果：{aa:'cba',bb:'like this',cc:'like that'}
*/
_util.extend = function (obj) {
if (!_util.isObject(obj)) {
return obj;
}
var source, prop;
for (var i = 0, l = arguments.length; i < l; i++) {
source = arguments[i];
for (prop in source) {
if (hasOwnProperty.call(source, prop)) {
obj[prop] = source[prop];
}
}
}
return obj;
};

/**
* @method isWXPlatform
* @returns {boolean}
* @desc 判断当前页面是否在微信平台中
*/
_util.isWXPlatform = function(){
return /MicroMessenger/i.test(navigator.userAgent);
};

/**
* @method ajaxReq
* @param _url 请求地址
* @param _type 请求类型（可选）
* @param _param 请求参数
* @param _successCb 请求成功后要执行的回调方法
* @param _errCb 请求失败要执行的回调方法
* @desc 封装的ajax请求
*/
_util.ajaxReq = function(_url,_type,_param,_successCb,_errCb){
var option = {
type:_type ||'get',
url:_url,
data:_param,
dataType:'json',
cache:false,
timeout:5000,
success:function(res,status,xhr){
if(!res){
_errCb &&_errCb(null);
return;
}
if(res.code!='200'){
_errCb &&_errCb(res);
return;
}
_successCb && _successCb(res);
},
error:function(xhr,ts,err){
_errCb && _errCb(err);
}
};
$.ajax(option);
};

/**
* @method checkOperaSys
* @returns {string}
* @desc 判断当前客户端系统类型
*/
_util.checkOperaSys = function(){
if (/(iPhone|iPad|iPod|iOS)/i.test(navigator.userAgent)) {
return 'ios'
} else if (/(Android)/i.test(navigator.userAgent)) {
return 'android'
}
return 'pc'
};

/**
* @method 创建遮罩
* @param _conf 遮罩的CSS样式 CSS类名或者JS对象{property: value}
* @param _content 遮罩内容
* @param _registerEv 遮罩内容绑定事件
*/
_util.mask = function (_conf, _content, _registerEv) {
var
$mask = $('<div id="bg_mask"></div>'),
$maskStyle = {
"position": "absolute",
"left": 0,
"top": 0,
"height": '100%',
'width': '100%',
"background": "rgba(0, 0, 0, .7)",
'z-index': 9999
};
if (!!_conf) {
if (_util.isObject(_conf)) {
_util.extend($maskStyle, _conf);
} else if (_util.isString(_conf)){
$mask.addClass(_conf);
}
}
$mask.css($maskStyle);
$(document.body).css({
'position': 'relative'
}).append($mask);

/***************** 开始向遮罩添加内容 ****************/
if (!!_content && _util.isArray(_content)) {
for (var i= 0, size=_content.length; i<size; i++) {
var $content = '';
if (_util.isArray(_content[i].content)) {
for (var j= 0, len=_content[i].content.length; j<len; j++) {
$content += _content[i].content[j];
}
} else {
$content = _content[i].content;
}
$(_content[i].parentNodeSelector).append($(_content[i].tag).addClass(_content[i].className).html($content));
}
}

/* 防止点透 */
$mask.on('touchmove', function (event) {
event.preventDefault();
event.stopPropagation();
});

_util.registerEvent(_registerEv);
};

/**
* @method registerEvent
* @param _evs 元素监听事件配置对象
* @desc 注册事件
*/
_util.registerEvent = function (_evs) {
if (!!_evs && _util.isArray(_evs)) {
for (var i= 0, size=_evs.length; i<size; i++) {
if (_evs[i].eventType === 'swipe') {
$(_evs[i].selector).swipe({
tap: _evs[i].listener
});
} else if (_evs[i].eventType === 'touch') {
$(_evs[i].selector).touch({
tap: _evs[i].listener
});
} else {
$(_evs[i].selector).on(_evs[i].eventType, _evs[i].listener);
}
}
}
};

})(window.mi || (window.mi = {}));