jQuery自帶的一些常用方法教程總結

本身方法($.each,$.map,$.contains,$ajax)

常用工具方法

(1)$.trim

$.trim方法用於移除字符串頭部和尾部多餘的空格。

復制代碼 代碼如下:

$.trim('   Hello   ') // Hello

 

(2)$.contains

$.contains方法返回一個佈爾值,表示某個DOM元素(第二個參數)是否為另一個DOM元素(第一個參數)的下級元素。

復制代碼 代碼如下:

$.contains(document.documentElement, document.body);
// true
$.contains(document.body, document.documentElement);
// false

 

(3)$.each,$.map

$.each方法用於遍歷數組和對象,然後返回原始對象。它接受兩個參數,分別是數據集合和回調函數。

復制代碼 代碼如下:

$.each([ 52, 97 ], function( index, value ) {
  console.log( index + ": " + value );
});
// 0: 52
// 1: 97
var obj = {
  p1: "hello",
  p2: "world"
};
$.each( obj, function( key, value ) {
  console.log( key + ": " + value );
});
// p1: hello
// p2: world

需要註意的,jQuery對象實例也有一個each方法($.fn.each),兩者的作用差不多。

 

$.map方法也是用來遍歷數組和對象,但是會返回一個新對象。

復制代碼 代碼如下:

var a = ["a", "b", "c", "d", "e"];
a = $.map(a, function (n, i){
  return (n.toUpperCase() + i);
});
// ["A0", "B1", "C2", "D3", "E4"]

 

(4)$.inArray

$.inArray方法返回一個值在數組中的位置(從0開始)。如果該值不在數組中,則返回-1。

復制代碼 代碼如下:

var a = [1,2,3,4];
$.inArray(4,a) // 3

 

(5)$.extend

$.extend方法用於將多個對象合並進第一個對象。

復制代碼 代碼如下:

var o1 = {p1:'a',p2:'b'};
var o2 = {p1:'c'};
$.extend(o1,o2);
o1.p1 // "c"

$.extend的另一種用法是生成一個新對象,用來繼承原有對象。這時,它的第一個參數應該是一個空對象。

復制代碼 代碼如下:

var o1 = {p1:'a',p2:'b'};
var o2 = {p1:'c'};
var o = $.extend({},o1,o2);
o
// Object {p1: "c", p2: "b"}

默認情況下,extend方法生成的對象是“淺拷貝”,也就是說,如果某個屬性是對象或數組,那麼隻會生成指向這個對象或數組的指針,而不會復制值。如果想要“深拷貝”,可以在extend方法的第一個參數傳入佈爾值true。

復制代碼 代碼如下:

var o1 = {p1:['a','b']};
var o2 = $.extend({},o1);
var o3 = $.extend(true,{},o1);
o1.p1[0]='c';
o2.p1 // ["c", "b"]
o3.p1 // ["a", "b"]

上面代碼中,o2是淺拷貝,o3是深拷貝。結果,改變原始數組的屬性,o2會跟著一起變,而o3不會。

 

(6)$.proxy

$.proxy方法類似於ECMAScript 5的bind方法,可以綁定函數的上下文(也就是this對象)和參數,返回一個新函數。

jQuery.proxy()的主要用處是為回調函數綁定上下文對象。

復制代碼 代碼如下:

var o = {
    type: "object",
    test: function(event) {
        console.log(this.type);
    }
};
$("#button")
  .on("click", o.test) // 無輸出
  .on("click", $.proxy(o.test, o)) // object

上面的代碼中,第一個回調函數沒有綁定上下文,所以結果為空,沒有任何輸出;第二個回調函數將上下文綁定為對象o,結果就為object。

 

這個例子的另一種等價的寫法是:

復制代碼 代碼如下:

$("#button").on( "click", $.proxy(o, test))

上面代碼的$.proxy(o, test)的意思是,將o的方法test與o綁定。

 

這個例子表明,proxy方法的寫法主要有兩種。

復制代碼 代碼如下:

