中文版译者：Keel

此文以实例为基础一步步说明了jQuery的工作方式。现以中文翻译（添加我的补充说明）如下。如有相关意见或建议请麻烦到我的 BLOG 写个回复或者 EMAIL 告知。

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

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

另外我认为在学习过程中,有两个API文档你要打开随时查看:

• http://jquery.com/api/
• http://visualjquery.com/

以下部分为原文翻译:

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”例子.

本章的相关链接:

• Starterkit
• jQuery Downloads

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注：即），$ 号是 jQuery “类”(jQuery “class”)的一个别称，因此$()构造了一个新的jQuery 对象(jQuery object)。函数 click() 是这个jQuery对象的一个方法，它绑定了一个单击事件到所有选中的标签(这里是所有的a标签),并在事件触发时执行了它所提供的alert方法.

这里有一个拟行相似功能的代码:

Link

不同之处很明显,用jQuery不需要在每个a标签上写onclick事件,所以我们拥有了一个整洁的结构文档(HTML)和一个行为文档(JS),达到了将结构与行为分开的目的,就像我们使用CSS追求的一样.

下面我们会更多地了解到选择器与事件.

本章的相关链接:

• jQuery Base
• jQuery Expressions
• jQuery Basic Events

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");
 });
});

还有大量的类似的CSS和XPath例子，更多的例子和列表可以在这里找到。（译者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，源文件有

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] = "" + i + " ";
 }
 // 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”了，但是到现在为止，我们还缺少一些酷炫的效果。下一节将会谈到这些效果.

本章的相关链接:

• jQuery AJAX Module
• jQuery API: Contains description and examples for append and all other jQuery methods
• ThickBox: A jQuery plugin that uses jQuery to enhance the famous lightbox

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插件列表的前面的，当然也有很多其他的插件，比如我们下一章讲到的表格排序插件。

本章的相关链接:

• jQuery FX Module
• Interface plugin

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

这个表格排序插件能让我们在客户端按某一列进行排序，引入jQuery和这个插件的js文件，然后告诉插件你想要哪个表格拥有排序功能。

要测试这个例子，先在starterkit.html中加上像下面这一行的代码：

然后可以这样调用不着:

$(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时,你会发现将你自己的代码打包成插件是很有用处的,它能方便地让你的公司或者其他人进行重用.下一章我们将谈到如何构建一个自己的插件.

本章的相关链接:

• Plugins for jQuery
• Tablesorter Plugin

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.

关于这个指南的任何事情，你可以写mail给作者或者发表评论在他的日志：blog.

关于这个指南的翻译任何事情，你可以写mail给我或者发表评论在我的日志：blog.

还有什么…

大大感谢John Resig创造了这么好的library! 感谢jQuery community 为John提供了如此多的咖啡和其他的一切!

© 2006, Jörn Zaefferer – last update: 2006-09-12

中文版翻译:Keel