第一章 入門
基本功能:訪問和操作 dom 元素,控制頁面樣式,對頁面的事件處理,與ajax完美結合,有豐富的插件。
在jQuery庫中,通過本身自帶的方法獲取頁面元素的對象,稱為jQuery對象
第二章 選擇器
基本選擇器是最簡單的選擇器也是最常用的選擇器,它通過元素的id,class和標簽來查找dom元素。
1. 基礎選擇器Basics
名稱說明舉例
#id根據元素Id選擇(返回的是單個元素)$("divId") 選擇ID為divId的元素
element根據元素的名稱選擇,(返回的是集合元素)$("a") 選擇所有元素
.class根據元素的css類選擇(返回的是集合元素)$(".bgRed") 選擇所用CSS類為bgRed的元素
*選擇所有元素(返回的是集合元素)$("*")選擇頁面所有元素
selector2,
selectorN可以將幾個選擇器用","分隔開然后再拼成一個選擇器字符串.會同時選中這幾個選擇器匹配的內容.
(返回的是集合元素)$("#divId, a, .bgRed")
2.層次選擇器Hierarchy
名稱說明舉例
ancestor descendant使用"form input"的形式選中form中的所有input元素.即ancestor(祖先)為from, descendant(子孫)為input.$(".bgRed div") 選擇CSS類為bgRed的元素中的所有
元素.
parent > child選擇parent的直接子節點child.? child必須包含在parent中并且父類是parent元素.$(".myList>li") 選擇CSS類為myList元素中的直接子節點
對象.
prev + nextprev和next是兩個同級別的元素. 選中在prev元素后面的next元素.$("#hibiscus+img")選在id為hibiscus元素后面的img對象.
prev ~ siblings選擇prev后面的根據siblings過濾的元素
注:siblings是過濾器$("#someDiv~[title]")選擇id為someDiv的對象后面所有帶有title屬性的元素
2.層次選擇器Hierarchy
名稱說明舉例
ancestor descendant使用"form input"的形式選中form中的所有input元素.即ancestor(祖先)為from, descendant(子孫)為input.$(".bgRed div") 選擇CSS類為bgRed的元素中的所有
元素.
parent > child選擇parent的直接子節點child.? child必須包含在parent中并且父類是parent元素.$(".myList>li") 選擇CSS類為myList元素中的直接子節點
對象.
prev + nextprev和next是兩個同級別的元素. 選中在prev元素后面的next元素.$("#hibiscus+img")選在id為hibiscus元素后面的img對象.
prev ~ siblings選擇prev后面的根據siblings過濾的元素
注:siblings是過濾器$("#someDiv~[title]")選擇id為someDiv的對象后面所有帶有title屬性的元素
過濾選擇器:主要是通過特定的過濾規則來篩選出所需的dom 元素,過濾規則則與 css 中的為類選擇器語法相同。
3.基本過濾器Basic Filters
名稱
說明舉例
:first匹配找到的第一個元素查找表格的第一行:$("tr:first")
:last匹配找到的最后一個元素查找表格的最后一行:$("tr:last")
:not(selector)去除所有與給定選擇器匹配的元素查找所有未選中的 input 元素: $("input:not(:checked)")
:even匹配所有索引值為偶數的元素,從 0 開始計數查找表格的1、3、5...行:$("tr:even")
:odd匹配所有索引值為奇數的元素,從 0 開始計數查找表格的2、4、6行:$("tr:odd")
:eq(index)匹配一個給定索引值的元素
注:index從 0 開始計數查找第二行:$("tr:eq(1)")
:gt(index)匹配所有大于給定索引值的元素
注:index從 0 開始計數查找第二第三行,即索引值是1和2,也就是比0大:$("tr:gt(0)")
:lt(index)選擇結果集中索引小于 N 的 elements
注:index從 0 開始計數查找第一第二行,即索引值是0和1,也就是比2小:$("tr:lt(2)")
:header選擇所有h1,h2,h3一類的header標簽.給頁面內所有標題加上背景色: $(":header").css("background", "#EEE");
:animated匹配所有正在執行動畫效果的元素只有對不在執行動畫效果的元素執行一個動畫特效:
$("#run").click(function(){
$("div:not(:animated)").animate({ left: "+=20" }, 1000);
});
內容過濾器 Content Filters
名稱說明舉例
:contains(text)匹配包含給定文本的元素查找所有包含 "John" 的 div 元素:$("div:contains('John')")
:empty匹配所有不包含子元素或者文本的空元素查找所有不包含子元素或者文本的空元素:$("td:empty")
:has(selector)匹配含有選擇器所匹配的元素的元素給所有包含 p 元素的 div 元素添加一個 text 類: $("div:has(p)").addClass("test");
:parent匹配含有子元素或者文本的元素查找所有含有子元素或者文本的 td 元素:$("td:parent")
可見性過濾器Visibility Filters
名稱說明舉例
匹配所有的不可見元素
注:在1.3.2版本中, hidden匹配自身或者父類在文檔中不占用空間的元素.如果使用CSS visibility屬性讓其不顯示但是占位,則不輸入hidden.查找所有不可見的 tr 元素:$("tr:hidden")
:visible匹配所有的可見元素查找所有可見的 tr 元素:$("tr:visible")
屬性過濾器Attribute Filters
名稱說明舉例
[attribute]匹配包含給定屬性的元素查找所有含有 id 屬性的 div 元素:
$("div[id]")
[attribute=value]匹配給定的屬性是某個特定值的元素查找所有 name 屬性是 newsletter 的 input 元素:
$("input[name='newsletter']").attr("checked", true);
[attribute!=value]匹配給定的屬性是不包含某個特定值的元素查找所有 name 屬性不是 newsletter 的 input 元素:
$("input[name!='newsletter']").attr("checked", true);
[attribute^=value]匹配給定的屬性是以某些值開始的元素$("input[name^='news']")
[attribute$=value]匹配給定的屬性是以某些值結尾的元素查找所有 name 以 'letter' 結尾的 input 元素:
$("input[name$='letter']")
[attribute*=value]匹配給定的屬性是以包含某些值的元素
查找所有 name 包含 'man' 的 input 元素:
$("input[name*='man']")
[attributeFilter1][attributeFilter2][attributeFilterN]復合屬性選擇器,需要同時滿足多個條件時使用。找到所有含有 id 屬性,并且它的 name 屬性是以 man 結尾的:
$("input[id][name$='man']")
7.子元素過濾器Child Filters
名稱說明舉例
:nth-child(index/even/odd/equation)匹配其父元素下的第N個子或奇偶元素
':eq(index)' 只匹配一個元素,而這個將為每一個父元素匹配子元素。:nth-child從1開始的,而:eq()是從0算起的!
可以使用:
nth-child(even)
:nth-child(odd)
:nth-child(3n)
:nth-child(2)
:nth-child(3n+1)
:nth-child(3n+2)在每個 ul 查找第 2 個li:
$("ul li:nth-child(2)")
:first-child匹配第一個子元素
':first' 只匹配一個元素,而此選擇符將為每個父元素匹配一個子元素在每個 ul 中查找第一個 li:
$("ul li:first-child")
:last-child匹配最后一個子元素
':last'只匹配一個元素,而此選擇符將為每個父元素匹配一個子元素在每個 ul 中查找最后一個 li:
$("ul li:last-child")
:only-child如果某個元素是父元素中唯一的子元素,那將會被匹配
如果父元素中含有其他元素,那將不會被匹配。在 ul 中查找是唯一子元素的 li:
$("ul li:only-child")
表單過濾器Form Filters
名稱說明解釋
:enabled匹配所有可用元素
查找所有可用的input元素:
$("input:enabled")
:disabled匹配所有不可用元素查找所有不可用的input元素:
$("input:disabled")
:checked匹配所有選中的被選中元素(復選框、單選框等,不包括select中的option)查找所有選中的復選框元素:
$("input:checked")
:selected匹配所有選中的option元素查找所有選中的選項元素:
$("select option:selected")
表單選擇器:
表單選擇器 Forms
名稱說明解釋
:input匹配所有 input, textarea, select 和 button 元素查找所有的input元素:
$(":input")
:text匹配所有的文本框查找所有文本框:
$(":text")
:password匹配所有密碼框查找所有密碼框:
$(":password")
:radio匹配所有單選按鈕查找所有單選按鈕
:checkbox匹配所有復選框查找所有復選框:
$(":checkbox")
:submit匹配所有提交按鈕查找所有提交按鈕:
$(":submit")
:image匹配所有圖像域
匹配所有圖像域:
$(":image")
:reset匹配所有重置按鈕查找所有重置按鈕:
$(":reset")
:button匹配所有按鈕查找所有按鈕:
$(":button")
:file匹配所有文件域查找所有文件域:
$(":file")
第三章 DOM操作
1.獲取元素的屬性。 attr(); ?也可以用這個方法來設置元素屬性。
attr(key,value)方法設置元素的屬性 ? ?key 表示屬性,value 表示屬性值
attr()方法還可以綁定一個function()函數,通過該函數返回的值作為元素的屬性值,其語法格式如下所示:
2.刪除元素的屬性使用removeAttr() ?格式。
3.獲取和設置元素內容
操作元素內容的方法包括html()和text() 。
html()方法僅支持XHTML的文檔,不能用于XML文檔,而text()既支持HTML文檔,也支持XML文檔。
在頁面中,用html()和text()方法獲取div標記中的內容,將內容分別作為html(val)和text(val)的參數,分別設置元素的內容,并將結果顯示在頁面中。
4.獲取和設置元素值 ? val()
其中,如果不帶參數val,是獲取某元素的值;反之,則是將參數val的值賦給某元素,即設置元素的值。該方法常用于表單中獲取或設置對象的值。
5.?直接設置元素樣式值css(name,value) ? 格式:
6 增加元素CSS類別通過addClass()方法增加元素類別的名稱,其語法格式如下
切換元素CSS類別通過toggleClass()方法切換不同的元素類別,其語法格式如下:
刪除元素CSS類別與增加類別的addClass()方法相對應,removeClass()方法則用于刪除類別,其語法格式如下
頁面元素操作:
創建節點元素函數$()用于動態創建頁面元素,其語法格式如下:
內部插入節點append() ?方法: ?在元素的內如插入元素
append(function(index,html))
該方法是jQuery 1.4中新增的,其功能是將一個function函數作為append方法的參數,該函數的功能必須返回一個字符串,作為append方法插入的內容,其中index參數為對象在這個集合中的索引值,html參數為該對象原有的html值。
appendTo(content)
該方法用于將一個元素插入另一個指定的元素內容中
外部插入節點
after(function)方法也是jQuery 1.4中新增的方法,其function()參數將返回插入元素外部后面部分的內容。示例3-13演示了調用after()方法,以function的返回值為參數,在指定元素的外部插入一個節點的過程。
復制元素節點
cklone ()其功能為復制匹配的DOM元素并且選中復制成功的元素。該方法僅是復制元素本身,被復制后的新元素不具有任何元素行為。如果需要在復制時將該元素的全部行為也進行復制,可以通過方法clone(true)實現,其格式為: clone(true)
替換元素節點replaceWith()和replaceAll()這兩種方法
replaceWith()該方法的功能是將所有選擇的元素替換成指定的HTML或DOM元素,其中參數content為被所選擇元素替換的內容。
replaceAll()該方法的功能是將所有選擇的元素替換成指定selector的元素,其中參數selector為需要被替換的元素。
包裹元素節點
不僅可以通過方法替換元素節點,還可以根據需求包裹某個指定的節點,對節點的包裹也是DOM對象操作中很重要的一項wrap(html)與wrapInner(html)方法比較常用
遍歷元素
在傳統的JavaScript中,先獲取元素的總長度,然后以for循環語句遞減總長度,訪問其中的某個元素,代碼相對復雜;而在jQuery中,可以直接使用each()方法實現元素的遍歷。其語法格式如下:
$("button").click(function(){
$("li").each(function(){
alert($(this).text())
});
});
刪除頁面元素remove() ?刪除節點元素empty() ?清空所選的元素或是后代元素。
查找頁面元素 ?find() 方法find() 方法獲得當前元素集合中每個元素的后代,通過選擇器、jQuery 對象或元素來篩選。
.find(selector) ?選擇器
var?item1?=?$('li.item-1')[0];
$('li.item-ii').find(?item1?).css('background-color',?'red'); ? 還可以通過傳遞一個元素進行查找
第4章 jQuery中的事件與應用
在瀏覽器里,事件的觸發有個冒泡現象,body下有個div ,div下有個按鈕, 同時監聽三個元素的點擊事件,然后只是去點擊那個按鈕,div 和body的點擊事件也會被觸發,這就是事件冒泡。可以通過stopPropagation()方法可以阻止冒泡過程的發生 event.stopPropagation()
使用bind()方法綁定事件bind()功能是為每個選擇元素的事件綁定處理函數,其語法格式如下:
其中參數type為一個或多個類型的字符串,如"click"或"change",也可以自定義類型;可以被參數type調用的類型包括blur、focus、load、resize、scroll、unload、click、dblclick、mousedown、mouseup、mousemove、mouseover、mouseout、mouseenter、mouseleave、change、select、submit、keydown、keypress、keyup、error。
參數data是作為event.data屬性值傳遞給事件對象的額外數據對象。
參數fn是綁定到每個選擇元素的事件中的處理函數。
切換事件
在jQuery中,有兩個方法用于事件的切換,一個是方法hover(),另一個是方法toggle()。所謂切換事件,即有兩個以上的事件綁定于一個元素,在元素的行為動作間進行切換。如一個超級鏈接標記<a>,若想實現當鼠標懸停時觸發一個事件,鼠標移出時又觸發另一個事件,就可以調用jQuery中的hover()方法輕松實現。
toggle()方法
在toggle()方法中,可以依次調用N個指定的函數,直到最后一個函數,然后重復對這些函數輪番調用。
依次調用的意思是:每次觸發的時候,調用函數調用一次,順序是根據一開始排好的順序
移除事件unbind()的功能是移除元素綁定的事件,其調用的語法格式如下:
one()方法one()方法功能是為所選的元素綁定一個僅觸發一次的處理函數,其調用的語法格式為:
trigger()方法在前端頁面開發中,有時希望頁面在DOM加載完畢后,自動執行一些人性化的操作,如:文本框中的內容處于全部被選中狀態,某個按鈕處于焦點中。利用傳統的JavaScript語言需要編寫復雜的代碼才可實現上述功能;而在jQuery中,僅需要調用一個trigger()方法就可以輕松實現。
trigger()方法的功能是在所選擇的元素上觸發指定類型的事件。其調用的語法格式為:
$.ajax()方法
通過 HTTP 請求加載遠程數據。
jQuery 底層 AJAX 實現。簡單易用的高層實現見 $.get, $.post 等。$.ajax() 返回其創建的 XMLHttpRequest 對象。大多數情況下你無需直接操作該函數,除非你需要操作不常用的選項,以獲得更多的靈活性。
最簡單的情況下,$.ajax()可以不帶任何參數直接使用。
注意,所有的選項都可以通過$.ajaxSetup()函數來全局設置。
回調函數
如果要處理$.ajax()得到的數據,則需要使用回調函數。beforeSend、error、dataFilter、success、complete。
beforeSend 在發送請求之前調用,并且傳入一個XMLHttpRequest作為參數。
error 在請求出錯時調用。傳入XMLHttpRequest對象,描述錯誤類型的字符串以及一個異常對象(如果有的話)
dataFilter 在請求成功之后調用。傳入返回的數據以及"dataType"參數的值。并且必須返回新的數據(可能是處理過的)傳遞給success回調函數。
success 當請求之后調用。傳入返回后的數據,以及包含成功代碼的字符串。
complete 當請求完成之后調用這個函數,無論成功或失敗。傳入XMLHttpRequest對象,以及一個包含成功或錯誤代碼的字符串。
數據類型
$.ajax()函數依賴服務器提供的信息來處理返回的數據。如果服務器報告說返回的數據是XML,那么返回的結果就可以用普通的XML方法或者jQuery的選擇器來遍歷。如果見得到其他類型,比如HTML,則數據就以文本形式來對待。
通過dataType選項還可以指定其他不同數據處理方式。除了單純的XML,還可以指定 html、json、jsonp、script或者text。
其中,text和xml類型返回的數據不會經過處理。數據僅僅簡單的將XMLHttpRequest的responseText或responseHTML屬性傳遞給success回調函數,
'''注意''',我們必須確保網頁服務器報告的MIME類型與我們選擇的dataType所匹配。比如說,XML的話,服務器端就必須聲明 text/xml 或者 application/xml 來獲得一致的結果。
如果指定為html類型,任何內嵌的JavaScript都會在HTML作為一個字符串返回之前執行。類似的,指定script類型的話,也會先執行服務器端生成JavaScript,然后再把腳本作為一個文本數據返回。
如果指定為json類型,則會把獲取到的數據作為一個JavaScript對象來解析,并且把構建好的對象作為結果返回。為了實現這個目的,他首先嘗試使用JSON.parse()。如果瀏覽器不支持,則使用一個函數來構建。JSON數據是一種能很方便通過JavaScript解析的結構化數據。如果獲取的數據文件存放在遠程服務器上(域名不同,也就是跨域獲取數據),則需要使用jsonp類型。使用這種類型的話,會創建一個查詢字符串參數 callback=? ,這個參數會加在請求的URL后面。服務器端應當在JSON數據前加上回調函數名,以便完成一個有效的JSONP請求。如果要指定回調函數的參數名來取代默認的callback,可以通過設置$.ajax()的jsonp參數。
注意,JSONP是JSON格式的擴展。他要求一些服務器端的代碼來檢測并處理查詢字符串參數。更多信息可以參閱最初的文章。
如果指定了script或者jsonp類型,那么當從服務器接收到數據時,實際上是用了<script>標簽而不是XMLHttpRequest對象。這種情況下,$.ajax()不再返回一個XMLHttpRequest對象,并且也不會傳遞事件處理函數,比如beforeSend。
發送數據到服務器
默認情況下,Ajax請求使用GET方法。如果要使用POST方法,可以設定type參數值。這個選項也會影響data選項中的內容如何發送到服務器。
data選項既可以包含一個查詢字符串,比如 key1=value1&key2=value2 ,也可以是一個映射,比如 {key1: 'value1', key2: 'value2'} 。如果使用了后者的形式,則數據再發送器會被轉換成查詢字符串。這個處理過程也可以通過設置processData選項為false來回避。如果我們希望發送一個XML對象給服務器時,這種處理可能并不合適。并且在這種情況下,我們也應當改變contentType選項的值,用其他合適的MIME類型來取代默認的 application/x-www-form-urlencoded 。
高級選項
global選項用于阻止響應注冊的回調函數,比如.ajaxSend,或者ajaxError,以及類似的方法。這在有些時候很有用,比如發送的請求非常頻繁且簡短的時候,就可以在ajaxSend里禁用這個。更多關于這些方法的詳細信息,請參閱下面的內容。
如果服務器需要HTTP認證,可以使用用戶名和密碼可以通過username和password選項來設置。
Ajax請求是限時的,所以錯誤警告被捕獲并處理后,可以用來提升用戶體驗。請求超時這個參數通常就保留其默認值,要不就通過jQuery.ajaxSetup來全局設定,很少為特定的請求重新設置timeout選項。
默認情況下,請求總會被發出去,但瀏覽器有可能從他的緩存中調取數據。要禁止使用緩存的結果,可以設置cache參數為false。如果希望判斷數據自從上次請求后沒有更改過就報告出錯的話,可以設置ifModified為true。
scriptCharset允許給<script>標簽的請求設定一個特定的字符集,用于script或者jsonp類似的數據。當腳本和頁面字符集不同時,這特別好用。
Ajax的第一個字母是asynchronous的開頭字母,這意味著所有的操作都是并行的,完成的順序沒有前后關系。$.ajax()的async參數總是設置成true,這標志著在請求開始后,其他代碼依然能夠執行。強烈不建議把這個選項設置成false,這意味著所有的請求都不再是異步的了,這也會導致瀏覽器被鎖死。
$.ajax函數返回他創建的XMLHttpRequest對象。通常jQuery只在內部處理并創建這個對象,但用戶也可以通過xhr選項來傳遞一個自己創建的xhr對象。返回的對象通常已經被丟棄了,但依然提供一個底層接口來觀察和操控請求。比如說,調用對象上的.abort()可以在請求完成前掛起請求。
參數
url,[settings]ObjectV1.5
url:一個用來包含發送請求的URL字符串。
settings:AJAX 請求設置。所有選項都是可選的。
V1.0settings:選項
acceptsMap
默認: 取決于數據類型。
內容類型發送請求頭,告訴服務器什么樣的響應會接受返回。如果accepts設置需要修改,推薦在$.ajaxSetup()方法中做一次。
asyncBoolean
(默認: true) 默認設置下,所有請求均為異步請求。如果需要發送同步請求,請將此選項設置為 false。注意,同步請求將鎖住瀏覽器,用戶其它操作必須等待請求完成才可以執行。
beforeSend(XHR)Function
發送請求前可修改 XMLHttpRequest 對象的函數,如添加自定義 HTTP 頭。XMLHttpRequest 對象是唯一的參數。這是一個Ajax 事件。如果返回false可以取消本次ajax請求。
function (XMLHttpRequest) {
this; // 調用本次AJAX請求時傳遞的options參數
}
cacheBoolean
(默認: true,dataType為script和jsonp時默認為false) jQuery 1.2 新功能,設置為 false 將不緩存此頁面。
complete(XHR, TS)Function
請求完成后回調函數 (請求成功或失敗之后均調用)。參數: XMLHttpRequest 對象和一個描述成功請求類型的字符串。Ajax 事件。
function (XMLHttpRequest, textStatus) {
this; // 調用本次AJAX請求時傳遞的options參數
}
contentsMapV1.5
一個以"{字符串:正則表達式}"配對的對象,用來確定jQuery將如何解析響應,給定其內容類型。
contentTypeString
(默認: "application/x-www-form-urlencoded") 發送信息至服務器時內容編碼類型。默認值適合大多數情況。如果你明確地傳遞了一個content-type給 $.ajax() 那么他必定會發送給服務器(即使沒有數據要發送)
contextObject
這個對象用于設置Ajax相關回調函數的上下文。也就是說,讓回調函數內this指向這個對象(如果不設定這個參數,那么this就指向調用本次AJAX請求時傳遞的options參數)。比如指定一個DOM元素作為context參數,這樣就設置了success回調函數的上下文為這個DOM元素。就像這樣:
$.ajax({ url: "test.html", context: document.body, success: function(){
$(this).addClass("done");
}});
convertersmapV1.5
默認: {"* text": window.String, "text html": true, "text json": jQuery.parseJSON, "text xml": jQuery.parseXML}
一個數據類型對數據類型轉換器的對象。每個轉換器的值是一個函數,返回響應的轉化值
crossDomainmapV1.5
默認: 同域請求為false
跨域請求為true如果你想強制跨域請求(如JSONP形式)同一域,設置crossDomain為true。這使得例如,服務器端重定向到另一個域
dataObject,String
發送到服務器的數據。將自動轉換為請求字符串格式。GET 請求中將附加在 URL 后。查看 processData 選項說明以禁止此自動轉換。必須為 Key/Value 格式。如果為數組,jQuery 將自動為不同值對應同一個名稱。如 {foo:["bar1", "bar2"]} 轉換為 "&foo=bar1&foo=bar2"。
dataFilterFunction
給Ajax返回的原始數據的進行預處理的函數。提供data和type兩個參數:data是Ajax返回的原始數據,type是調用jQuery.ajax時提供的dataType參數。函數返回的值將由jQuery進一步處理。
function (data, type) {
// 對Ajax返回的原始數據進行預處理
return data? // 返回處理后的數據
}
dataTypeString
預期服務器返回的數據類型。如果不指定,jQuery 將自動根據 HTTP 包 MIME 信息來智能判斷,比如XML MIME類型就被識別為XML。在1.4中,JSON就會生成一個JavaScript對象,而script則會執行這個腳本。隨后服務器端返回的數據會根據這個值解析后,傳遞給回調函數。可用值:
"xml": 返回 XML 文檔,可用 jQuery 處理。
"html": 返回純文本 HTML 信息;包含的script標簽會在插入dom時執行。
"script": 返回純文本 JavaScript 代碼。不會自動緩存結果。除非設置了"cache"參數。'''注意:'''在遠程請求時(不在同一個域下),所有POST請求都將轉為GET請求。(因為將使用DOM的script標簽來加載)
"json": 返回 JSON 數據 。
"jsonp":JSONP格式。使用JSONP形式調用函數時,如 "myurl?callback=?" jQuery 將自動替換 ? 為正確的函數名,以執行回調函數。
"text": 返回純文本字符串
errorFunction
(默認: 自動判斷 (xml 或 html)) 請求失敗時調用此函數。有以下三個參數:XMLHttpRequest 對象、錯誤信息、(可選)捕獲的異常對象。如果發生了錯誤,錯誤信息(第二個參數)除了得到null之外,還可能是"timeout", "error", "notmodified" 和 "parsererror"。Ajax 事件。
function (XMLHttpRequest, textStatus, errorThrown) {
// 通常 textStatus 和 errorThrown 之中
// 只有一個會包含信息
this; // 調用本次AJAX請求時傳遞的options參數
}
globalBoolean
(默認: true) 是否觸發全局 AJAX 事件。設置為 false 將不會觸發全局 AJAX 事件,如 ajaxStart 或 ajaxStop 可用于控制不同的Ajax 事件。
headersmapV1.5
Default: {}
一個額外的"{鍵:值}"對映射到請求一起發送。此設置被設置之前beforeSend函數被調用;因此,消息頭中的值設置可以在覆蓋beforeSend函數范圍內的任何設置。
ifModifiedBoolean
(默認: false) 僅在服務器數據改變時獲取新數據。使用 HTTP 包 Last-Modified 頭信息判斷。在jQuery 1.4中,他也會檢查服務器指定的'etag'來確定數據沒有被修改過。
isLocalmapV1.5.1
默認: 取決于當前的位置協議
允許當前環境被認定為“本地”,(如文件系統),即使jQuery默認情況下不會承認它。以下協議目前公認為本地:file, *-extension, and widget。如果isLocal設置需要修改,建議在$.ajaxSetup()方法中這樣做一次。
jsonpString
在一個jsonp請求中重寫回調函數的名字。這個值用來替代在"callback=?"這種GET或POST請求中URL參數里的"callback"部分,比如{jsonp:'onJsonPLoad'}會導致將"onJsonPLoad=?"傳給服務器。
jsonpCallbackString
為jsonp請求指定一個回調函數名。這個值將用來取代jQuery自動生成的隨機函數名。這主要用來讓jQuery生成度獨特的函數名,這樣管理請求更容易,也能方便地提供回調函數和錯誤處理。你也可以在想讓瀏覽器緩存GET請求的時候,指定這個回調函數名。
mimeTypeStringV1.5.1
一個mime類型用來覆蓋XHR的 MIME類型。
passwordString
用于響應HTTP訪問認證請求的密碼
processDataBoolean
(默認: true) 默認情況下,通過data選項傳遞進來的數據,如果是一個對象(技術上講只要不是字符串),都會處理轉化成一個查詢字符串,以配合默認內容類型 "application/x-www-form-urlencoded"。如果要發送 DOM 樹信息或其它不希望轉換的信息,請設置為 false。
scriptCharsetString
只有當請求時dataType為"jsonp"或"script",并且type是"GET"才會用于強制修改charset。通常只在本地和遠程的內容編碼不同時使用。
statusCodemapV1.5
默認: {}
一組數值的HTTP代碼和函數對象,當響應時調用了相應的代碼。例如,如果響應狀態是404,將觸發以下警報:
$.ajax({
statusCode: {404: function() {
alert('page not found');
}
});
success(data, textStatus, jqXHR)Function,Array
請求成功后的回調函數。參數:由服務器返回,并根據dataType參數進行處理后的數據;描述狀態的字符串。還有 jqXHR(在jQuery 1.4.x的中,XMLHttpRequest) 對象 。在jQuery 1.5, 成功設置可以接受一個函數數組。每個函數將被依次調用。Ajax 事件。
function (data, textStatus) {
// data 可能是 xmlDoc, jsonObj, html, text, 等等...
this; // 調用本次AJAX請求時傳遞的options參數
}
traditionalBoolean
如果你想要用傳統的方式來序列化數據,那么就設置為true。請參考工具分類下面的jQuery.param 方法。
timeoutNumber
設置請求超時時間(毫秒)。此設置將覆蓋全局設置。
typeString
(默認: "GET") 請求方式 ("POST" 或 "GET"), 默認為 "GET"。注意:其它 HTTP 請求方法,如 PUT 和 DELETE 也可以使用,但僅部分瀏覽器支持。
urlString
(默認: 當前頁地址) 發送請求的地址。
usernameString
用于響應HTTP訪問認證請求的用戶名
xhrFunction
需要返回一個XMLHttpRequest 對象。默認在IE下是ActiveXObject 而其他情況下是XMLHttpRequest 。用于重寫或者提供一個增強的XMLHttpRequest 對象。這個參數在jQuery 1.3以前不可用。
xhrFieldsmapV1.5
一對“文件名-文件值”在本機設置XHR對象。例如,如果需要的話,你可以用它來設置withCredentials為true的跨域請求。
示例
描述:
加載并執行一個 JS 文件。
jQuery 代碼:
$.ajax({
type: "GET",
url: "test.js",
dataType: "script"
});
描述:
保存數據到服務器,成功時顯示信息。
jQuery 代碼:
$.ajax({
type: "POST",
url: "some.php",
data: "name=John&location=Boston",
success: function(msg){
alert( "Data Saved: " + msg );
}
});
描述:
裝入一個 HTML 網頁最新版本。
jQuery 代碼:
$.ajax({
url: "test.html",
cache: false,
success: function(html){
$("#results").append(html);
}
});
描述:
同步加載數據。發送請求時鎖住瀏覽器。需要鎖定用戶交互操作時使用同步方式。
jQuery 代碼:
var html = $.ajax({
url: "some.php",
async: false
}).responseText;
描述:
發送 XML 數據至服務器。設置 processData 選項為 false,防止自動轉換數據格式。
jQuery 代碼:
var?xmlDocument?=?[create?xml?document];
$.ajax({
url:?"page.php",
processData:?false,
data:?xmlDocument,
success:?handleResponse
});
第5章 jQuery的動畫與特效
show()與hide()方法 ? ?較常用,不解釋。
滑動 ? ? ??slideDown()與slideUp()方法
要實現元素的滑動效果,需要調用jQuery中的兩個方法,一個是slideDown(),另一個是slideUp(),其調用的語法格式介紹如下。
其功能是以動畫的效果將所選擇元素的高度向下增大,使其呈現一種“滑動”的效果,而元素的其他屬性并不發生變化;參數speed為動畫顯示的速度,可選項[callback]為動畫顯示完成后,執行的回調函數。
淡入淡出fadeIn()與fadeOut()方法
jQuery實用工具函數
盒子模型
盒子模型是CSS中的專術名詞,用以描述頁面設置中的各種屬性,如內容(content)、填充(padding)、邊框(border)、邊界(margin)。由于這些屬性拼合在一起,與日常生活中的“盒子”很相像,因此稱為盒子模型。
盒子模型分為兩類:一類是W3C盒子模型;另一類是IE盒子模型。兩者最根本的區別在于屬性height與width這兩個值是否包含padding與border。
W3C盒子模型不包含padding與border,僅指內容(content)的height和width。
IE盒子模型的height和width的長度包含padding與border,
遍歷數組
使用$.each()工具函數可以實現頁面中元素的遍歷,此外還可以完成指定數組的遍歷,其調用的語法格式如下:
其中,參數obj表示要遍歷的數組或對象。fn為每個遍歷元素執行的回調函數,該函數包含兩個參數:para1表示數組的序號或對象的屬性;para2表示數組的元素和對象的屬性。
$.each()函數除了遍歷數組外,還可以遍歷對象,獲取對象的屬性和值。
數據篩選
在操作數組時,有時需要根據各種條件篩選元素,傳統的JavaScript代碼將遍歷整個數組,在遍歷中設置篩選規則,然后獲取符合規則的元素。而在jQuery中,可以使用工具函數jQuery.grep(),很方便地篩選數組中的任何元素,該函數調用的語法格式如下
參數array為要篩選的原數組,回調函數fn中可以設置兩個參數,其中elementOfArray為數組中的元素,indexInArray為元素在數組中的序列號。另外,可選項[invert]為布爾值,表示是否根據fn的規則取反向結果,默認值為false,表示不取反,如果為true表示取反,即返回與回調函數fn規則相反的數據。
數據變更
雖然可以通過$.grep()函數篩選數組中的元素,但如果要按指定條件修改數組中的所選元素,還需調用另外一個工具函數$.map(),其調用的語法格式如下:
其中,參數array為要變更的原數組。回調函數fn中可以設置兩個參數,其中elementOfArray為數組中的元素,indexInArray為元素在數組中的序列號。
數據搜索
在jQuery中,如果要在數組中搜索某個元素,可以使用工具函數$.inArray()。該方法相當于用JavaScript中的indexOf()函數搜索字符串中的某個字符。在工具函數$.inArray()中,如果找到了指定的某個元素,則返回該元素在數組中的索引號,否則返回-1值。其調用的格式如下所示:
字符串操作
在jQuery中,如果要除掉字符中左右兩邊的空格符,可以使用工具函數$.trim()。該函數常用于字符串操作,也是jQuery核心庫中唯一針對字符串操作的工具函數,其調用的語法格式如下所示