jQuery.proxy(function, context)
// or
jQuery.proxy(context, name)

第一種寫法是為函數(function)指定上下文對象(context),第二種寫法是指定上下文對象(context)和它的某個方法名(name)。

 

再看一個例子。正常情況下,下面代碼中的this對象指向發生click事件的DOM對象。

復制代碼 代碼如下:

$('#myElement').click(function() {
    $(this).addClass('aNewClass');
});

如果我們想讓回調函數延遲運行,使用setTimeout方法,代碼就會出錯,因為setTimeout使得回調函數在全局環境運行,this將指向全局對象。

復制代碼 代碼如下:

$('#myElement').click(function() {
    setTimeout(function() {
        $(this).addClass('aNewClass');
    }, 1000);
});

上面代碼中的this,將指向全局對象window,導致出錯。

 

這時,就可以用proxy方法,將this對象綁定到myElement對象。

復制代碼 代碼如下:

$('#myElement').click(function() {
    setTimeout($.proxy(function() {
        $(this).addClass('aNewClass');
    }, this), 1000);
});

 

(7)$.data,$.removeData

$.data方法可以用來在DOM節點上儲存數據。

復制代碼 代碼如下:

// 存入數據
$.data(document.body, "foo", 52 );
// 讀取數據
$.data(document.body, "foo");
// 讀取所有數據
$.data(document.body);

 

上面代碼在網頁元素body上儲存瞭一個鍵值對,鍵名為“foo”,鍵值為52。

$.removeData方法用於移除$.data方法所儲存的數據。

復制代碼 代碼如下:

$.data(p, "test1", "VALUE-1");
$.removeData(p, "test1");

 

(8)$.parseHTML,$.parseJSON,$.parseXML

$.parseHTML方法用於將字符串解析為DOM對象。

$.parseJSON方法用於將JSON字符串解析為JavaScript對象,作用與原生的JSON.parse()類似。但是,jQuery沒有提供類似JSON.stringify()的方法,即不提供將JavaScript對象轉為JSON對象的方法。

$.parseXML方法用於將字符串解析為XML對象。

復制代碼 代碼如下:

var html = $.parseHTML("hello, <b>my name is</b> jQuery.");
var obj = $.parseJSON('{"name": "John"}');
var xml = "<rss version='2.0'><channel><title>RSS Title</title></channel></rss>";
var xmlDoc = $.parseXML(xml);

 

(9)$.makeArray

$.makeArray方法將一個類似數組的對象,轉化為真正的數組。

復制代碼 代碼如下:

var a = $.makeArray(document.getElementsByTagName("p"));
(10)$.merge

$.merge方法用於將一個數組(第二個參數)合並到另一個數組(第一個參數)之中。

復制代碼 代碼如下:

var a1 = [0,1,2];
var a2 = [2,3,4];
$.merge(a1, a2);
a1
// [0, 1, 2, 2, 3, 4]
(11)$.now

$.now方法返回當前時間距離1970年1月1日00:00:00 UTC對應的毫秒數,等同於(new Date).getTime()。

復制代碼 代碼如下:

$.now()
// 1388212221489

 

判斷數據類型的方法

jQuery提供一系列工具方法,用來判斷數據類型,以彌補JavaScript原生的typeof運算符的不足。以下方法對參數進行判斷,返回一個佈爾值。

jQuery.isArray():是否為數組。
jQuery.isEmptyObject():是否為空對象(不含可枚舉的屬性)。
jQuery.isFunction():是否為函數。
jQuery.isNumeric():是否為數組。
jQuery.isPlainObject():是否為使用“{}”或“new Object”生成的對象,而不是瀏覽器原生提供的對象。
jQuery.isWindow():是否為window對象。
jQuery.isXMLDoc():判斷一個DOM節點是否處於XML文檔之中。
下面是一些例子。

復制代碼 代碼如下:

$.isEmptyObject({}) // true
$.isPlainObject(document.location) // false
$.isWindow(window) // true
$.isXMLDoc(document.body) // false

