JavaScript常用函数库详解

在WEB开发中，javascript提供了许多函数供开发人员使用，这些函数在Ajax流行前足够了，但要构建一个交互性强些的应用恐怕就麻烦 了，为此，收集了自己平时常用到一些JavaScript函数，它们在其它的JS库也常见，现在整理并附上注释，方便查阅，希望对大家有所帮助。

注:假设以下所有函数都放在一个CC对象中，方便引用。

//这个方法相信是最常用的了， //它虽然没有选择器那么强大，但也有个小增强版，可查指定结点下ID所在的子元素 function $(id, p) { //id是否是字符串,还是一个HTML结点 var iss = id instanceof String || typeof id == "string"; if (iss && !p) return document.getElementById(id); //如果是结点的话就直接返回该结点 if(!iss) return id; //如果id与p是同一个元素,直接返回 if(p.id == id) return p; //往父结点搜索 var child = p.firstChild; while (child) { if (child.id == id) return child; //递归搜索 var v = this.$(id, child); if (v) return v; child = child.nextSibling; } //的确找不到就返回null return null; }

each: function(object, callback, args) { if (!object) { return object; } if (args) { if (object.length === undefined) { for (var name in object) if (callback.apply(object[name], args) === false) break; } else for (var i = 0, length = object.length; i < length; i++) if (callback.apply(object[i], args) === false) break; } else { if (object.length == undefined) { for (var name in object) if (callback.call(object[name], name, object[name]) === false) break; } else for (var i = 0, length = object.length, value = object[0]; i < length && callback.call(value, i, value) !== false; value = object[++i]) {} } return object; }

//数组 function isArray(obj) { return (typeof obj === "array" || obj instanceof Array); }, //字符串 function isString(obj) { return (typeof obj === "string" || obj instanceof String); }, //函数 function isFunction(obj) { return (typeof obj === "function" || obj instanceof Function); }, //数字类型 function isNumber(ob) { return (typeof ob === "number" || ob instanceof Number ); }

// 返回表单可提交元素的提交字符串. // 例如 // <form> // <input type="text" name="user" value="rock" /> // <input type="text" name="password" value="123" /> // </form> // 调用后就返回 user=rock&password=123 // 这些数据已经过encodeURIComponent处理,对非英文字符友好. // form元素中如果没有name,则以id作为提供字符名. function formQuery(f){ // f,一个Form表单. var formData = "", elem = "", f = CC.$(f); var elements = f.elements; var length = elements.length; for (var s = 0; s < length; ++s) { elem = elements[s]; if (elem.tagName == 'INPUT') { if ( (elem.type == 'radio' || elem.type == 'checkbox') && !elem.checked) { continue; } } if (formData != "") { formData += "&"; } formData += encodeURIComponent(elem.name||elem.id) + "=" + encodeURIComponent(elem.value); } return formData; }

/** * 移除数组指定元素. * 参数既可传递一个整形下标,也可传递一个数组数据. */ Array.prototype.remove = (function(p) { //参数为下标 if (CC.isNumber(p)) { if (p < 0 || p >= this.length) { throw "Index Of Bounds:" + this.length + "," + p; } this.splice(p, 1)[0]; return this.length; } //参数为数组数据,最终要找到下标来操作 if (this.length > 0 && this[this.length - 1] == p) { this.pop(); } else { var pos = this.indexOf(p); if (pos != -1) { this.splice(pos, 1)[0]; } } return this.length; });

Array.prototype.indexOf = (function(obj) { for (var i = 0, length = this.length; i < length; i++) { if (this[i] == obj) return i; } return - 1; });

/** * 万能而简单的表单验证函数,这个函数利用了JS动态语言特性,看上去很神秘, * 实际是很形象的,查看个例子就清楚了. */ validate: function() { var args = CC.$A(arguments), form = null; //form如果不为空元素,应置于第一个参数中. if (!CC.isArray(args[0])) { form = CC.$(args[0]); args.remove(0); } //如果存在设置项,应置于最后一个参数中. //cfg.queryString = true|false; //cfg.callback = function //cfg.ignoreNull //nofocus:true|false var b = CC.isArray(b) ? {}: args.pop(), d; var queryStr = b.queryString, ignoreNull = b.ignoreNull, cb = b.callback; var result = queryStr ? '': {}; CC.each(args, function(i, v) { //如果在fomr中不存在该name元素,就当id来获得 var obj = v[0].tagName ? v[0] : form ? form[v[0]] : CC.$(v[0]); //console.debug('checking field:',v, 'current value:'+obj.value); var value = obj.value, msg = v[1], d = CC.isFunction(v[2]) ? v[3] : v[2]; //选项 if (!d || typeof d != 'object') d = b; //是否忽略空 if (!d.ignoreNull && (value == '' || value == null)) { //如果不存在回调函数,就调用alert来显示错误信息 if (!d.callback) CC.alert(msg, obj, form); //如果存在回调,注意传递的三个参数 //msg:消息,obj:该结点,form:对应的表单,如果存在的话 else d.callback(msg, obj, form); //出错后是否聚集 if (!d.nofocus) obj.focus(); result = false; return false; } //自定义验证方法 if (CC.isFunction(v[2])) { var ret = v[2](value, obj, form); var pass = (ret !== false); if (CC.isString(ret)) { msg = ret; pass = false; } if (!pass) { if (!d.callback) CC.alert(msg, obj, form); //同上 else d.callback(msg, obj, form); if (!d.nofocus) obj.focus(); result = false; return false; } } //如果不设置queryString并通过验证,不存在form,就返回一个对象, //该对象包含形如{elementName|elementId:value}的数据. if (queryStr && !form) { result += (result == '') ? ((typeof obj.name == 'undefined' || obj.name == '') ? obj.id: obj.name) + '=' + value: '&' + v[0] + '=' + value; } else if (!form) { result[v[0]] = value; } }); //如果设置的queryString:true并通过验证,就返回form的提交字符串. if (result !== false && form && queryStr) result = CC.formQuery(form); return result; }

/** * 应用对象替换模板内容 * templ({name:'Rock'},'<html><title>{name}</title></html>'); * st:0,1:未找到属性是是否保留 */ templ: function(obj, str, st) { return str.replace(/\{([\w_$]+)\}/g, function(c, $1) { var a = obj[$1]; if (a === undefined || a === null) { if (st === undefined) return ''; switch (st) { case 0: return ''; case 1: return $1; default: return c; } } return a; }); }