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)

Chrome-Devtools代码片段中的多个JS库

markdown 在WordPress中使用jQuery代码片段

使用 NodeJS 和 JSDOM/jQuery 从代码片段构建 PHP 页面

很实用的JQuery代码片段(转)