除瞭上面這些方法以外,還有一個$.type方法,可以返回一個變量的數據類型。它的實質是用Object.prototype.toString方法讀取對象內部的[[Class]]屬性(參見《標準庫》的Object對象一節)。

復制代碼 代碼如下:

$.type(/test/) // "regexp"

 

Ajax操作

$.ajax

jQuery對象上面還定義瞭Ajax方法($.ajax()),用來處理Ajax操作。調用該方法後,瀏覽器就會向服務器發出一個HTTP請求。

$.ajax()的用法有多種,最常見的是提供一個對象參數。

復制代碼 代碼如下:

$.ajax({
  async: true,
  url: '/url/to/json',
  type: 'GET',
  data : { id : 123 },
  dataType: 'json',
  timeout: 30000,
  success: successCallback,
  error: errorCallback,
  complete: completeCallback
})
function successCallback(json) {
    $('<h1/>').text(json.title).appendTo('body');
}
function errorCallback(xhr, status){
    console.log('出問題瞭!');
}
function completeCallback(xhr, status){
    console.log('Ajax請求已結束。');
}

上面代碼的對象參數有多個屬性,含義如下:

 

async:該項默認為true,如果設為false,則表示發出的是同步請求。
cache: 該項默認為true,如果設為false,則瀏覽器不緩存返回服務器返回的數據。註意,瀏覽器本身就不會緩存POST請求返回的數據,所以即使設為false,也隻對HEAD和GET請求有效。
url:服務器端網址。這是唯一必需的一個屬性,其他屬性都可以省略。
type:向服務器發送信息所使用的HTTP動詞,默認為GET,其他動詞有POST、PUT、DELETE。
dataType:向服務器請求的數據類型,可以設為text、html、script、json、jsonp和xml。
data:向服務器發送的數據,如果使用GET方法,此項將轉為查詢字符串,附在網址的最後。
success:請求成功時的回調函數,函數參數為服務器傳回的數據、狀態信息、發出請求的原始對象。
timeout: 等待的最長毫秒數。如果過瞭這個時間,請求還沒有返回,則自動將請求狀態改為失敗。
error:請求失敗時的回調函數,函數參數為發出請求的原始對象以及返回的狀態信息。
complete:不管請求成功或失敗,都會執行的回調函數,函數參數為發出請求的原始對象以及返回的狀態信息。
這些參數之中,url可以獨立出來,作為ajax方法的第一個參數。也就是說,上面代碼還可以寫成下面這樣。

復制代碼 代碼如下:

$.ajax('/url/to/json',{
  type: 'GET',
  dataType: 'json',
  success: successCallback,
  error: errorCallback
})

 

簡便寫法

ajax方法還有一些簡便寫法。

$.get():發出GET請求。
$.getScript():讀取一個JavaScript腳本文件並執行。
$.getJSON():發出GET請求,讀取一個JSON文件。
$.post():發出POST請求。
$.fn.load():讀取一個html文件,並將其放入當前元素之中。
一般來說,這些簡便方法依次接受三個參數:url、數據、成功時的回調函數。

(1)$.get(),$.post()

這兩個方法分別對應HTTP的GET方法和POST方法。

復制代碼 代碼如下:

$.get('/data/people.html', function(html){
  $('#target').html(html);
});
$.post('/data/save', {name: 'Rebecca'}, function (resp){
  console.log(JSON.parse(resp));
});

get方法接受兩個參數,分別為服務器端網址和請求成功後的回調函數。post方法在這兩個參數中間,還有一個參數,表示發給服務器的數據。

 

上面的post方法對應的ajax寫法如下。

復制代碼 代碼如下:

$.ajax({
    type: 'POST',
    url: '/data/save',
    data: {name: 'Rebecca'},
    dataType: 'json',
    success: function (resp){
      console.log(JSON.parse(resp));
    }
});

 

(2)$.getJSON()

ajax方法的另一個簡便寫法是getJSON方法。當服務器端返回JSON格式的數據,可以用這個方法代替$.ajax方法。

復制代碼 代碼如下:

