一个jQuery扩展工具包
带有详尽注释的源代码：
var jQuery = jQuery || {};
// TODO
// ###################################string操作相关函数###################################
jQuery.string = jQuery.string || {};
/**
* 对目标字符串进行html解码
*
* @name jQuery.string.decodeHTML
* @function
* @grammar jQuery.string.decodeHTML(source)
* @param {string}
* source 目标字符串
* @shortcut decodeHTML
* @meta standard
* @see jQuery.string.encodeHTML
*
* @returns {string} html解码后的字符串
*/
jQuery.string.decodeHTML = function(source) {
var str = String(source).replace(/"/g, '"').replace(/</g, '<')
.replace(/>/g, '>').replace(/&/g, "&");
// 处理转义的中文和实体字符
return str.replace(/&#([\d]+);/g, function(_0, _1) {
return String.fromCharCode(parseInt(_1, 10));
});
};
/**
* 对目标字符串进行html编码
*
* @name jQuery.string.encodeHTML
* @function
* @grammar jQuery.string.encodeHTML(source)
* @param {string}
* source 目标字符串
* @remark 编码字符有5个：&<>"'
* @shortcut encodeHTML
* @meta standard
* @see jQuery.string.decodeHTML
*
* @returns {string} html编码后的字符串
*/
jQuery.string.encodeHTML = function(source) {
return String(source).replace(/&/g, '&').replace(/</g, '<').replace(
/>/g, '>').replace(/"/g, """).replace(/'/g, "'");
};
/**
* 将目标字符串中可能会影响正则表达式构造的字符串进行转义。
*
* @name jQuery.string.escapeReg
* @function
* @grammar jQuery.string.escapeReg(source)
* @param {string}
* source 目标字符串
* @remark 给以下字符前加上“\”进行转义：.*+?^=!:${}()|[]/\
* @meta standard
*
* @returns {string} 转义后的字符串
*/
jQuery.string.escapeReg = function(source) {
return String(source).replace(
new RegExp("([.*+?^=!:\x24{}()|[\\]\/\\\\])", "g"), '\\\x241');
};
/**
* 对目标字符串进行格式化
*
* @name jQuery.string.format
* @function
* @grammar jQuery.string.format(source, opts)
* @param {string}
* source 目标字符串
* @param {Object|string...}
* opts 提供相应数据的对象或多个字符串
* @remark
*
* opts参数为“Object”时，替换目标字符串中的#{property name}部分。<br>
* opts为“string...”时，替换目标字符串中的#{0}、#{1}...部分。
*
* @shortcut format
* @meta standard
*
* @returns {string} 格式化后的字符串
*/
jQuery.string.format = function(source, opts) {
source = String(source);
var data = Array.prototype.slice.call(arguments, 1), toString = Object.prototype.toString;
if (data.length) {
data = data.length == 1 ?
/* ie 下 Object.prototype.toString.call(null) == '[object Object]' */
(opts !== null
&& (/\[object Array\]|\[object Object\]/.test(toString
.call(opts))) ? opts : data) : data;
return source.replace(/#\{(.+?)\}/g, function(match, key) {
var replacer = data[key];
// chrome 下 typeof /a/ == 'function'
if ('[object Function]' == toString.call(replacer)) {
replacer = replacer(key);
}
return ('undefined' == typeof replacer ? '' : replacer);
});
}
return source;
};
/**
* 获取目标字符串在gbk编码下的字节长度
*
* @name jQuery.string.getByteLength
* @function
* @grammar jQuery.string.getByteLength(source)
* @param {string}
* source 目标字符串
* @remark 获取字符在gbk编码下的字节长度, 实现原理是认为大于127的就一定是双字节。如果字符超出gbk编码范围, 则这个计算不准确
* @meta standard
* @see jQuery.string.subByte
*
* @returns {number} 字节长度
*/
jQuery.string.getByteLength = function(source) {
return String(source).replace(/[^\x00-\xff]/g, "ci").length;
};
/**
* 去掉字符串中的html标签
*
* @function
* @grammar jQuery.string.stripTags(source)
* @param {string}
* source 要处理的字符串.
* @return {String}
*/
jQuery.string.stripTags = function(source) {
return String(source || '').replace(/<[^>]+>/g, '');
};
/**
* 对目标字符串按gbk编码截取字节长度
*
* @name jQuery.string.subByte
* @function
* @grammar jQuery.string.subByte(source, length)
* @param {string}
* source 目标字符串
* @param {number}
* length 需要截取的字节长度
* @param {string}
* [tail] 追加字符串,可选.
* @remark 截取过程中，遇到半个汉字时，向下取整。
* @see jQuery.string.getByteLength
*
* @returns {string} 字符串截取结果
*/
jQuery.string.subByte = function(source, length, tail) {
source = String(source);
tail = tail || '';
if (length < 0 || jQuery.string.getByteLength(source) <= length) {
return source + tail;
}
// thanks 加宽提供优化方法
source = source.substr(0, length).replace(/([^\x00-\xff])/g, "\x241 ")// 双字节字符替换成两个
.substr(0, length)// 截取长度
.replace(/[^\x00-\xff]$/, "")// 去掉临界双字节字符
.replace(/([^\x00-\xff]) /g, "\x241");// 还原
return source + tail;
};
/**
* 将目标字符串进行驼峰化处理
*
* @name jQuery.string.toCamelCase
* @function
* @grammar jQuery.string.toCamelCase(source)
* @param {string}
* source 目标字符串
* @remark 支持单词以“-_”分隔
* @meta standard
*
* @returns {string} 驼峰化处理后的字符串
*/
// todo:考虑以后去掉下划线支持？
jQuery.string.toCamelCase = function(source) {
// 提前判断，提高getStyle等的效率 thanks xianwei
if (source.indexOf('-') < 0 && source.indexOf('_') < 0) {
return source;
}
return source.replace(/[-_][^-_]/g, function(match) {
return match.charAt(1).toUpperCase();
});
};
/**
* 将目标字符串中常见全角字符转换成半角字符
*
* @name jQuery.string.toHalfWidth
* @function
* @grammar jQuery.string.toHalfWidth(source)
* @param {string}
* source 目标字符串
* @remark
*
* 将全角的字符转成半角, 将“&#xFF01;”至“&#xFF5E;”范围的全角转成“&#33;”至“&#126;”,
* 还包括全角空格包括常见的全角数字/空格/字母, 用于需要同时支持全半角的转换, 具体转换列表如下("空格"未列出)：<br>
* <br> ！ => !<br> ＂ => "<br> ＃ => #<br> ＄ => $<br> ％ => %<br> ＆ => &<br> ＇ => '<br> （ => (<br> ） => )<br> ＊ => *<br> ＋ => +<br> ， => ,<br> － => -<br> ． => .<br> ／ => /<br>
* ０ => 0<br>
* １ => 1<br>
* ２ => 2<br>
* ３ => 3<br>
* ４ => 4<br>
* ５ => 5<br>
* ６ => 6<br>
* ７ => 7<br>
* ８ => 8<br>
* ９ => 9<br> ： => :<br> ； => ;<br> ＜ => <<br> ＝ => =<br> ＞ => ><br> ？ => ?<br> ＠ => @<br>
* Ａ => A<br>
* Ｂ => B<br>
* Ｃ => C<br>
* Ｄ => D<br>
* Ｅ => E<br>
* Ｆ => F<br>
* Ｇ => G<br>
* Ｈ => H<br>
* Ｉ => I<br>
* Ｊ => J<br>
* Ｋ => K<br>
* Ｌ => L<br>
* Ｍ => M<br>
* Ｎ => N<br>
* Ｏ => O<br>
* Ｐ => P<br>
* Ｑ => Q<br>
* Ｒ => R<br>
* Ｓ => S<br>
* Ｔ => T<br>
* Ｕ => U<br>
* Ｖ => V<br>
* Ｗ => W<br>
* Ｘ => X<br>
* Ｙ => Y<br>
* Ｚ => Z<br> ［ => [<br> ＼ => \<br> ］ => ]<br> ＾ => ^<br> ＿ => _<br> ｀ => `<br>
* ａ => a<br>
* ｂ => b<br>
* ｃ => c<br>
* ｄ => d<br>
* ｅ => e<br>
* ｆ => f<br>
* ｇ => g<br>
* ｈ => h<br>
* ｉ => i<br>
* ｊ => j<br>
* ｋ => k<br>
* ｌ => l<br>
* ｍ => m<br>
* ｎ => n<br>
* ｏ => o<br>
* ｐ => p<br>
* ｑ => q<br>
* ｒ => r<br>
* ｓ => s<br>
* ｔ => t<br>
* ｕ => u<br>
* ｖ => v<br>
* ｗ => w<br>
* ｘ => x<br>
* ｙ => y<br>
* ｚ => z<br> ｛ => {<br> ｜ => |<br> ｝ => }<br> ～ => ~<br>
*
*
* @returns {string} 转换后的字符串
*/
jQuery.string.toHalfWidth = function(source) {
return String(source).replace(/[\uFF01-\uFF5E]/g, function(c) {
return String.fromCharCode(c.charCodeAt(0) - 65248);
}).replace(/\u3000/g, " ");
};
/**
* 去掉字符串两端的空格，跟jQuery.trim相同，具体请参照jQuery.trim方法
*/
jQuery.string.trim = jQuery.trim;
/**
* 为目标字符串添加wbr软换行
*
* @name jQuery.string.wbr
* @function
* @grammar jQuery.string.wbr(source)
* @param {string}
* source 目标字符串
* @remark
*
* 1.支持html标签、属性以及字符实体。<br>
* 2.任意字符中间都会插入wbr标签，对于过长的文本，会造成dom节点元素增多，占用浏览器资源。
* 3.在opera下，浏览器默认css不会为wbr加上样式，导致没有换行效果，可以在css中加上 wbr:after { content:
* "\00200B" } 解决此问题
*
*
* @returns {string} 添加软换行后的字符串
*/
jQuery.string.wbr = function(source) {
return String(source).replace(/(?:<[^>]+>)|(?:&#?[0-9a-z]{2,6};)|(.{1})/gi,
'$&<wbr>').replace(/><wbr>/g, '>');
};
/**
* 对目标字符串进行格式化,支持过滤
*
* @name jQuery.string.filterFormat
* @function
* @grammar jQuery.string.filterFormat(source, opts)
* @param {string}
* source 目标字符串
* @param {Object|string...}
* opts 提供相应数据的对象
* @version 1.2
* @remark
*
* 在 jQuery.string.format的基础上,增加了过滤功能. 目标字符串中的#{url|escapeUrl},<br/>
* 会替换成jQuery.string.filterFormat["escapeUrl"](opts.url);<br/>
* 过滤函数需要之前挂载在jQuery.string.filterFormat属性中.
*
* @see jQuery.string.format,jQuery.string.filterFormat.escapeJs,jQuery.string.filterFormat.escapeString,jQuery.string.filterFormat.toInt
* @returns {string} 格式化后的字符串
*/
jQuery.string.filterFormat = function(source, opts) {
var data = Array.prototype.slice.call(arguments, 1), toString = Object.prototype.toString;
if (data.length) {
data = data.length == 1 ?
/* ie 下 Object.prototype.toString.call(null) == '[object Object]' */
(opts !== null
&& (/\[object Array\]|\[object Object\]/.test(toString
.call(opts))) ? opts : data) : data;
return source.replace(/#\{(.+?)\}/g, function(match, key) {
var filters, replacer, i, len, func;
if (!data)
return '';
filters = key.split("|");
replacer = data[filters[0]];
// chrome 下 typeof /a/ == 'function'
if ('[object Function]' == toString.call(replacer)) {
replacer = replacer(filters[0]/* key */);
}
for (i = 1, len = filters.length; i < len; ++i) {
func = jQuery.string.filterFormat[filters[i]];
if ('[object Function]' == toString.call(func)) {
replacer = func(replacer);
}
}
return (('undefined' == typeof replacer || replacer === null) ? ''
: replacer);
});
}
return source;
};
/**
* 对js片段的字符做安全转义,编码低于255的都将转换成\x加16进制数
*
* @name jQuery.string.filterFormat.escapeJs
* @function
* @grammar jQuery.string.filterFormat.escapeJs(source)
* @param {String}
* source 待转义字符串
*
* @see jQuery.string.filterFormat,jQuery.string.filterFormat.escapeString,jQuery.string.filterFormat.toInt
* @version 1.2
* @return {String} 转义之后的字符串
*/
jQuery.string.filterFormat.escapeJs = function(str) {
if (!str || 'string' != typeof str)
return str;
var i, len, charCode, ret = [];
for (i = 0, len = str.length; i < len; ++i) {
charCode = str.charCodeAt(i);
if (charCode > 255) {
ret.push(str.charAt(i));
} else {
ret.push('\\x' + charCode.toString(16));
}
}
return ret.join('');
};
/**
* 对字符串做安全转义,转义字符包括: 单引号,双引号,左右小括号,斜杠,反斜杠,上引号.
*
* @name jQuery.string.filterFormat.escapeString
* @function
* @grammar jQuery.string.filterFormat.escapeString(source)
* @param {String}
* source 待转义字符串
*
* @see jQuery.string.filterFormat,jQuery.string.filterFormat.escapeJs,jQuery.string.filterFormat.toInt
* @version 1.2
* @return {String} 转义之后的字符串
*/
jQuery.string.filterFormat.escapeString = function(str) {
if (!str || 'string' != typeof str)
return str;
return str.replace(/["'<>\\\/`]/g, function($0) {
return '&#' + $0.charCodeAt(0) + ';';
});
};
/**
* 对数字做安全转义,确保是十进制数字;否则返回0.
*
* @name jQuery.string.filterFormat.toInt
* @function
* @grammar jQuery.string.filterFormat.toInt(source)
* @param {String}
* source 待转义字符串
*
* @see jQuery.string.filterFormat,jQuery.string.filterFormat.escapeJs,jQuery.string.filterFormat.escapeString
* @version 1.2
* @return {Number} 转义之后的数字
*/
jQuery.string.filterFormat.toInt = function(str) {
return parseInt(str, 10) || 0;
};
// TODO
// ###################################array操作相关函数###################################
jQuery.array = jQuery.array || {};
/**
* 判断一个数组中是否包含给定元素
*
* @name jQuery.array.contains
* @function
* @grammar jQuery.array.contains(source, obj)
* @param {Array}
* source 需要判断的数组.
* @param {Any}
* obj 要查找的元素.
* @return {boolean} 判断结果.
* @author berg
*/
jQuery.array.contains = function(source, obj) {
return (jQuery.array.indexOf(source, obj) >= 0);
};
/**
* 清空一个数组
*
* @name jQuery.array.empty
* @function
* @grammar jQuery.array.empty(source)
* @param {Array}
* source 需要清空的数组.
* @author berg
*/
jQuery.array.empty = function(source) {
source.length = 0;
};
/**
* 从数组中筛选符合条件的元素
*
* @name jQuery.array.filter
* @function
* @grammar jQuery.array.filter(source, iterator[, thisObject])
* @param {Array}
* source 需要筛选的数组
* @param {Function}
* iterator 对每个数组元素进行筛选的函数，该函数有两个参数，第一个为数组元素，第二个为数组索引值，function
* (item, index)，函数需要返回true或false
* @param {Object}
* [thisObject] 函数调用时的this指针，如果没有此参数，默认是当前遍历的数组
* @meta standard
* @see jQuery.array.find
*
* @returns {Array} 符合条件的数组项集合
*/
jQuery.array.filter = function(source, iterator, thisObject) {
var result = [], resultIndex = 0, len = source.length, item, i;
if ('function' == typeof iterator) {
for (i = 0; i < len; i++) {
item = source[i];
// 和标准不符，see array.each
if (true === iterator.call(thisObject || source, item, i)) {
// resultIndex用于优化对result.length的多次读取
result[resultIndex++] = item;
}
}
}
return result;
};
/**
* 从数组中寻找符合条件的第一个元素
*
* @name jQuery.array.find
* @function
* @grammar jQuery.array.find(source, iterator)
* @param {Array}
* source 需要查找的数组
* @param {Function}
* iterator 对每个数组元素进行查找的函数，该函数有两个参数，第一个为数组元素，第二个为数组索引值，function
* (item, index)，函数需要返回true或false
* @see jQuery.array.filter,jQuery.array.indexOf
*
* @returns {Any|null} 符合条件的第一个元素，找不到时返回null
*/
jQuery.array.find = function(source, iterator) {
var item, i, len = source.length;
if ('function' == typeof iterator) {
for (i = 0; i < len; i++) {
item = source[i];
if (true === iterator.call(source, item, i)) {
return item;
}
}
}
return null;
};
/**
* 查询数组中指定元素的索引位置
*
* @name jQuery.array.indexOf
* @function
* @grammar jQuery.array.indexOf(source, match[, fromIndex])
* @param {Array}
* source 需要查询的数组
* @param {Any}
* match 查询项
* @param {number}
* [fromIndex] 查询的起始位索引位置，如果为负数，则从source.length+fromIndex往后开始查找
* @see jQuery.array.find,jQuery.array.lastIndexOf
*
* @returns {number} 指定元素的索引位置，查询不到时返回-1
*/
jQuery.array.indexOf = function(source, match, fromIndex) {
var len = source.length, iterator = match;
fromIndex = fromIndex | 0;
if (fromIndex < 0) {// 小于0
fromIndex = Math.max(0, len + fromIndex);
}
for (; fromIndex < len; fromIndex++) {
if (fromIndex in source && source[fromIndex] === match) {
return fromIndex;
}
}
return -1;
};
/**
* 从后往前，查询数组中指定元素的索引位置
*
* @name jQuery.array.lastIndexOf
* @function
* @grammar jQuery.array.lastIndexOf(source, match)
* @param {Array}
* source 需要查询的数组
* @param {Any}
* match 查询项
* @param {number}
* [fromIndex] 查询的起始位索引位置，如果为负数，则从source.length+fromIndex往前开始查找
* @see jQuery.array.indexOf
*
* @returns {number} 指定元素的索引位置，查询不到时返回-1
*/
jQuery.array.lastIndexOf = function(source, match, fromIndex) {
var len = source.length;
fromIndex = fromIndex | 0;
if (!fromIndex || fromIndex >= len) {
fromIndex = len - 1;
}
if (fromIndex < 0) {
fromIndex += len;
}
for (; fromIndex >= 0; fromIndex--) {
if (fromIndex in source && source[fromIndex] === match) {
return fromIndex;
}
}
return -1;
};
/**
* 移除数组中的项
*
* @name jQuery.array.remove
* @function
* @grammar jQuery.array.remove(source, match)
* @param {Array}
* source 需要移除项的数组
* @param {Any}
* match 要移除的项
* @meta standard
* @see jQuery.array.removeAt
*
* @returns {Array} 移除后的数组
*/
jQuery.array.remove = function(source, match) {
var len = source.length;
while (len--) {
if (len in source && source[len] === match) {
source.splice(len, 1);
}
}
return source;
};
/**
* 移除数组中的项
*
* @name jQuery.array.removeAt
* @function
* @grammar jQuery.array.removeAt(source, index)
* @param {Array}
* source 需要移除项的数组
* @param {number}
* index 要移除项的索引位置
* @see jQuery.array.remove
* @meta standard
* @returns {Any} 被移除的数组项
*/
jQuery.array.removeAt = function(source, index) {
return source.splice(index, 1)[0];
};
/**
* 过滤数组中的相同项。如果两个元素相同，会删除后一个元素。
*
* @name jQuery.array.unique
* @function
* @grammar jQuery.array.unique(source[, compareFn])
* @param {Array}
* source 需要过滤相同项的数组
* @param {Function}
* [compareFn] 比较两个数组项是否相同的函数,两个数组项作为函数的参数。
*
* @returns {Array} 过滤后的新数组
*/
jQuery.array.unique = function(source, compareFn) {
var len = source.length, result = source.slice(0), i, datum;
if ('function' != typeof compareFn) {
compareFn = function(item1, item2) {
return item1 === item2;
};
}
// 从后往前双重循环比较
// 如果两个元素相同，删除后一个
while (--len > 0) {
datum = result[len];
i = len;
while (i--) {
if (compareFn(datum, result[i])) {
result.splice(len, 1);
break;
}
}
}
return result;
};
// TODO
// ###################################cookie操作相关函数###################################
jQuery.cookie = jQuery.cookie || {};
/**
* 验证字符串是否合法的cookie键名
*
* @param {string}
* source 需要遍历的数组
* @meta standard
* @return {boolean} 是否合法的cookie键名
*/
jQuery.cookie.isValidKey = function(key) {
// http://www.w3.org/Protocols/rfc2109/rfc2109
// Syntax: General
// The two state management headers, Set-Cookie and Cookie, have common
// syntactic properties involving attribute-value pairs. The following
// grammar uses the notation, and tokens DIGIT (decimal digits) and
// token (informally, a sequence of non-special, non-white space
// characters) from the HTTP/1.1 specification [RFC 2068] to describe
// their syntax.
// av-pairs = av-pair *(";" av-pair)
// av-pair = attr ["=" value] ; optional value
// attr = token
// value = word
// word = token | quoted-string
// http://www.ietf.org/rfc/rfc2068.txt
// token = 1*<any CHAR except CTLs or tspecials>
// CHAR = <any US-ASCII character (octets 0 - 127)>
// CTL = <any US-ASCII control character
// (octets 0 - 31) and DEL (127)>
// tspecials = "(" | ")" | "<" | ">" | "@"
// | "," | ";" | ":" | "\" | <">
// | "/" | "[" | "]" | "?" | "="
// | "{" | "}" | SP | HT
// SP = <US-ASCII SP, space (32)>
// HT = <US-ASCII HT, horizontal-tab (9)>
return (new RegExp(
"^[^\\x00-\\x20\\x7f\\(\\)<>@,;:\\\\\\\"\\[\\]\\?=\\{\\}\\/\\u0080-\\uffff]+\x24"))
.test(key);
};
/**
* 获取cookie的值，用decodeURIComponent进行解码
*
* @name jQuery.cookie.get
* @function
* @grammar jQuery.cookie.get(key)
* @param {string}
* key 需要获取Cookie的键名
* @remark <b>注意：</b>该方法会对cookie值进行decodeURIComponent解码。如果想获得cookie源字符串，请使用getRaw方法。
* @meta standard
* @see jQuery.cookie.getRaw,jQuery.cookie.set
*
* @returns {string|null} cookie的值，获取不到时返回null
*/
jQuery.cookie.get = function(key) {
var value = jQuery.cookie.getRaw(key);
if ('string' == typeof value) {
value = decodeURIComponent(value);
return value;
}
return null;
};
/**
* 获取cookie的值，不对值进行解码
*
* @name jQuery.cookie.getRaw
* @function
* @grammar jQuery.cookie.getRaw(key)
* @param {string}
* key 需要获取Cookie的键名
* @meta standard
* @see jQuery.cookie.get,jQuery.cookie.setRaw
*
* @returns {string|null} 获取的Cookie值，获取不到时返回null
*/
jQuery.cookie.getRaw = function(key) {
if (jQuery.cookie.isValidKey(key)) {
var reg = new RegExp("(^| )" + key + "=([^;]*)(;|\x24)"), result = reg
.exec(document.cookie);
if (result) {
return result[2] || null;
}
}
return null;
};
/**
* 删除cookie的值
*
* @name jQuery.cookie.remove
* @function
* @grammar jQuery.cookie.remove(key, options)
* @param {string}
* key 需要删除Cookie的键名
* @param {Object}
* options 需要删除的cookie对应的 path domain 等值
* @meta standard
*/
jQuery.cookie.remove = function(key, options) {
options = options || {};
options.expires = new Date(0);
jQuery.cookie.setRaw(key, '', options);
};
/**
* 设置cookie的值，用encodeURIComponent进行编码
*
* @name jQuery.cookie.set
* @function
* @grammar jQuery.cookie.set(key, value[, options])
* @param {string}
* key 需要设置Cookie的键名
* @param {string}
* value 需要设置Cookie的值
* @param {Object}
* [options] 设置Cookie的其他可选参数
* @config {string} [path] cookie路径
* @config {Date|number} [expires] cookie过期时间,如果类型是数字的话, 单位是毫秒
* @config {string} [domain] cookie域名
* @config {string} [secure] cookie是否安全传输
* @remark
*
* 1. <b>注意：</b>该方法会对cookie值进行encodeURIComponent编码。如果想设置cookie源字符串，请使用setRaw方法。<br>
* <br>
* 2. <b>options参数包括：</b><br>
* path:cookie路径<br>
* expires:cookie过期时间，Number型，单位为毫秒。<br>
* domain:cookie域名<br>
* secure:cookie是否安全传输
*
* @meta standard
* @see jQuery.cookie.setRaw,jQuery.cookie.get
*/
jQuery.cookie.set = function(key, value, options) {
jQuery.cookie.setRaw(key, encodeURIComponent(value), options);
};
/**
* 设置cookie的值，不对值进行编码
*
* @name jQuery.cookie.setRaw
* @function
* @grammar jQuery.cookie.setRaw(key, value[, options])
* @param {string}
* key 需要设置Cookie的键名
* @param {string}
* value 需要设置Cookie的值
* @param {Object}
* [options] 设置Cookie的其他可选参数
* @config {string} [path] cookie路径
* @config {Date|number} [expires] cookie过期时间,如果类型是数字的话, 单位是毫秒
* @config {string} [domain] cookie域名
* @config {string} [secure] cookie是否安全传输
* @remark
*
* <b>options参数包括：</b><br>
* path:cookie路径<br>
* expires:cookie过期时间，Number型，单位为毫秒。<br>
* domain:cookie域名<br>
* secure:cookie是否安全传输
*
* @meta standard
* @see jQuery.cookie.set,jQuery.cookie.getRaw
*/
jQuery.cookie.setRaw = function(key, value, options) {
if (!jQuery.cookie.isValidKey(key)) {
return;
}
options = options || {};
// options.path = options.path || "/"; // meizz 20100402 设定一个初始值，方便后续的操作
// berg 20100409 去掉，因为用户希望默认的path是当前路径，这样和浏览器对cookie的定义也是一致的
// 计算cookie过期时间
var expires = options.expires;
if ('number' == typeof options.expires) {
expires = new Date();
expires.setTime(expires.getTime() + options.expires);
}
document.cookie = key + "=" + value
+ (options.path ? "; path=" + options.path : "")
+ (expires ? "; expires=" + expires.toGMTString() : "")
+ (options.domain ? "; domain=" + options.domain : "")
+ (options.secure ? "; secure" : '');
};
// TODO
// ###################################date操作相关函数###################################
jQuery.date = jQuery.date || {};
/**
* 对目标日期对象进行格式化
*
* @name jQuery.date.format
* @function
* @grammar jQuery.date.format(source, pattern)
* @param {Date}
* source 目标日期对象
* @param {string}
* pattern 日期格式化规则
* @remark
*
* <b>格式表达式，变量含义：</b><br>
* <br>
* hh: 带 0 补齐的两位 12 进制时表示<br>
* h: 不带 0 补齐的 12 进制时表示<br>
* HH: 带 0 补齐的两位 24 进制时表示<br>
* H: 不带 0 补齐的 24 进制时表示<br>
* mm: 带 0 补齐两位分表示<br>
* m: 不带 0 补齐分表示<br>
* ss: 带 0 补齐两位秒表示<br>
* s: 不带 0 补齐秒表示<br>
* yyyy: 带 0 补齐的四位年表示<br>
* yy: 带 0 补齐的两位年表示<br>
* MM: 带 0 补齐的两位月表示<br>
* M: 不带 0 补齐的月表示<br>
* dd: 带 0 补齐的两位日表示<br>
* d: 不带 0 补齐的日表示
*
*
* @returns {string} 格式化后的字符串
*/
jQuery.date.format = function(source, pattern) {
if ('string' != typeof pattern) {
return source.toString();
}
function replacer(patternPart, result) {
pattern = pattern.replace(patternPart, result);
}
var pad = jQuery.number.pad, year = source.getFullYear(), month = source
.getMonth() + 1, date2 = source.getDate(), hours = source
.getHours(), minutes = source.getMinutes(), seconds = source
.getSeconds();
replacer(/yyyy/g, pad(year, 4));
replacer(/yy/g, pad(parseInt(year.toString().slice(2), 10), 2));
replacer(/MM/g, pad(month, 2));
replacer(/M/g, month);
replacer(/dd/g, pad(date2, 2));
replacer(/d/g, date2);
replacer(/HH/g, pad(hours, 2));
replacer(/H/g, hours);
replacer(/hh/g, pad(hours % 12, 2));
replacer(/h/g, hours % 12);
replacer(/mm/g, pad(minutes, 2));
replacer(/m/g, minutes);
replacer(/ss/g, pad(seconds, 2));
replacer(/s/g, seconds);
return pattern;
};
/**
* 将目标字符串转换成日期对象
*
* @name jQuery.date.parse
* @function
* @grammar jQuery.date.parse(source)
* @param {string}
* source 目标字符串
* @remark
*
* 对于目标字符串，下面这些规则决定了 parse 方法能够成功地解析： <br>
* <ol>
* <li>短日期可以使用“/”或“-”作为日期分隔符，但是必须用月/日/年的格式来表示，例如"7/20/96"。</li>
* <li>以 "July 10 1995" 形式表示的长日期中的年、月、日可以按任何顺序排列，年份值可以用 2 位数字表示也可以用 4
* 位数字表示。如果使用 2 位数字来表示年份，那么该年份必须大于或等于 70。 </li>
* <li>括号中的任何文本都被视为注释。这些括号可以嵌套使用。 </li>
* <li>逗号和空格被视为分隔符。允许使用多个分隔符。 </li>
* <li>月和日的名称必须具有两个或两个以上的字符。如果两个字符所组成的名称不是独一无二的，那么该名称就被解析成最后一个符合条件的月或日。例如，"Ju"
* 被解释为七月而不是六月。 </li>
* <li>在所提供的日期中，如果所指定的星期几的值与按照该日期中剩余部分所确定的星期几的值不符合，那么该指定值就会被忽略。例如，尽管 1996 年 11
* 月 9 日实际上是星期五，"Tuesday November 9 1996" 也还是可以被接受并进行解析的。但是结果 date 对象中包含的是
* "Friday November 9 1996"。 </li>
* <li>JScript 处理所有的标准时区，以及全球标准时间 (UTC) 和格林威治标准时间 (GMT)。</li>
* <li>小时、分钟、和秒钟之间用冒号分隔，尽管不是这三项都需要指明。"10:"、"10:11"、和 "10:11:12" 都是有效的。 </li>
* <li>如果使用 24 小时计时的时钟，那么为中午 12 点之后的时间指定 "PM" 是错误的。例如 "23:15 PM" 就是错误的。</li>
* <li>包含无效日期的字符串是错误的。例如，一个包含有两个年份或两个月份的字符串就是错误的。</li>
* </ol>
*
*
* @returns {Date} 转换后的日期对象
*/
jQuery.date.parse = function(source) {
var reg = new RegExp("^\\d+(\\-|\\/)\\d+(\\-|\\/)\\d+\x24");
if ('string' == typeof source) {
if (reg.test(source) || isNaN(Date.parse(source))) {
var d = source.split(/ |T/), d1 = d.length > 1 ? d[1]
.split(/[^\d]/) : [ 0, 0, 0 ], d0 = d[0].split(/[^\d]/);
return new Date(d0[0] - 0, d0[1] - 1, d0[2] - 0, d1[0] - 0,
d1[1] - 0, d1[2] - 0);
} else {
return new Date(source);
}
}
return new Date();
};
// TODO
// ###################################url操作相关函数###################################
jQuery.url = jQuery.url || {};
/**
* 对字符串进行%#&+=以及和\s匹配的所有字符进行url转义
*
* @name jQuery.url.escapeSymbol
* @function
* @grammar jQuery.url.escapeSymbol(source)
* @param {string}
* source 需要转义的字符串.
* @return {string} 转义之后的字符串.
* @remark 用于get请求转义。在服务器只接受gbk，并且页面是gbk编码时，可以经过本转义后直接发get请求。
*
* @return {string} 转义后的字符串
*/
jQuery.url.escapeSymbol = function(source) {
// 之前使用\s来匹配任意空白符
// 发现在ie下无法匹配中文全角空格和纵向指标符\v，所以改\s为\f\r\n\t\v以及中文全角空格和英文空格
// 但是由于ie本身不支持纵向指标符\v,故去掉对其的匹配，保证各浏览器下效果一致
return String(source).replace(
/[#%&+=\/\\\ \ \f\r\n\t]/g,
function(all) {
return '%'
+ (0x100 + all.charCodeAt()).toString(16).substring(1)
.toUpperCase();
});
};
/**
* 根据参数名从目标URL中获取参数值
*
* @name jQuery.url.getQueryValue
* @function
* @grammar jQuery.url.getQueryValue(url, key)
* @param {string}
* url 目标URL
* @param {string}
* key 要获取的参数名
* @meta standard
* @see jQuery.url.jsonToQuery
*
* @returns {string|null} - 获取的参数值，其中URI编码后的字符不会被解码，获取不到时返回null
*/
jQuery.url.getQueryValue = function(url, key) {
var reg = new RegExp("(^|&|\\?|#)" + jQuery.string.escapeReg(key)
+ "=([^&#]*)(&|\x24|#)", "");
var match = url.match(reg);
if (match) {
return match[2];
}
return null;
};
/**
* 将json对象解析成query字符串
*
* @name jQuery.url.jsonToQuery
* @function
* @grammar jQuery.url.jsonToQuery(json[, replacer])
* @param {Object}
* json 需要解析的json对象
* @param {Function=}
* replacer_opt 对值进行特殊处理的函数，function (value, key)
* @see jQuery.url.queryToJson,jQuery.url.getQueryValue
*
* @return {string} - 解析结果字符串，其中值将被URI编码，{a:'&1 '} ==> "a=%261%20"。
*/
jQuery.url.jsonToQuery = function(json, replacer_opt) {
var result = [], itemLen, replacer = replacer_opt || function(value) {
return jQuery.url.escapeSymbol(value);
};
jQuery.object.each(json, function(item, key) {
// 这里只考虑item为数组、字符串、数字类型，不考虑嵌套的object
if (jQuery.lang.isArray(item)) {
itemLen = item.length;
// value的值需要encodeURIComponent转义吗？
// FIXED 优化了escapeSymbol函数
while (itemLen--) {
result.push(key + '=' + replacer(item[itemLen], key));
}
} else {
result.push(key + '=' + replacer(item, key));
}
});
return result.join('&');
};
/**
* 解析目标URL中的参数成json对象
*
* @name jQuery.url.queryToJson
* @function
* @grammar jQuery.url.queryToJson(url)
* @param {string}
* url 目标URL
* @see jQuery.url.jsonToQuery
*
* @returns {Object} - 解析为结果对象，其中URI编码后的字符不会被解码，'a=%20' ==> {a:'%20'}。
*/
jQuery.url.queryToJson = function(url) {
var query = url.substr(url.lastIndexOf('?') + 1), params = query.split('&'), len = params.length, result = {}, i = 0, key, value, item, param;
for (; i < len; i++) {
if (!params[i]) {
continue;
}
param = params[i].split('=');
key = param[0];
value = param[1];
item = result[key];
if ('undefined' == typeof item) {
result[key] = value;
} else if (jQuery.lang.isArray(item)) {
item.push(value);
} else { // 这里只可能是string了
result[key] = [ item, value ];
}
}
return result;
};
// TODO这个函数的实现方式还有待检验
jQuery.url.getContextPath = function() {
var path = String(window.document.location);
return path.substring(0, path.lastIndexOf("/"));
};
// TODO
// ###################################form操作相关函数###################################
jQuery.form = jQuery.form || {};
/**
* josn化表单数据
*
* @name jQuery.form.json
* @function
* @grammar jQuery.form.json(form[, replacer])
* @param {HTMLFormElement}
* form 需要提交的表单元素
* @param {Function}
* replacer 对参数值特殊处理的函数,replacer(string value, string key)
*
* @returns {data} 表单数据js对象
*/
jQuery.form.json = function(form, replacer) {
var elements = form.elements, replacer = replacer || function(value, name) {
return value;
}, data = {}, item, itemType, itemName, itemValue, opts, oi, oLen, oItem;
/**
* 向缓冲区添加参数数据
*
* @private
*/
function addData(name, value) {
var val = data[name];
if (val) {
val.push || (data[name] = [ val ]);
data[name].push(value);
} else {
data[name] = value;
}
}
for ( var i = 0, len = elements.length; i < len; i++) {
item = elements[i];
itemName = item.name;
// 处理：可用并包含表单name的表单项
if (!item.disabled && itemName) {
itemType = item.type;
itemValue = jQuery.url.escapeSymbol(item.value);
switch (itemType) {
// radio和checkbox被选中时，拼装queryString数据
case 'radio':
case 'checkbox':
if (!item.checked) {
break;
}
// 默认类型，拼装queryString数据
case 'textarea':
case 'text':
case 'password':
case 'hidden':
case 'file':
case 'select-one':
addData(itemName, replacer(itemValue, itemName));
break;
// 多行选中select，拼装所有选中的数据
case 'select-multiple':
opts = item.options;
oLen = opts.length;
for (oi = 0; oi < oLen; oi++) {
oItem = opts[oi];
if (oItem.selected) {
addData(itemName, replacer(oItem.value, itemName));
}
}
break;
}
}
}
return data;
};
/**
* 序列化表单数据
*
* @name jQuery.form.serialize
* @function
* @grammar jQuery.form.serialize(form[, replacer])
* @param {HTMLFormElement}
* form 需要提交的表单元素
* @param {Function}
* replacer 对参数值特殊处理的函数,replacer(string value, string key)
*
* @returns {data} 表单数据数组
*/
jQuery.form.serialize = function(form, replacer) {
var elements = form.elements, replacer = replacer || function(value, name) {
return value;
}, data = [], item, itemType, itemName, itemValue, opts, oi, oLen, oItem;
/**
* 向缓冲区添加参数数据
*
* @private
*/
function addData(name, value) {
data.push(name + '=' + value);
}
for ( var i = 0, len = elements.length; i < len; i++) {
item = elements[i];
itemName = item.name;
// 处理：可用并包含表单name的表单项
if (!item.disabled && itemName) {
itemType = item.type;
itemValue = jQuery.url.escapeSymbol(item.value);
switch (itemType) {
// radio和checkbox被选中时，拼装queryString数据
case 'radio':
case 'checkbox':
if (!item.checked) {
break;
}
// 默认类型，拼装queryString数据
case 'textarea':
case 'text':
case 'password':
case 'hidden':
case 'file':
case 'select-one':
addData(itemName, replacer(itemValue, itemName));
break;
// 多行选中select，拼装所有选中的数据
case 'select-multiple':
opts = item.options;
oLen = opts.length;
for (oi = 0; oi < oLen; oi++) {
oItem = opts[oi];
if (oItem.selected) {
addData(itemName, replacer(oItem.value, itemName));
}
}
break;
}
}
}
return data;
};
/**
* 找到表单的第一个元素，未找到则返回null
*
* @name jQuery.form.findFirstElement
* @function
* @grammar jQuery.form.findFirstElement(form)
* @param {HTMLFormElement}
* form 需要查找的表单元素
* @returns {data} 表单的第一个元素
*/
jQuery.form.findFirstElement = function(form) {
var elements = null;
if (!(elements = form.elements) || typeof elements.length !== "number"
|| elements.length === 0) {
return null;
}
return elements[0];
};
/**
* 为表单的第一个元素设置焦点，找不到这个元素则什么都不做
*
* @name jQuery.form.focusFirstElement
* @function
* @grammar jQuery.form.focusFirstElement(form)
* @param {HTMLFormElement}
* form 需要查找的表单元素
*/
jQuery.form.focusFirstElement = function(form) {
var elements = null;
if (!(elements = form.elements) || typeof elements.length !== "number"
|| elements.length === 0) {
return;
}
jQuery(elements[0]).focus();
};
// TODO
// ###################################json操作相关函数###################################
jQuery.json = jQuery.json || {};
/**
* 将字符串解析成json对象。注：不会自动祛除空格
*
* @name jQuery.json.parse
* @function
* @grammar jQuery.json.parse(data)
* @param {string}
* source 需要解析的字符串
* @remark 该方法的实现与ecma-262第五版中规定的JSON.parse不同，暂时只支持传入一个参数。后续会进行功能丰富。
* @meta standard
* @see jQuery.json.stringify,jQuery.json.decode
*
* @returns {JSON} 解析结果json对象
*/
jQuery.json.parse = function(data) {
// 2010/12/09：更新至不使用原生parse，不检测用户输入是否正确
return (new Function("return (" + data + ")"))();
};
/**
* 将json对象序列化
*
* @name jQuery.json.stringify
* @function
* @grammar jQuery.json.stringify(value)
* @param {JSON}
* value 需要序列化的json对象
* @remark 该方法的实现与ecma-262第五版中规定的JSON.stringify不同，暂时只支持传入一个参数。后续会进行功能丰富。
* @meta standard
* @see jQuery.json.parse,jQuery.json.encode
*
* @returns {string} 序列化后的字符串
*/
jQuery.json.stringify = (function() {
/**
* 字符串处理时需要转义的字符表
*
* @private
*/
var escapeMap = {
"\b" : '\\b',
"\t" : '\\t',
"\n" : '\\n',
"\f" : '\\f',
"\r" : '\\r',
'"' : '\\"',
"\\" : '\\\\'
};
/**
* 字符串序列化
*
* @private
*/
function encodeString(source) {
if (/["\\\x00-\x1f]/.test(source)) {
source = source.replace(/["\\\x00-\x1f]/g, function(match) {
var c = escapeMap[match];
if (c) {
return c;
}
c = match.charCodeAt();
return "\\u00" + Math.floor(c / 16).toString(16)
+ (c % 16).toString(16);
});
}
return '"' + source + '"';
}
/**
* 数组序列化
*
* @private
*/
function encodeArray(source) {
var result = [ "[" ], l = source.length, preComma, i, item;
for (i = 0; i < l; i++) {
item = source[i];
switch (typeof item) {
case "undefined":
case "function":
case "unknown":
break;
default:
if (preComma) {
result.push(',');
}
result.push(jQuery.json.stringify(item));
preComma = 1;
}
}
result.push("]");
return result.join("");
}
/**
* 处理日期序列化时的补零
*
* @private
*/
function pad(source) {
return source < 10 ? '0' + source : source;
}
/**
* 日期序列化
*
* @private
*/
function encodeDate(source) {
return '"' + source.getFullYear() + "-" + pad(source.getMonth() + 1)
+ "-" + pad(source.getDate()) + "T" + pad(source.getHours())
+ ":" + pad(source.getMinutes()) + ":"
+ pad(source.getSeconds()) + '"';
}
return function(value) {
switch (typeof value) {
case 'undefined':
return 'undefined';
case 'number':
return isFinite(value) ? String(value) : "null";
case 'string':
return encodeString(value);
case 'boolean':
return String(value);
default:
if (value === null) {
return 'null';
} else if (value instanceof Array) {
return encodeArray(value);
} else if (value instanceof Date) {
return encodeDate(value);
} else {
var result = [ '{' ], encode = jQuery.json.stringify, preComma, item;
for ( var key in value) {
if (Object.prototype.hasOwnProperty.call(value, key)) {
item = value[key];
switch (typeof item) {
case 'undefined':
case 'unknown':
case 'function':
break;
default:
if (preComma) {
result.push(',');
}
preComma = 1;
result.push(encode(key) + ':' + encode(item));
}
}
}
result.push('}');
return result.join('');
}
}
};
})();
// TODO
// ###################################lang操作相关函数###################################
jQuery.lang = jQuery.lang || {};
/**
* 判断目标参数是否Array对象
*
* @name jQuery.lang.isArray
* @function
* @grammar jQuery.lang.isArray(source)
* @param {Any}
* source 目标参数
* @meta standard
* @see jQuery.lang.isString,jQuery.lang.isObject,jQuery.lang.isNumber,jQuery.lang.isElement,jQuery.lang.isBoolean,jQuery.lang.isDate
*
* @returns {boolean} 类型判断结果
*/
jQuery.lang.isArray = function(source) {
return '[object Array]' == Object.prototype.toString.call(source);
};
/**
* 判断目标参数是否Boolean对象
*
* @name jQuery.lang.isBoolean
* @function
* @grammar jQuery.lang.isBoolean(source)
* @param {Any}
* source 目标参数
* @version 1.3
* @see jQuery.lang.isString,jQuery.lang.isObject,jQuery.lang.isNumber,jQuery.lang.isElement,jQuery.lang.isArray,jQuery.lang.isDate
*
* @returns {boolean} 类型判断结果
*/
jQuery.lang.isBoolean = function(o) {
return typeof o === 'boolean';
};
/**
* 判断目标参数是否为Date对象
*
* @name jQuery.lang.isDate
* @function
* @grammar jQuery.lang.isDate(source)
* @param {Any}
* source 目标参数
* @version 1.3
* @see jQuery.lang.isString,jQuery.lang.isObject,jQuery.lang.isNumber,jQuery.lang.isArray,jQuery.lang.isBoolean,jQuery.lang.isElement
*
* @returns {boolean} 类型判断结果
*/
jQuery.lang.isDate = function(o) {
// return o instanceof Date;
return {}.toString.call(o) === "[object Date]"
&& o.toString() !== 'Invalid Date' && !isNaN(o);
};
/**
* 判断目标参数是否为Element对象
*
* @name jQuery.lang.isElement
* @function
* @grammar jQuery.lang.isElement(source)
* @param {Any}
* source 目标参数
* @meta standard
* @see jQuery.lang.isString,jQuery.lang.isObject,jQuery.lang.isNumber,jQuery.lang.isArray,jQuery.lang.isBoolean,jQuery.lang.isDate
*
* @returns {boolean} 类型判断结果
*/
jQuery.lang.isElement = function(source) {
return !!(source && source.nodeName && source.nodeType == 1);
};
/**
* 判断目标参数是否为function或Function实例
*
* @name jQuery.lang.isFunction
* @function
* @grammar jQuery.lang.isFunction(source)
* @param {Any}
* source 目标参数
* @version 1.2
* @see jQuery.lang.isString,jQuery.lang.isObject,jQuery.lang.isNumber,jQuery.lang.isArray,jQuery.lang.isElement,jQuery.lang.isBoolean,jQuery.lang.isDate
* @meta standard
* @returns {boolean} 类型判断结果
*/
jQuery.lang.isFunction = function(source) {
// chrome下,'function' == typeof /a/ 为true.
return '[object Function]' == Object.prototype.toString.call(source);
};
/**
* 判断目标参数是否number类型或Number对象
*
* @name jQuery.lang.isNumber
* @function
* @grammar jQuery.lang.isNumber(source)
* @param {Any}
* source 目标参数
* @meta standard
* @see jQuery.lang.isString,jQuery.lang.isObject,jQuery.lang.isArray,jQuery.lang.isElement,jQuery.lang.isBoolean,jQuery.lang.isDate
*
* @returns {boolean} 类型判断结果
* @remark 用本函数判断NaN会返回false，尽管在Javascript中是Number类型。
*/
jQuery.lang.isNumber = function(source) {
return '[object Number]' == Object.prototype.toString.call(source)
&& isFinite(source);
};
/**
* 判断目标参数是否为Object对象
*
* @name jQuery.lang.isObject
* @function
* @grammar jQuery.lang.isObject(source)
* @param {Any}
* source 目标参数
* @shortcut isObject
* @meta standard
* @see jQuery.lang.isString,jQuery.lang.isNumber,jQuery.lang.isArray,jQuery.lang.isElement,jQuery.lang.isBoolean,jQuery.lang.isDate
*
* @returns {boolean} 类型判断结果
*/
jQuery.lang.isObject = function(source) {
return 'function' == typeof source
|| !!(source && 'object' == typeof source);
};
/**
* 判断目标参数是否string类型或String对象
*
* @name jQuery.lang.isString
* @function
* @grammar jQuery.lang.isString(source)
* @param {Any}
* source 目标参数
* @shortcut isString
* @meta standard
* @see jQuery.lang.isObject,jQuery.lang.isNumber,jQuery.lang.isArray,jQuery.lang.isElement,jQuery.lang.isBoolean,jQuery.lang.isDate
*
* @returns {boolean} 类型判断结果
*/
jQuery.lang.isString = function(source) {
return '[object String]' == Object.prototype.toString.call(source);
};
/**
* 将一个变量转换成array
*
* @name jQuery.lang.toArray
* @function
* @grammar jQuery.lang.toArray(source)
* @param {mix}
* source 需要转换成array的变量
* @version 1.3
* @meta standard
* @returns {array} 转换后的array
*/
jQuery.lang.toArray = function(source) {
if (source === null || source === undefined)
return [];
if (jQuery.lang.isArray(source))
return source;
// The strings and functions also have 'length'
if (typeof source.length !== 'number' || typeof source === 'string'
|| jQuery.lang.isFunction(source)) {
return [ source ];
}
// nodeList, IE 下调用 [].slice.call(nodeList) 会报错
if (source.item) {
var l = source.length, array = new Array(l);
while (l--)
array[l] = source[l];
return array;
}
return [].slice.call(source);
};
// TODO
// ###################################number操作相关函数###################################
jQuery.number = jQuery.number || {};
/**
* 对数字进行格式化
*
* @name jQuery.number.format
* @function
* @grammar jQuery.number.format(number, pattern)
* @param {number}
* source 需要处理的数字
* @param {number}
* pattern 格式化规则，例如format('12432.415','#,###.0#')='12,432.42'
*
* @returns {string} 对目标数字进行格式化之后的处理结果
*/
jQuery.number.format = function(source, pattern) {
var str = source.toString();
var strInt;
var strFloat;
var formatInt;
var formatFloat;
if (/\./g.test(pattern)) {
formatInt = pattern.split('.')[0];
formatFloat = pattern.split('.')[1];
} else {
formatInt = pattern;
formatFloat = null;
}
if (/\./g.test(str)) {
if (formatFloat != null) {
var tempFloat = Math.round(parseFloat('0.' + str.split('.')[1])
* Math.pow(10, formatFloat.length))
/ Math.pow(10, formatFloat.length);
strInt = (Math.floor(source) + Math.floor(tempFloat)).toString();
strFloat = /\./g.test(tempFloat.toString()) ? tempFloat.toString()
.split('.')[1] : '0';
} else {
strInt = Math.round(source).toString();
strFloat = '0';
}
} else {
strInt = str;
strFloat = '0';
}
if (formatInt != null) {
var outputInt = '';
var zero = formatInt.match(/0*$/)[0].length;
var comma = null;
if (/,/g.test(formatInt)) {
comma = formatInt.match(/,[^,]*/)[0].length - 1;
}
var newReg = new RegExp('(\\d{' + comma + '})', 'g');
if (strInt.length < zero) {
outputInt = new Array(zero + 1).join('0') + strInt;
outputInt = outputInt.substr(outputInt.length - zero, zero);
} else {
outputInt = strInt;
}
var outputInt = outputInt.substr(0, outputInt.length % comma)
+ outputInt.substring(outputInt.length % comma).replace(newReg,
(comma != null ? ',' : '') + '$1');
outputInt = outputInt.replace(/^,/, '');
strInt = outputInt;
}
if (formatFloat != null) {
var outputFloat = '';
var zero = formatFloat.match(/^0*/)[0].length;
if (strFloat.length < zero) {
outputFloat = strFloat + new Array(zero + 1).join('0');
// outputFloat = outputFloat.substring(0,formatFloat.length);
var outputFloat1 = outputFloat.substring(0, zero);
var outputFloat2 = outputFloat.substring(zero, formatFloat.length);
outputFloat = outputFloat1 + outputFloat2.replace(/0*$/, '');
} else {
outputFloat = strFloat.substring(0, formatFloat.length);
}
strFloat = outputFloat;
} else {
if (pattern != '' || (pattern == '' && strFloat == '0')) {
strFloat = '';
}
}
return strInt + (strFloat == '' ? '' : '.' + strFloat);
};
/**
* 生成随机整数，范围是[min, max]
*
* @name jQuery.number.randomInt
* @function
* @grammar jQuery.number.randomInt(min, max)
*
* @param {number}
* min 随机整数的最小值
* @param {number}
* max 随机整数的最大值
* @return {number} 生成的随机整数
*/
jQuery.number.randomInt = function(min, max) {
return Math.floor(Math.random() * (max - min + 1) + min);
};
// 链接到Math类的一些方法
jQuery.number.abs = Math.abs;
jQuery.number.ceil = Math.ceil;
jQuery.number.floor = Math.floor;
jQuery.number.round = Math.round;
jQuery.number.min = Math.min;
jQuery.number.max = Math.max;
// TODO
// ###################################page操作相关函数###################################
jQuery.page = jQuery.page || {};
/**
* 获取横向滚动量
*
* @return {number} 横向滚动量
*/
jQuery.page.getScrollLeft = function() {
var d = document;
return window.pageXOffset || d.documentElement.scrollLeft
|| d.body.scrollLeft;
};
/**
* 获取纵向滚动量
*
* @name jQuery.page.getScrollTop
* @function
* @grammar jQuery.page.getScrollTop()
* @see jQuery.page.getScrollLeft
* @meta standard
* @returns {number} 纵向滚动量
*/
jQuery.page.getScrollTop = function() {
var d = document;
return window.pageYOffset || d.documentElement.scrollTop
|| d.body.scrollTop;
};
/**
* 获取页面视觉区域高度
*
* @name jQuery.page.getViewHeight
* @function
* @grammar jQuery.page.getViewHeight()
* @see jQuery.page.getViewWidth
* @meta standard
* @returns {number} 页面视觉区域高度
*/
jQuery.page.getViewHeight = function() {
var doc = document, client = doc.compatMode == 'BackCompat' ? doc.body
: doc.documentElement;
return client.clientHeight;
};
/**
* 获取页面视觉区域宽度
*
* @name jQuery.page.getViewWidth
* @function
* @grammar jQuery.page.getViewWidth()
* @see jQuery.page.getViewHeight
*
* @returns {number} 页面视觉区域宽度
*/
jQuery.page.getViewWidth = function() {
var doc = document, client = doc.compatMode == 'BackCompat' ? doc.body
: doc.documentElement;
return client.clientWidth;
};
/**
* 动态在页面上加载一个外部js文件
*
* @name jQuery.page.loadJsFile
* @function
* @grammar jQuery.page.loadJsFile(path)
* @param {string}
* path js文件路径
* @see jQuery.page.loadCssFile
*/
jQuery.page.loadJsFile = function(path) {
var element = document.createElement('script');
element.setAttribute('type', 'text/javascript');
element.setAttribute('src', path);
element.setAttribute('defer', 'defer');
document.getElementsByTagName("head")[0].appendChild(element);
};
/**
* 动态在页面上加载一个外部css文件
*
* @name jQuery.page.loadCssFile
* @function
* @grammar jQuery.page.loadCssFile(path)
* @param {string}
* path css文件路径
* @see jQuery.page.loadJsFile
*/
jQuery.page.loadCssFile = function(path) {
var element = document.createElement("link");
element.setAttribute("rel", "stylesheet");
element.setAttribute("type", "text/css");
element.setAttribute("href", path);
document.getElementsByTagName("head")[0].appendChild(element);
};
// TODO
// ###################################swf操作相关函数###################################
jQuery.swf = jQuery.swf || {};
/**
* 浏览器支持的flash插件版本
*
* @property version 浏览器支持的flash插件版本
* @grammar jQuery.swf.version
* @return {String} 版本号
* @meta standard
*/
jQuery.swf.version = (function() {
var n = navigator;
if (n.plugins && n.mimeTypes.length) {
var plugin = n.plugins["Shockwave Flash"];
if (plugin && plugin.description) {
return plugin.description.replace(/([a-zA-Z]|\s)+/, "").replace(
/(\s)+r/, ".")
+ ".0";
}
} else if (window.ActiveXObject && !window.opera) {
for ( var i = 12; i >= 2; i--) {
try {
var c = new ActiveXObject('ShockwaveFlash.ShockwaveFlash.' + i);
if (c) {
var version = c.GetVariable("$version");
return version.replace(/WIN/g, '').replace(/,/g, '.');
}
} catch (e) {
}
}
}
})();
/**
* 创建flash对象的html字符串
*
* @name jQuery.swf.createHTML
* @function
* @grammar jQuery.swf.createHTML(options)
*
* @param {Object}
* options 创建flash的选项参数
* @param {string}
* options.id 要创建的flash的标识
* @param {string}
* options.url flash文件的url
* @param {String}
* options.errorMessage 未安装flash player或flash player版本号过低时的提示
* @param {string}
* options.ver 最低需要的flash player版本号
* @param {string}
* options.width flash的宽度
* @param {string}
* options.height flash的高度
* @param {string}
* options.align flash的对齐方式，允许值：middle/left/right/top/bottom
* @param {string}
* options.base 设置用于解析swf文件中的所有相对路径语句的基本目录或URL
* @param {string}
* options.bgcolor swf文件的背景色
* @param {string}
* options.salign
* 设置缩放的swf文件在由width和height设置定义的区域内的位置。允许值：l/r/t/b/tl/tr/bl/br
* @param {boolean}
* options.menu 是否显示右键菜单，允许值：true/false
* @param {boolean}
* options.loop 播放到最后一帧时是否重新播放，允许值： true/false
* @param {boolean}
* options.play flash是否在浏览器加载时就开始播放。允许值：true/false
* @param {string}
* options.quality
* 设置flash播放的画质，允许值：low/medium/high/autolow/autohigh/best
* @param {string}
* options.scale 设置flash内容如何缩放来适应设置的宽高。允许值：showall/noborder/exactfit
* @param {string}
* options.wmode 设置flash的显示模式。允许值：window/opaque/transparent
* @param {string}
* options.allowscriptaccess
* 设置flash与页面的通信权限。允许值：always/never/sameDomain
* @param {string}
* options.allownetworking 设置swf文件中允许使用的网络API。允许值：all/internal/none
* @param {boolean}
* options.allowfullscreen 是否允许flash全屏。允许值：true/false
* @param {boolean}
* options.seamlesstabbing
* 允许设置执行无缝跳格，从而使用户能跳出flash应用程序。该参数只能在安装Flash7及更高版本的Windows中使用。允许值：true/false
* @param {boolean}
* options.devicefont 设置静态文本对象是否以设备字体呈现。允许值：true/false
* @param {boolean}
* options.swliveconnect 第一次加载flash时浏览器是否应启动Java。允许值：true/false
* @param {Object}
* options.vars 要传递给flash的参数，支持JSON或string类型。
*
* @see jQuery.swf.create
* @meta standard
* @returns {string} flash对象的html字符串
*/
jQuery.swf.createHTML = function(options) {
options = options || {};
var version = jQuery.swf.version, needVersion = options['ver'] || '6.0.0', vUnit1, vUnit2, i, k, len, item, tmpOpt = {}, encodeHTML = jQuery.string.encodeHTML;
// 复制options，避免修改原对象
for (k in options) {
tmpOpt[k] = options[k];
}
options = tmpOpt;
// 浏览器支持的flash插件版本判断
if (version) {
version = version.split('.');
needVersion = needVersion.split('.');
for (i = 0; i < 3; i++) {
vUnit1 = parseInt(version[i], 10);
vUnit2 = parseInt(needVersion[i], 10);
if (vUnit2 < vUnit1) {
break;
} else if (vUnit2 > vUnit1) {
return ''; // 需要更高的版本号
}
}
} else {
return ''; // 未安装flash插件
}
var vars = options['vars'], objProperties = [ 'classid', 'codebase', 'id',
'width', 'height', 'align' ];
// 初始化object标签需要的classid、codebase属性值
options['align'] = options['align'] || 'middle';
options['classid'] = 'clsid:d27cdb6e-ae6d-11cf-96b8-444553540000';
options['codebase'] = 'http://fpdownload.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=6,0,0,0';
options['movie'] = options['url'] || '';
delete options['vars'];
delete options['url'];
// 初始化flashvars参数的值
if ('string' == typeof vars) {
options['flashvars'] = vars;
} else {
var fvars = [];
for (k in vars) {
item = vars[k];
fvars.push(k + "=" + encodeURIComponent(item));
}
options['flashvars'] = fvars.join('&');
}
// 构建IE下支持的object字符串，包括属性和参数列表
var str = [ '<object ' ];
for (i = 0, len = objProperties.length; i < len; i++) {
item = objProperties[i];
str.push(' ', item, '="', encodeHTML(options[item]), '"');
}
str.push('>');
var params = {
'wmode' : 1,
'scale' : 1,
'quality' : 1,
'play' : 1,
'loop' : 1,
'menu' : 1,
'salign' : 1,
'bgcolor' : 1,
'base' : 1,
'allowscriptaccess' : 1,
'allownetworking' : 1,
'allowfullscreen' : 1,
'seamlesstabbing' : 1,
'devicefont' : 1,
'swliveconnect' : 1,
'flashvars' : 1,
'movie' : 1
};
for (k in options) {
item = options[k];
k = k.toLowerCase();
if (params[k] && (item || item === false || item === 0)) {
str.push('<param name="' + k + '" value="' + encodeHTML(item)
+ '" />');
}
}
// 使用embed时，flash地址的属性名是src，并且要指定embed的type和pluginspage属性
options['src'] = options['movie'];
options['name'] = options['id'];
delete options['id'];
delete options['movie'];
delete options['classid'];
delete options['codebase'];
options['type'] = 'application/x-shockwave-flash';
options['pluginspage'] = 'http://www.macromedia.com/go/getflashplayer';
// 构建embed标签的字符串
str.push('<embed');
// 在firefox、opera、safari下，salign属性必须在scale属性之后，否则会失效
// 经过讨论，决定采用BT方法，把scale属性的值先保存下来，最后输出
var salign;
for (k in options) {
item = options[k];
if (item || item === false || item === 0) {
if ((new RegExp("^salign\x24", "i")).test(k)) {
salign = item;
continue;
}
str.push(' ', k, '="', encodeHTML(item), '"');
}
}
if (salign) {
str.push(' salign="', encodeHTML(salign), '"');
}
str.push('></embed></object>');
return str.join('');
};
/**
* 在页面中创建一个flash对象
*
* @name jQuery.swf.create
* @function
* @grammar jQuery.swf.create(options[, container])
*
* @param {Object}
* options 创建flash的选项参数
* @param {string}
* options.id 要创建的flash的标识
* @param {string}
* options.url flash文件的url
* @param {String}
* options.errorMessage 未安装flash player或flash player版本号过低时的提示
* @param {string}
* options.ver 最低需要的flash player版本号
* @param {string}
* options.width flash的宽度
* @param {string}
* options.height flash的高度
* @param {string}
* options.align flash的对齐方式，允许值：middle/left/right/top/bottom
* @param {string}
* options.base 设置用于解析swf文件中的所有相对路径语句的基本目录或URL
* @param {string}
* options.bgcolor swf文件的背景色
* @param {string}
* options.salign
* 设置缩放的swf文件在由width和height设置定义的区域内的位置。允许值：l/r/t/b/tl/tr/bl/br
* @param {boolean}
* options.menu 是否显示右键菜单，允许值：true/false
* @param {boolean}
* options.loop 播放到最后一帧时是否重新播放，允许值： true/false
* @param {boolean}
* options.play flash是否在浏览器加载时就开始播放。允许值：true/false
* @param {string}
* options.quality
* 设置flash播放的画质，允许值：low/medium/high/autolow/autohigh/best
* @param {string}
* options.scale 设置flash内容如何缩放来适应设置的宽高。允许值：showall/noborder/exactfit
* @param {string}
* options.wmode 设置flash的显示模式。允许值：window/opaque/transparent
* @param {string}
* options.allowscriptaccess
* 设置flash与页面的通信权限。允许值：always/never/sameDomain
* @param {string}
* options.allownetworking 设置swf文件中允许使用的网络API。允许值：all/internal/none
* @param {boolean}
* options.allowfullscreen 是否允许flash全屏。允许值：true/false
* @param {boolean}
* options.seamlesstabbing
* 允许设置执行无缝跳格，从而使用户能跳出flash应用程序。该参数只能在安装Flash7及更高版本的Windows中使用。允许值：true/false
* @param {boolean}
* options.devicefont 设置静态文本对象是否以设备字体呈现。允许值：true/false
* @param {boolean}
* options.swliveconnect 第一次加载flash时浏览器是否应启动Java。允许值：true/false
* @param {Object}
* options.vars 要传递给flash的参数，支持JSON或string类型。
*
* @param {HTMLElement|string}
* [container] flash对象的父容器元素，不传递该参数时在当前代码位置创建flash对象。
* @meta standard
* @see jQuery.swf.createHTML,jQuery.swf.getMovie
*/
jQuery.swf.create = function(options, target) {
options = options || {};
var html = jQuery.swf.createHTML(options) || options['errorMessage'] || '';
if (target && 'string' == typeof target) {
target = document.getElementById(target);
}
// TODO这个地方被我改过，原来是这样的：
// jQuery.dom.insertHTML(target || document.body, 'beforeEnd', html);
// 但这需要引入dom相关api，百度的dom相关的api不大好，所以改成jQuery的
$(target || document.body).append(html);
};
一个jQuery扩展工具包的更多相关文章
- 26、ASP.NET MVC入门到精通——后台管理区域及分离、Js压缩、css、jquery扩展
本系列目录:ASP.NET MVC4入门到精通系列目录汇总 有好一段时间没更新博文了,最近在忙两件事:1.看书,学习中...2.为公司年会节目做准备,由于许久没有练习双截棍了,难免生疏,所以现在临时抱 ...
- 区域及分离、Js压缩、css、jquery扩展
后台管理区域及分离.Js压缩.css.jquery扩展 本系列目录:ASP.NET MVC4入门到精通系列目录汇总 有好一段时间没更新博文了,最近在忙两件事:1.看书,学习中...2.为公司年会节目做 ...
- 一个动态扩展表格控件列和行的 jQuery 插件
一个动态扩展表格控件列和行的 jQuery 插件 不过这并不影响使用鸭! 看这里:https://github.com/zhuwansu/table-ext.js 一个简单的示范 html <t ...
- 从零开始，DIY一个jQuery（3）
在前两章,为了方便调试,我们写了一个非常简单的 jQuery.fn.init 方法: jQuery.fn.init = function (selector, context, root) { if ...
- 从零开始，DIY一个jQuery（2）
在上篇文章我们简单实现了一个 jQuery 的基础结构,不过为了顺应潮流,这次咱把它改为模块化的写法,此举得以有效提升项目的可维护性,因此在后续也将以模块化形式进行持续开发. 模块化开发和编译需要用上 ...
- Python之Web前端jQuery扩展
Python之Web前端: 一. jQuery表单验证 二. jQuery扩展 三. 滚动菜单 一. jQuery表单验证: 任何可以交互的站点都有输入表单,只要有可能,就应该对用户输入的数据进行验证 ...
- jquery扩展（- _ -//
如何写一个Jquery 之前看了好多网上的例子,讲真,不知其所以然,生搬硬套.其实自己还是一脸的懵B,想想还真的有必要仔细研读一下书籍. 言归正传,正式巴拉巴拉笔记 扩展Jquery什么鬼??? 三个 ...
- 使用jquery获取url及url参数的方法及定义JQuery扩展方法
1.jquery获取url很简单,代码如下: window.location.href; 其实只是用到了javascript的基础的window对象,并没有用jquery的知识. 2.jquery获取 ...
- Jquery扩展-手把手带你体验
Jquery扩展是在项目中经常用到的,有时候为了提取一些公共方法,有时候为了模块化管理等等,下面我们来体验一下.当然扩展离不开Jquery几个基础方法 1:$.extend() 2:$.fn.func ...
随机推荐
- C++ STL疑惑知识点
1.remove的问题 用法参考:http://www.cnblogs.com/heyonggang/p/3263568.html
- 让pre标签自动换行示例代码
pre 元素可定义预格式化的文本.被包围在 pre 元素中的文本通常会保留空格和换行符.而文本也会呈现为等宽字体. <pre> 标签的一个常见应用就是用来表示计算机的源代码.对于技术博客经 ...
- eclipse 编辑器的使用
随着所编辑的文件数目的增加以及在这些文件之间的快速切换,一个又一个文件的编码以及对编辑器会话(session)的管理将会变得非常复杂.这时,有几件事情你是可以做的. 通过使用键盘快捷键,你可以快速选择 ...
- mapreduce编程模型你知道多少？
上次新霸哥给大家介绍了一些hadoop的相关知识,发现大家对hadoop有了一定的了解,但是还有很多的朋友对mapreduce很模糊,下面新霸哥将带你共同学习mapreduce编程模型. mapred ...
- （转载）OC学习篇之---Foundation框架中的NSArray类和NSMutableArray类
在之前的一篇文章中介绍了Foundation框架中的NSString类和NSMutableString类,今天我们继续来看一下Foundation框架中的NSArray类和NSMutableArray ...
- （转载）OC学习篇之---类目的概念和使用
上一篇文章介绍了OC中的@class关键字的使用,这一篇我们介绍一下,OC中的一个特有的亮点:类目 首先我们来看一下场景,如果我们现在想对一个类进行功能的扩充,我们该怎么做? 对于面向对象编程的话,首 ...
- 60个响应式的Web设计教程–能够手机访问！
想要学习响应式[responsive:屏幕自适应的效果]的网页设计和开发技术?在这个超大的收藏集合中,我想你定会找到想要开始学习的响应式网页设计教程. 面对超过1亿的手机互联网用户,开发专业和用户友好 ...
- 【boost】使用装饰者模式改造boost::thread_group
在项目中使用boost::thread_group的时候遇到几个问题: 1.thread_group不提供删除全部thread列表的方法,一直使用create会是其内部列表不断增加. 2.thread ...
- [转]天龙八部的BillingServer
从字面上看,Billing是计费的,应该处理玩家在线时间或者包月之类.但是天龙八部是免费游戏,不需要算时间来计费.从代码中看,BillingServer也比较简单,它有一个连接到Web服务器,并监听一 ...
- .net调用java webservice基于JBOSS服务器 学习笔记(一)
1.遇到数组类型或List等复杂数据类型是,需要对其进行包装,就是将复杂数据类型放到一个类里面: public class VOCargoJTWS { /** JT列表 */ private List ...