xhchc

          危波帆墻,笑談只在桃花上;與誰共尚,風吹萬里浪; 相依相偎,不做黃泉想;莫惆悵,碧波潮生,一蕭自狂放……

           

          jQuery中文入門指南,翻譯加實例,jQuery的起點教程(轉)

          中文版譯者:Keel

          此文以實例為基礎一步步說明了jQuery的工作方式。現以中文翻譯(添加我的補充說明)如下。如有相關意見或建議請麻煩到我的 BLOG 寫個回復或者 EMAIL 告知。

          英文原版:http://jquery.bassistance.de/jquery-getting-started.html ,感謝原文作者 Jörn Zaefferer

          本文發布已征求原作者同意。

          另外我認為在學習過程中,有兩個API文檔你要打開隨時查看:

          以下部分為原文翻譯:


          jQuery入門指南教程

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

          內容提要

          1. 安裝
          2. Hello jQuery
          3. Find me:使用選擇器和事件
          4. Rate me:使用AJAX
          5. Animate me(讓我生動起來):使用FX
          6. Sort me(將我有序化):使用tablesorter插件(表格排序)
          7. Plug me:制作您自己的插件
          8. Next steps(下一步)

          安裝

          一開始,我們需要一個jQuery的庫,最新的下載可以到這里找到。這個指南提供一個基本包含實例的包供下載.

          下載:jQuery Starterkit

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

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

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

          本章的相關鏈接:

          Hello jQuery

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

          $(document).ready(function() {
          // do stuff when DOM is ready
          });

          放一個簡單的alert事件在需要等DOM完成載入,所以我們把任務稍稍變復雜一點:在點擊任何一個鏈接時顯示一個alert.

          $(document).ready(function() {
          $("a").click(function() {
          alert("Hello world!");
          });
          });

          這樣在你點擊頁面的一個鏈接時都會觸發這個"Hello world"的提示。

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

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

          這里有一個擬行相似功能的代碼:

          <a href="#" onclick="alert('Hello world')">Link</a>

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

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

          本章的相關鏈接:

          Find me:使用選擇器和事件

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

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

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

          $(document).ready(function() {
          $("#orderedlist").addClass("red");
          });

          這里將starterkit中的一個CSS樣式red附加到了orderedlist上(譯者Keel注:參考測試包中的css目錄下的core.css,其中定義了red樣式)。因此,在你刷新了starterkit.html后,你將會看到第一個有序列表(ordered list )背景色變成了紅色,而第二個有序列表沒有變化.

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

          $(document).ready(function() {
          $("#orderedlist > li").addClass("blue");
          });

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

          現在我們再做個復雜一點的,當把鼠標放在li對象上面和移開時進行樣式切換,但只在list的最后一個element上生效。

          $(document).ready(function() {
          $("#orderedlist li:last").hover(function() {
          $(this).addClass("green");
          }, function() {
          $(this).removeClass("green");
          });
          });

          還有大量的類似的CSSXPath例子,更多的例子和列表可以在這里找到。(譯者Keel注:入門看此文,修行在個人,要想在入門之后懂更多,所以這段話的幾個鏈接遲早是要必看的!不會又要翻譯吧...^_^!)

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

          你可以在Visual jQuery找到全部的事件列表,在Events欄目下.

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

          $(document).ready(function() {
          $("#orderedlist").find("li").each(function(i) {
          $(this).html( $(this).html() + " BAM! " + i );
          });
          });

          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:

          $(document).ready(function() {
          // use this to reset a single form
          $("#reset").click(function() {
          $("#form")[0].reset();
          });
          });

          (譯者Keel注:這里作者將form的id也寫成了form,源文件有<form id="form">,這是非常不好的寫法,你可以將這個ID改成form1或者testForm,然后用$("#form1")或者$("#testForm")來表示它,再進行測試。)

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

          $(document).ready(function() {
          // use this to reset several forms at once
          $("#reset").click(function() {
          $("form").each(function() {
          this.reset();
          });
          });
          });

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

          這樣你在點擊Reset鏈接后,就選擇了文檔中所有的form元素,并對它們都執行了一次reset()。

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

          $(document).ready(function() {
          $("li").not("[ul]").css("border", "1px solid black");
          });

          這個代碼選擇了所有的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屬性的鏈接:

          $(document).ready(function() {
          $("a[@name]").background("#eee");
          });

          這個代碼給所有帶有name屬性的鏈接加了一個背景色。(譯者Keel注:這個顏色太不明顯了,建議寫成$("a[@name]").background("red");)

          更常見的情況是以name來選擇鏈接,你可能需要選擇一個有特點href屬性的鏈接,這在不同的瀏覽器下對href的理解可能會不一致,所以我們的部分匹配("*=")的方式來代替完全匹配("="):

          $(document).ready(function() {
          $("a[@href*=/content/gallery]").click(function() {
          // do something with all links that point somewhere to /content/gallery
          });
          });

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

          $(document).ready(function() {
          $('#faq').find('dd').hide().end().find('dt').click(function() {
          var answer = $(this).next();
          if (answer.is(':visible')) {
          answer.slideUp();
          } else {
          answer.slideDown();
          }
          });
          });

          這里我們用了一些鏈式表達法來減少代碼量,而且看上去更直觀更容易理解。像'#faq' 只選擇了一次,利用end()方法,第一次find()方法會結束(undone),所以我們可以接著在后面繼續find('dt'),而不需要再寫$('#faq').find('dt')。

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

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

          除了選擇同級別的元素外,你也可以選擇父級的元素。可能你想在用戶鼠標移到文章某段的某個鏈接時,它的父級元素--也就是文章的這一段突出顯示,試試這個:

          $(document).ready(function() {
          $("a").hover(function() {
          $(this).parents("p").addClass("highlight");
          }, function() {
          $(this).parents("p").removeClass("highlight");
          });
          });

          測試效果可以看到,移到文章某段的鏈接時,它所在的段全用上highlight樣式,移走之后又恢復原樣。

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

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

          $(function() {
          // code to execute when the DOM is ready
          });

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

          $(function() {
          $("a").click(function() {
          alert("Hello world!");
          });
          });

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

          本章的相關鏈接:

          Rate me:使用AJAX

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

          首先我們需要一些服務器端代碼,這個例子中用到了一個PHP文件,讀取rating參數然后返回rating總數和平均數。看一下rate.php代碼.

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

          $(document).ready(function() {
          // generate markup
          var ratingMarkup = ["Please rate: "];
          for(var i=1; i <= 5; i++) {
          ratingMarkup[ratingMarkup.length] = "<a href='#'>" + i + "</a> ";
          }
          // add markup to container and applier click handlers to anchors
          $("#rating").append( ratingMarkup.join('') ).find("a").click(function(e) {
          e.preventDefault();
          // send requests
          $.post("rate.php", {rating: $(this).html()}, function(xml) {
          // format result
          var result = [
          "Thanks for rating, current average: ",
          $("average", xml).text(),
          ", number of votes: ",
          $("count", xml).text()
          ];
          // output result
          $("#rating").html(result.join(''));
          } );
          });
          });

          這段代碼生成了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:

          // lets use the shortcut
          $(function() {
          var addClickHandlers = function() {
          $("a.clickMeToLoadContent").click(function() {
          $("#target").load(this.href, addClickHandlers);
          });
          };
          addClickHandlers();
          });

          現在,addClickHandlers只在DOM載入完成后執行一次,這是在用戶每次點擊具有clickMeToLoadContent 這個樣式的鏈接并且內容加載完成后.

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

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

          // get some data
          var foobar = ...;
          // specify handler, it needs data as a paramter
          var handler = function(data) {
          ...
          };
          // add click handler and pass foobar!
          $('a').click( function(event) { handler(foobar); } );
          // if you need the context of the original handler, use apply:
          $('a').click( function(event) { handler.apply(this, [foobar]); } );

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

          本章的相關鏈接:

          Animate me(讓我生動起來):使用FX

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

          $(document).ready(function() {
          $("a").toggle(function() {
          $(".stuff").hide('slow');
          }, function() {
          $(".stuff").show('fast');
          });
          });

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

          $(document).ready(function() {
          $("a").toggle(function() {
          $(".stuff").animate({
          height: 'hide',
          opacity: 'hide'
          }, 'slow');
          }, function() {
          $(".stuff").animate({
          height: 'show',
          opacity: 'show'
          }, 'slow');
          });
          });

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

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

          本章的相關鏈接:

          Sort me(將我有序化):使用tablesorter插件(表格排序)

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

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

          <script src="lib/jquery.tablesorter.js" type="text/javascript"></script>

          然后可以這樣調用不著:

          $(document).ready(function() {
          $("#large").tableSorter();
          });

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

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

          $(document).ready(function() {
          $("#large").tableSorter({
          stripingRowClass: ['odd','even'],	// Class names for striping supplyed as a array.
          stripRowsOnStartUp: true		// Strip rows on tableSorter init.
          });
          });

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

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

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

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

          本章的相關鏈接:

          Plug me:制作自己的插件

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

          1. 為你的插件取一個名字,在這個例子里面我們叫它"foobar".
          2. 創建一個像這樣的文件:jquery.[yourpluginname].js,比如我們創建一個jquery.foobar.js
          3. 創建一個或更多的插件方法,使用繼承jQuery對象的方式,如:
            jQuery.fn.foobar = function() {
                // do something
                };
          4. 可選的:創建一個用于幫助說明的函數,如:
            jQuery.fooBar = {
                height: 5,
                calculateBar = function() { ... },
                checkDependencies = function() { ... }
                };

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

            jQuery.fn.foobar = function() {
                // do something
                jQuery.foobar.checkDependencies(value);
                // do something else
                };
          5. 可選的l:創建一個默認的初始參數配置,這些配置也可以由用戶自行設定,如:
            jQuery.fn.foobar = function(options) {
                var settings = {
                value: 5,
                name: "pete",
                bar: 655
                };
                if(options) {
                jQuery.extend(settings, options);
                }
                };

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

            $("...").foobar();

            或者加入這些參數定義:

            $("...").foobar({
                value: 123,
                bar: 9
                });

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

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

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

          $("input[@type='checkbox']").each(function() {
          this.checked = true;
          // or, to uncheck
          this.checked = false;
          // or, to toggle
          this.checked = !this.checked;
          });

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

          $.fn.check = function() {
          return this.each(function() {
          this.checked = true;
          });
          };

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

          $("input[@type='checkbox']").check();

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

          $.fn.check = function(mode) {
          var mode = mode || 'on'; // if mode is undefined, use 'on' as default
          return this.each(function() {
          switch(mode) {
          case 'on':
          this.checked = true;
          break;
          case 'off':
          this.checked = false;
          break;
          case 'toggle':
          this.checked = !this.checked;
          break;
          }
          });
          };

          這里我們設置了默認的參數,所以將"on"參數省略也是可以的,當然也可以加上"on","off", 或 "toggle",如:

          $("input[@type='checkbox']").check();
          $("input[@type='checkbox']").check('on');
          $("input[@type='checkbox']").check('off');
          $("input[@type='checkbox']").check('toggle');

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

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

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

          $.fn.rateMe = function(options) {
          var container = this; // instead of selecting a static container with $("#rating"), we now use the jQuery context
          var settings = {
          url: "rate.php"
          // put more defaults here
          // remember to put a comma (",") after each pair, but not after the last one!
          };
          if(options) { // check if options are present before extending the settings
          $.extend(settings, options);
          }
          // ...
          // rest of the code
          // ...
          return this; // if possible, return "this" to not break the chain
          });

          Next steps(下一步)

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

          如果你還有未解決的問題,或者新的想法與建議,你可以使用jQuery的郵件列表 jQuery mailing list.

          posted on 2009-03-02 16:55 chu 閱讀(209) 評論(0)  編輯  收藏


          只有注冊用戶登錄后才能發表評論。


          網站導航:
           

          導航

          統計

          常用鏈接

          留言簿(2)

          隨筆檔案

          我的鏈接

          搜索

          最新評論

          閱讀排行榜

          評論排行榜

          主站蜘蛛池模板: 云安县| 龙口市| 镇赉县| 金坛市| 合阳县| 鸡泽县| 淄博市| 景德镇市| 博客| 泽州县| 综艺| 汉沽区| 厦门市| 平原县| 大同县| 布尔津县| 土默特左旗| 开原市| 称多县| 大余县| 孟村| 庆安县| 错那县| 鄂托克前旗| 兰州市| 满洲里市| 渭源县| 汾西县| 孝昌县| 河池市| 华阴市| 图片| 巴里| 余江县| 赤壁市| 炎陵县| 吉安市| 慈溪市| 徐水县| 温宿县| 龙陵县|