jQuery中文入門指南

這個指南是一個對jQuery庫的說明，要求讀者了解HTML(DOM)和CSS的一些常識。它包括了一個簡單的Hello World的例子，選擇器和事件基礎，AJAX、FX的用法，以及如何制作jQuery的插件。 這個指南包括了很多代碼，你可以copy它們，并試着修改它們，看看産生的效果。

一開始,我們需要一個jQuery的庫,最新的下載下傳可以到這裡找到。這個指南提供一個基本包含執行個體的包供下載下傳.

下載下傳：jQuery Starterkit

(譯者Keel注:一定要下載下傳這個包，光看文章不實踐肯定是不行的。)

下載下傳後解壓縮，然後用你最喜歡的文本編輯器打開starterkit.html和custom.js這兩個檔案。(譯者Keel注:這兩個就是例子檔案,所有的例子都用這兩個例子作出,custom.js寫jQuery代碼,starterkit.html觀察效果.建議用editPlus打開)

現在,我們就已經做好了一切準備來進行這個著名的"Hello world"例子.

在做所有事情之前,我們要讓jQuery讀取和處理文檔的DOM,必須盡可能快地在DOM載入後開始執行事件,是以,我們用一個ready事件作為處理HTML文檔的開始.看看我們打開的custom.js這個檔案,裡面已經準備好了:

放一個簡單的alert事件在需要等DOM完成載入,是以我們把任務稍稍變複雜一點:在點選任何一個連結時顯示一個alert.

這樣在你點選頁面的一個連結時都會觸發這個"Hello world"的提示。

(譯者Keel注:請照此代碼修改custom.js并儲存,然後用浏覽器打開starterkit.html觀察效果。)

讓我們看一下這些修改是什麼含義。$("a") 是一個jQuery選擇器(selector),在這裡，它選擇所有的a标簽（譯者Keel注：即<a></a>），$号 是 jQuery “類”(jQuery "class")的一個别稱，是以$()構造了一個新的jQuery 對象(jQuery object)。函數 click() 是這個jQuery對象的一個方法，它綁定了一個單擊事件到所有選中的标簽(這裡是所有的a标簽),并在事件觸發時執行了它所提供的alert方法.

這裡有一個拟行相似功能的代碼:

不同之處很明顯,用jQuery不需要在每個a标簽上寫onclick事件,是以我們擁有了一個整潔的結構文檔(HTML)和一個行為文檔(JS),達到了将結構與行為分開的目的,就像我們使用CSS追求的一樣.

下面我們會更多地了解到選擇器與事件.

jQuery Core

jQuery Selectors

jQuery Events

jQuery提供兩種方式來選擇html的 elements，第一種是用CSS和Xpath選擇器聯合起來形成一個字元串來傳送到jQuery的構造器（如：$("div > ul a")）；第二種是用jQuery對象的幾個methods(方法)。這兩種方式還可以聯合起來混合使用。

為了測試一下這些選擇器，我們來試着在我們starterkit.html中選擇并修改第一個ordered list.

一開始，我們需要選擇這個list本身，這個list有一個ID叫“orderedlist”，通常的javascript寫法是document.getElementById("orderedlist").在jQuery中，我們這樣做：

這裡将starterkit中的一個CSS樣式red附加到了orderedlist上(譯者Keel注：參考測試包中的css目錄下的core.css，其中定義了red樣式)。是以，在你重新整理了starterkit.html後，你将會看到第一個有序清單(ordered list )背景色變成了紅色，而第二個有序清單沒有變化.

現在，讓我們添加一些新的樣式到list的子節點.

這樣，所有orderedlist中的li都附加了樣式"blue"。

現在我們再做個複雜一點的，當把滑鼠放在li對象上面和移開時進行樣式切換，但隻在list的最後一個element上生效。

還有大量的類似的CSS和XPath例子，更多的例子和清單可以在這裡找到。（譯者Keel注：入門看此文，修行在個人，要想在入門之後懂更多，是以這段話的幾個連結遲早是要必看的！不會又要翻譯吧...^_^!）

每一個onXXX事件都有效，如onclick,onchange,onsubmit等，都有jQuery等價表示方法（譯者Keel注：jQuery不喜歡onXXX，是以都改成了XXX，去掉了on）。其他的一些事件，如ready和hover,也提供了相應的方法。

你可以在Visual jQuery找到全部的事件清單，在Events欄目下.

用這些選擇器和事件你已經可以做很多的事情了，但這裡有一個更強的好東東！

find() 讓你在已經選擇的element中作條件查找,是以 $("#orderedlist).find("li") 就像 $("#orderedlist li")一樣。each()方法疊代了所有的li，并可以在此基礎上作更多的處理。 大部分的方法,如addClass(), 都可以用它們自己的 each() 。在這個例子中, html()用來擷取每個li的html文本, 追加一些文字，并将之設定為li的html文本。（譯者Keel注：從這個例子可以看到.html()方法是擷取對象的html代碼，而.html('xxx')是設定'xxx'為對象的html代碼）

另一個經常碰到的任務是在沒有被jQuery覆寫的DOM元素上call一些方法，想像一個在你用AJAX方式成功送出後的reset：

（譯者Keel注：這裡作者将form的id也寫成了form，源檔案有<form id="form">，這是非常不好的寫法，你可以将這個ID改成form1或者testForm，然後用$("#form1")或 者$("#testForm")來表示它，再進行測試。）

這個代碼選擇了所有ID為"form"的元素，并在其第一個上call了一個reset()。如果你有一個以上的form，你可以這樣做：

（譯者Keel注：請注意一定要親自将這些代碼寫在custom.js中并在starterkit.html上測試效果才能有所體會！必要時要觀察starterkit.html的html代碼）

這樣你在點選Reset連結後，就選擇了文檔中所有的form元素，并對它們都執行了一次reset()。

還 有一個你可能要面對的問題是不希望某些特定的元素被選擇。jQuery 提供了filter() 和not() 方法來解決這個問題。 filter()以過濾表達式來減少不符合的被選擇項, not()則用來取消所有符合過濾表達式的被選擇項. 考慮一個無序的list，你想要選擇所有的沒有ul子元素的li元素。

這個代碼選擇了所有的li元素，然後去除了有ul子元素的li元素。重新整理浏覽器後，所有的li元素都有了一個邊框，隻有ul子元素的那個li元素例外。

（譯 者Keel注：請注意體會友善之極的css()方法，并再次提醒請務必實際測試觀察效果，比方說換個CSS樣式呢？再加一個CSS樣式呢？像這 樣：$("li").not("[ul]").css("border", "1px solid black").css("color","red");）

上面代碼中的[expression] 文法是從XPath而來，可以在子元素和屬性(elements and attributes)上用作過濾器，比如你可能想選擇所有的帶有name屬性的連結:

這個代碼給所有帶有name屬性的連結加了一個背景色。（譯者Keel注：這個顔色太不明顯了，建議寫成$("a[name]").css("background-color","#eee");） [注：在jQuery1.2及以上版本中,@符号應該去除,下文中不再說明]

更常見的情況是以name來選擇連結，你可能需要選擇一個有特點href屬性的連結，這在不同的浏覽器下對href的了解可能會不一緻，是以我們的部分比對("*=")的方式來代替完全比對("=")：

到現在為止，選擇器都用來選擇子元素或者是過濾元素。另外還有一種情況是選擇上一個或者下一個元素，比如一個FAQ的頁面，答案首先會隐藏，當問題點選時，答案顯示出來，jQuery代碼如下：

這 裡我們用了一些鍊式表達法來減少代碼量，而且看上去更直覺更容易了解。像'#faq' 隻選擇了一次，利用end()方法，第一次find()方法會結束(undone)，是以我們可以接着在後面繼續find('dt')，而不需要再 寫$('#faq').find('dt')。

在點選事件中的，我們用 $(this).next() 來找到dt下面緊接的一個dd元素，這讓我們可以快速地選擇在被點選問題下面的答案。

（譯 者Keel注：這個例子真是太酷了，FAQ中的答案可以收縮！從利用next()的思路到實作這些效果都有很多地方需要我們消化，注意 if (answer.is(':visible'))用法，注意answer.slideUp();不懂的地方趕緊查我在最開始提到的兩個必看API文檔）

除了選擇同級别的元素外，你也可以選擇父級的元素。可能你想在使用者滑鼠移到文章某段的某個連結時，它的父級元素--也就是文章的這一段突出顯示，試試這個：

測試效果可以看到，移到文章某段的連結時，它所在的段全用上highlight樣式，移走之後又恢複原樣。

（譯者Keel注：highlight是core.css中定義的樣式，你也可以改變它，注意這裡有第二個function()這是hover方法的特點，請在API文檔中查閱hover，上面也有例子說明）

在我們繼續之前我們先來看看這一步： jQuery會讓代碼變得更短進而更容易了解和維護，下面是$(document).ready(callback)的縮寫法：

應用到我們的Hello world例子中，可以這樣:

現在，我們手上有了這些基礎的知識，我們可以更進一步的探索其它方面的東西，就從AJAX開始！

在這一部分我們寫了一個小小的AJAX應用，它能夠rate一些東西（譯Keel注：就是對某些東西投票），就像在youtube.com上面看到的一樣。

首先我們需要一些伺服器端代碼，這個例子中用到了一個PHP檔案，讀取rating參數然後傳回rating總數和平均數。看一下rate.php代碼.

雖然這些例子也可以不使用AJAX來實作，但顯示我們不會那麼做，我們用jQuery生成一個DIV容器，ID是"rating".

這段代碼生成了5個連結，并将它們追加到id為"rating"容器中，當其中一個連結被點選時，該連結标明的分數就會以rating參數形式發送到rate.php，然後，結果将以XML形式會從伺服器端傳回來，添加到容器中，替代這些連結。

如果你沒有一個安裝過PHP的webserver，你可以看看這個線上的例子.

不使用javascript實作的例子可以通路 softonic.de 點選 "Kurz bewerten!"

更多的AJAX方法可以從這裡 找到，或者看看API文檔 下面的AJAX filed under AJAX.

（譯者Keel注：這個線上執行個體從國内通路還是比較慢的，點選後要等一會兒才能看到結果，可以考慮對它進行修改，比如加上loading，投票後加上再投票的傳回連結等。此外，這個例子中還是有很多需要進一步消化的地方，看不懂的地方請參考API文檔。）

一個在使用AJAX載入内容時經常發生的問題是：當載入一個事件句柄到一個HTML文檔時，還需要在載入内容上應用這些事件，你不得不在内容加載完成後應用這些事件句柄，為了防止代碼重複執行，你可能用到如下一個function:

現在，addClickHandlers隻在DOM載入完成後執行一次，這是在使用者每次點選具有clickMeToLoadContent 這個樣式的連結并且内容加載完成後.

請注意addClickHandlers函數是作為一個局部變量定義的，而不是全局變量(如：function addClickHandlers() {...})，這樣做是為了防止與其他的全局變量或者函數相沖突.

另一個常見的問題是關于回調(callback)的參數。你可以通過一個額外的參數指定回調的方法，簡單的辦法是将這個回調方法包含在一個其它的function中:

用到簡單的AJAX後，我們可以認為已經非常之“web2.0”了，但是到現在為止，我們還缺少一些酷炫的效果。下一節将會談到這些效果.

一些動态的效果可以使用 show() 和 hide()來表現:

你可以與 animate()聯合起來建立一些效果,如一個帶漸顯的滑動效果:

很多不錯的效果可以通路interface plugin collection. 這個站點提供了很多demos和文檔

這些效果插件是位于jQuery插件清單的前面的，當然也有很多其他的插件，比如我們下一章講到的表格排序插件。

這個表格排序插件能讓我們在用戶端按某一列進行排序，引入jQuery和這個插件的js檔案，然後告訴插件你想要哪個表格擁有排序功能。

要測試這個例子，先在starterkit.html中加上像下面這一行的代碼：

然後可以這樣調用不着:

現在點選表格的第一行head區域，你可以看到排序的效果，再次點選會按倒過來的順序進行排列。

這個表格還可以加一些突出顯示的效果，我們可以做這樣一個隔行背景色（斑馬線）效果:

關于這個插件的更多例子和文檔可以在 tablesorter首頁找到.

幾乎所有的特件都是這樣用的:先include插件的js檔案,然後在某些元素上使用插件定義的方法,當然也有一些參數選項是可以配置的

經常更新的插件清單可以從jQuery官方站 on the jQuery site找到.

當你更經常地使用jQuery時,你會發現将你自己的代碼打包成插件是很有用處的,它能友善地讓你的公司或者其他人進行重用.下一章我們将談到如何建構一個自己的插件.

寫一個自己的jQuery插件是非常容易的,如果你按照下面的原則來做,可以讓其他人也容易地結合使用你的插件.

為你的插件取一個名字,在這個例子裡面我們叫它"foobar".

建立一個像這樣的檔案:jquery.[yourpluginname].js,比如我們建立一個jquery.foobar.js

建立一個或更多的插件方法,使用繼承jQuery對象的方式,如:

可選的:建立一個用于幫助說明的函數,如:

你現在可以在你的插件中使用這些幫助函數了:

可選的l:建立一個預設的初始參數配置,這些配置也可以由使用者自行設定,如:

現在可以無需做任何配置地使用插件了,預設的參數在此時生效:

或者加入這些參數定義:

如果你release你的插件, 你還應該提供一些例子和文檔,大部分的插件都具備這些良好的參考文檔.

現在你應該有了寫一個插件的基礎,讓我們試着用這些知識寫一個自己的插件.

很多人試着控制所有的radio或者checkbox是否被選中,比如:

注：在jQuery1.2及以上版本中，選擇所有checkbox應該使用 input:checkbox , 是以以上代碼第一行可寫為:

$('input:checkbox').each(function() {

無論何時候，當你的代碼出現each時，你應該重寫上面的代碼來構造一個插件,很直接地:

這個插件現在可以這樣用:

注：在jQuery1.2及以上版本中，選擇所有checkbox應該使用 input:checkbox 原文為：$("input[type='checkbox']").check();

現在你應該還可以寫出uncheck()和toggleCheck()了.但是先停一下,讓我們的插件接收一些參數.

這裡我們設定了預設的參數,是以将"on"參數省略也是可以的,當然也可以加上"on","off", 或 "toggle",如:

如果有多于一個的參數設定會稍稍有點複雜,在使用時如果隻想設定第二個參數,則要在第一個參數位置寫入null.

從上一章的tablesorter插件用法我們可以看到,既可以省略所有參數來使用或者通過一個 key/value 對來重新設定每個參數.

作為一個練習,你可以試着将 第四章 的功能重寫為一個插件.這個插件的骨架應該是像這樣的:

如果你想做更好的javascript開發,建議你使用一個叫 FireBug的firefox插件. 它提供了斷點調試(比alert強多了)、觀察DOM變化等很多漂亮的功能

如果你還有未解決的問題，或者新的想法與建議，你可以使用jQuery的郵件清單 

關于這個指南的任何事情，你可以寫mail給作者或者發表評論在他的日志：blog.

關于這個指南的翻譯任何事情，你可以寫mail給我.或者在 BLOG中留言.

大大感謝John Resig創造了這麼好的library! 感謝jQuery community 為John提供了如此多的咖啡和其他的一切!