jQuery中的工具
Posted myitnews
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了jQuery中的工具相关的知识,希望对你有一定的参考价值。
1. jQuery.each(object, [callback]), 通用遍历方法,可用于遍历对象和数组
不同于遍历 jQuery 对象的 $().each() 方法,此方法可用于遍历任何对象。回调函数拥有两个参数:第一个为对象的成员或数组的索引,第二个为对应变量或内容。如果需要退出 each 循环可使回调函数返回 false,其它返回值将被忽略。
参数说明:
- object:需要遍历的对象或数组。
- callback:每个成员/元素执行的回调函数。
//遍历数组 $.each( [0,1,2], function(i, n){ alert( "Item #" + i + ": " + n ); }); //遍历对象 $.each( { name: "John", lang: "JS" }, function(i, n){ alert( "Name: " + i + ", Value: " + n ); });
2. jQuery.extend([deep], target, object1, [objectN]), 用一个或多个其他对象来扩展一个对象,返回被扩展的对象
果不指定target,则给jQuery命名空间本身进行扩展。这有助于插件作者为jQuery增加新方法。 如果第一个参数设置为true,则jQuery返回一个深层次的副本,递归地复制找到的任何对象。否则的话,副本会与原对象共享结构。 未定义的属性将不会被复制,然而从对象的原型继承的属性将会被复制。
参数说明:
- target,[object1],[objectN]
-
target:一个对象,如果附加的对象被传递给这个方法将那么它将接收新的属性,如果它是唯一的参数将扩展jQuery的命名空间。
-
object1:待合并到第一个对象的对象。
-
objectN:待合并到第一个对象的对象。
-
- [deep],target,object1,[objectN]
-
deep:如果设为true,则递归合并。
-
target:待修改对象。
-
object1:待合并到第一个对象的对象。
-
-
- objectN:待合并到第一个对象的对象。
//合并 settings 和 options,修改并返回 settings var settings = { validate: false, limit: 5, name: "foo" }; var options = { validate: true, name: "bar" }; jQuery.extend(settings, options); //返回结果 settings == { validate: true, limit: 5, name: "bar" } //合并 defaults 和 options, 不修改 defaults。 var empty = {}; var defaults = { validate: false, limit: 5, name: "foo" }; var options = { validate: true, name: "bar" }; var settings = jQuery.extend(empty, defaults, options); //返回结果 settings == { validate: true, limit: 5, name: "bar" } empty == { validate: true, limit: 5, name: "bar" }
3. jQuery.grep(array, callback, [invert]), 使用过滤函数过滤数组元素
此函数至少传递两个参数:待过滤数组和过滤函数。过滤函数必须返回 true 以保留元素或 false 以删除元素。
参数说明:
- array,callback,[invert] Array,Function,Boolean
-
array:待过滤数组。
-
callback:此函数将处理数组每个元素。第一个参数为当前元素,第二个参数而元素索引值。此函数应返回一个布尔值。另外,此函数可设置为一个字符串,当设置为字符串时,将视为“lambda-form”(缩写形式?),其中 a 代表数组元素,i 代表元素索引值。如“a > 0”代表“function(a){ return a > 0; }”。
-
invert:如果 "invert" 为 false 或为设置,则函数返回数组中由过滤函数返回 true 的元素,当"invert" 为 true,则返回过滤函数中返回 false 的元素集。
-
//过滤数组中小于 0 的元素。 $.grep( [0,1,2], function(n,i){ return n > 0; }); //返回结果:[1, 2] //排除数组中大于 0 的元素,使用第三个参数进行排除。 $.grep( [0,1,2], function(n,i){ return n > 0; }, true); //返回结果:[0]
4. jQuery.when(deferreds), 提供一种方法来执行一个或多个对象的回调函数,延迟对象通常表示异步事件
参数说明:
- deferreds:一个或多个延时对象或JS对象
when()函数常常和done()函数、fail()函数、then()函数联合使用:
- done(Function func) : 当deferreds中的处理都完成的时候执行Function回调函数
-
fail(Function func) :当deferreds中有一个处理失败的时候执行Function回调函数
-
then(Function func1,Function func2)-:结合了done和fail函数,当都成功执行func1,当有一个失败执行func2
$.when( $.ajax("test.aspx") ).then(function(ajaxArgs){ alert(ajaxArgs[1]); /* ajaxArgs is [ "success", statusText, jqXHR ] */ }); $.when( { testing: 123 } ).done( function(x){ alert(x.testing); } /* alerts "123" */ ); $.when($.ajax("/page1.php"), $.ajax("/page2.php")).done(function(a1, a2){ /* a1 and a2 are arguments resolved for the page1 and page2 ajax requests, respectively */ var jqXHR = a1[2]; /* arguments are [ "success", statusText, jqXHR ] */ if ( /Whip It/.test(jqXHR.responseText) ) { alert("First page has ‘Whip It‘ somewhere."); } }); $.when($.ajax("/page1.php"), $.ajax("/page2.php")) .then(myFunc, myFailure);
5. jQuery.makeArray(obj), 将类数组对象转换为数组对象
类数组对象有 length 属性,其成员索引为 0 至 length - 1。实际中此函数在 jQuery 中将自动使用而无需特意转换。
<div>First</div><div>Second</div><div>Third</div><div>Fourth</div> var arr = jQuery.makeArray(document.getElementsByTagName("div")); arr.reverse(); // 使用数组翻转函数 //结果 Fourth Third Second First
6. jQuery.map(arr|obj,callback), 将一个数组中的元素转换到另一个数组中
作为参数的转换函数会为每个数组元素调用,而且会给这个转换函数传递一个表示被转换的元素作为参数。转换函数可以返回转换后的值、null(删除数组中的项目)或一个包含值的数组,并扩展至原始数组中。
参数说明:
- array,callback
-
array:待转换数组。
-
-
- callbackArray:为每个数组元素调用,而且会给这个转换函数传递一个表示被转换的元素作为参数。函数可返回任何值。另外,此函数可设置为一个字符串,当设置为字符串时,将视为“lambda-form”(缩写形式?),其中 a 代表数组元素。如“a * a”代表“function(a){ return a * a; }”。
- arrayOrObject,callback
-
arrayOrObject:数组或者对象。
-
-
- callback:为每个数组元素调用,而且会给这个转换函数传递一个表示被转换的元素作为参数。函数可返回任何值。另外,此函数可设置为一个字符串,当设置为字符串时,将视为“lambda-form”(缩写形式?),其中 a 代表数组元素。如“a * a”代表“function(a){ return a * a; }”。
//将原数组中每个元素加 4 转换为一个新数组。 $.map( [0,1,2], function(n){ return n + 4; }); //结果:[4, 5, 6] //原数组中大于 0 的元素加 1 ,否则删除。 $.map( [0,1,2], function(n){ return n > 0 ? n + 1 : null; }); //结果:[2, 3] //原数组中每个元素扩展为一个包含其本身和其值加 1 的数组,并转换为一个新数组。 $.map( [0,1,2], function(n){ return [ n, n + 1 ]; }); //结果:[0, 1, 1, 2, 2, 3]
7. jQuery.inArray(value,array,[fromIndex]), 确定第一个参数在数组中的位置,从0开始计数(如果没有找到则返回 -1 )
参数说明:
- value,array,[fromIndex]
- value:用于在数组中查找是否存在
- array:待处理数组
- fromIndex:用来搜索数组队列,默认值为0
var arr = [ 4, "Pete", 8, "John" ]; jQuery.inArray("John", arr); //3 jQuery.inArray(4, arr); //0 jQuery.inArray("David", arr); //-1 jQuery.inArray("Pete", arr, 2); //-1
8. jQuery.toArray(), 把jQuery集合中所有DOM元素恢复成一个数组
alert($(‘li‘).toArray());
9. jQuery.merge(first,second), 合并两个数组
返回的结果会修改第一个数组的内容——第一个数组的元素后面跟着第二个数组的元素。要去除重复项,请使用$.unique()
参数说明:
-
first:第一个待处理数组,会改变其中的元素。
-
second:第二个待处理数组,不会改变其中的元素。
$.merge( [0,1,2], [2,3,4] ) //结果:[0,1,2,2,3,4]
10. jQuery.unique(array), 删除数组中重复元素
只处理删除DOM元素数组,而不能处理字符串或者数字数组。在jQuery 3.0以上版本该方法已被弃用,请使用 jQuery.uniqueSort()方法。
//删除重复 div 标签 $.unique(document.getElementsByTagName("div"));
11. jQuery.parseJSON(str), 接受一个JSON字符串,返回解析后的对象
在jQuery 3.0 及以后版本中,该方法已被删除,请使用原生方法 JSON.parse(str)。
传入一个畸形的JSON字符串会抛出一个异常,如:
- {test: 1} ( test 没有包围双引号)
-
{‘test‘: 1} (使用了单引号而不是双引号)
另外,如果你什么都不传入,或者一个空字符串、null或undefined,parseJSON都会返回 null
var obj = jQuery.parseJSON(‘{"name":"John"}‘); alert( obj.name === "John" );
12. jQuery.parseXML(data), 解析一个字符串到一个XML文件
jQuery.parseXML使用原生解析函数浏览器创建一个有效的XML文档。这文档可以被传递给jQuery创建一个典型的jQuery对象,可以查询及操作
//建一个jQuery对象使用一个XML字符串并得到标题节点的值 var xml = ‘<rss version="2.0"><channel><title>RSS Title</title></channel></rss>‘, xmlDoc = $.parseXML( xml ), $xml = $( xmlDoc ), $title = $xml.find( ‘title‘ ); // append "RSS Title" to #someElement $( ‘#someElement‘ ).append( $title.text() ); // change the title to "XML Title" $title.text( ‘XML Title‘ ); // append "XML Title" to #anotherElement $( ‘#anotherElement‘ ).append( $title.text() );
13. jQuery.noop, 一个空函数
当你仅仅想要传递一个空函数的时候,就用他吧。这对一些插件作者很有用,当插件提供了一个可选的回调函数接口,那么如果调用的时候没有传递这个回调函数,就用jQuery.noop来代替执行。
14. jQuery.proxy(function,context), jQuery 1.4 新增。返回一个新函数,并且这个函数始终保持了特定的作用域
当有事件处理函数要附加到元素上,但他们的作用域实际是指向另一个对象时,这个方法最有用了。此外,最妙的是,jQuery能够确保即便你绑定的函数是经过jQuery.proxy()处理过的函数,你依然可以传递原先的函数来准确无误地取消绑定。
这个函数还有另一种用法,jQuery.proxy( scope, name )。第一个参数是要设定的作用域对象。第二个参数是将要设置作用域的函数名(必须是第一个作用域对象的一个属性)。
参数说明:
- function,context Function,Object
-
function:将要被改变作用域的函数
- context:一个object,那个函数的作用域会被设置到这个object上来。
-
- context,name Object,Object
-
- context:一个object,那个函数的作用域会被设置到这个object上来。
- name:改变上下文中的函数名(这个函数必须是前一个参数 ‘context‘ 对象的属性)
//强制设置函数的作用域,让this指向obj而不是#test对象。 <div id="test">Click Here!</div> var obj = { name: "John", test: function() { alert( this.name ); $("#test").unbind("click", obj.test); } }; $("#test").click( jQuery.proxy( obj, "test" ) ); // 以下代码跟上面那句是等价的: // $("#test").click( jQuery.proxy( obj.test, obj ) ); // 可以与单独执行下面这句做个比较。 // $("#test").click( obj.test );
15. jQuery.contains(container,contained), 一个DOM节点是否包含另一个DOM节点
参数说明:
-
container:DOM元素作为容器,可以包含其他元素
- contained:DOM节点,可能被其他元素所包含
jQuery.contains(document.documentElement, document.body); // true jQuery.contains(document.body, document.documentElement); // false
16. jQuery.type(obj), 检测obj的数据类型
jQuery.type(true) === "boolean" jQuery.type(3) === "number" jQuery.type("test") === "string" jQuery.type(function(){}) === "function" jQuery.type([]) === "array" jQuery.type(new Date()) === "date" jQuery.type(/test/) === "regexp"
17. jQuery.isEmptyObject(obj), 测试对象是否是空对象(不包含任何属性)
jQuery 1.4 新增。jQuery 1.4 中,这个方法既检测对象本身的属性,也检测从原型继承的属性(因此没有使用hasOwnProperty)。
jQuery.isEmptyObject({}) // true jQuery.isEmptyObject({ foo: "bar" }) // false
18. jQuery.isPlainObject(obj), 测试对象是否是纯粹的对象(通过 "{}" 或者 "new Object" 创建的)
jQuery.isPlainObject({}) // true jQuery.isPlainObject("test") // false
19. jQuery.isNumeric(value), 确定它的参数是否是一个数字
jQuery V1.7新增。
$.isNumeric() 方法检查它的参数是否代表一个数值。如果是这样,它返回 true。否则,它返回false。该参数可以是任何类型的
$.isNumeric("-10"); // true $.isNumeric(16); // true $.isNumeric(0xFF); // true $.isNumeric("0xFF"); // true $.isNumeric("8e5"); // true (exponential notation string) $.isNumeric(3.1415); // true $.isNumeric(+10); // true $.isNumeric(0144); // true (octal integer literal) $.isNumeric(""); // false $.isNumeric({}); // false (empty object) $.isNumeric(NaN); // false $.isNumeric(null); // false $.isNumeric(true); // false $.isNumeric(Infinity); // false $.isNumeric(undefined); // false
20. jQuery.trim(str), 去掉字符串起始和结尾的空格
$.trim(" hello, how are you? ");
21. jQuery.param(obj,[traditional]), 将表单元素数组或者对象序列化。是.serialize()的核心方法
在jQuery 1.3中,如果传递的参数是一个函数,那么用.param()会得到这个函数的返回值,而不是把这个函数作为一个字符串来返回。
在jQuery 1.4中,.param()会深度递归一个对象来满足现在脚本语言和框架,比如PHP, Ruby on Rails等。你可以通过jQuery.ajaxSettings.traditional = true; 来全局得禁用这个功能。
注意:因为有些框架在解析序列化数字的时候能力有限,所以当传递一些含有嵌套对象、数组的对象作为参数时,请务必小心!
在jQuery 1.4中,html5的input元素也会被序列化。
参数说明:
- obj Array<Elements>/jQuery/Object
- 数组或jQuery对象会按照name/value对进行序列化,普通对象按照key/value对进行序列化
- obj,[traditional] Array<Elements>/jQuery/Object,Boolean
-
obj:数组或jQuery对象会按照name/value对进行序列化,普通对象按照key/value对进行序列化。
-
-
- traditional:是否使用传统的方式浅层序列化。
var params = { width:1680, height:1050 }; var str = jQuery.param(params); $("#results").text(str); //width=1680&height=1050
22. jQuery.error(message), 接受一个字符串,并且直接抛出一个包含这个字符串的异常
这个方法的主要目的是提供给插件开发人员,让他们可以重载这个方法,并以更好的方式显示错误,或者提供更多信息。
23. $.fn.jquery, 代表 jQuery 版本号的字符串
.jquery 属性是通过 jQuery 原型赋值的,通过使用它的别名 $.fn 进行引用。它是一个含有 jQuery 版本号的字符串,例如 "1.5.0" 或 "1.4.4".
//判断一个对象是否是 jQuery 对象。 var a = { what: "A regular JS object" }, b = $(‘body‘); if ( a.jquery ) { // falsy, since it‘s undefined alert(‘ a is a jQuery object! ‘); } if ( b.jquery ) { // truthy, since it‘s a string alert(‘ b is a jQuery object! ‘); } //取得页面上当前使用的 jQuery 的版本号。 alert( ‘You are running jQuery version: ‘ + $.fn.jquery );
以上是关于jQuery中的工具的主要内容,如果未能解决你的问题,请参考以下文章
Visual Studio 2012-2019的130多个jQuery代码片段。
[vscode]--HTML代码片段(基础版,reactvuejquery)
markdown 在WordPress中使用jQuery代码片段