$.getJSON('url/to/json', {'a': 1}, function(data){
    console.log(data);
});

上面的代碼等同於下面的寫法。

復制代碼 代碼如下:

$.ajax({
  dataType: "json",
  url: '/url/to/data',
  data: {'a': 1},
  success: function(data){
    console.log(data);
  }
});

 

(3)$.getScript()

$.getScript方法用於從服務器端加載一個腳本文件。

復制代碼 代碼如下:

$.getScript('/static/js/myScript.js', function() {
    functionFromMyScript();
});

上面代碼先從服務器加載myScript.js腳本,然後在回調函數中執行該腳本提供的函數。

 

getScript的回調函數接受三個參數,分別是腳本文件的內容,HTTP響應的狀態信息和ajax對象實例。

復制代碼 代碼如下:

$.getScript( "ajax/test.js", function (data, textStatus, jqxhr){
  console.log( data ); // test.js的內容
  console.log( textStatus ); // Success
  console.log( jqxhr.status ); // 200
});

getScript是ajax方法的簡便寫法,因此返回的是一個deferred對象,可以使用deferred接口。

復制代碼 代碼如下:

jQuery.getScript("/path/to/myscript.js")
    .done(function() {
        // …
    })
    .fail(function() {
        // …
});

 

(4)$.fn.load()

$.fn.load不是jQuery的工具方法,而是定義在jQuery對象實例上的方法,用於獲取服務器端的HTML文件,將其放入當前元素。由於該方法也屬於ajax操作,所以放在這裡一起講。

復制代碼 代碼如下:

$('#newContent').load('/foo.html');

$.fn.load方法還可以指定一個選擇器,將遠程文件中匹配選擇器的部分,放入當前元素,並指定操作完成時的回調函數。

復制代碼 代碼如下:

$('#newContent').load('/foo.html #myDiv h1:first',
    function(html) {
        console.log('內容更新!');
});

上面代碼隻加載foo.html中匹配“#myDiv h1:first”的部分,加載完成後會運行指定的回調函數。

 

Ajax事件

jQuery提供以下一些方法,用於指定特定的AJAX事件的回調函數。

.ajaxComplete():ajax請求完成。
.ajaxError():ajax請求出錯。
.ajaxSend():ajax請求發出之前。
.ajaxStart():第一個ajax請求開始發出,即沒有還未完成ajax請求。
.ajaxStop():所有ajax請求完成之後。
.ajaxSuccess():ajax請求成功之後。
下面是示例。

復制代碼 代碼如下:

$('#loading_indicator')
.ajaxStart(function (){$(this).show();})
.ajaxStop(function (){$(this).hide();});

 

返回值

ajax方法返回的是一個deferred對象,可以用then方法為該對象指定回調函數(詳細解釋參見《deferred對象》一節)。

復制代碼 代碼如下:

$.ajax({
  url: '/data/people.json',
  dataType: 'json'
}).then(function (resp){
  console.log(resp.people);
})

 

JSONP

由於瀏覽器存在“同域限制”,ajax方法隻能向當前網頁所在的域名發出HTTP請求。但是,通過在當前網頁中插入script元素(\<script>),可以向不同的域名發出GET請求,這種變通方法叫做JSONP(JSON with Padding)。

ajax方法可以發出JSONP請求,方法是在對象參數中指定dataType為JSONP。

復制代碼 代碼如下:

$.ajax({
  url: '/data/search.jsonp',
  data: {q: 'a'},
  dataType: 'jsonp',
  success: function(resp) {
    $('#target').html('Results: ' + resp.results.length);
  }
});)

JSONP的通常做法是,在所要請求的URL後面加在回調函數的名稱。ajax方法規定,如果所請求的網址以類似“callback=?”的形式結尾,則自動采用JSONP形式。所以,上面的代碼還可以寫成下面這樣。

復制代碼 代碼如下:

$.getJSON('/data/search.jsonp?q=a&callback=?',
  function(resp) {
    $('#target').html('Results: ' + resp.results.length);
  }
);

 

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *