jQuery入门指南教程
这个指南是一

个对jQuery库的说明,要求读者了解HTML(DOM)和CSS的一些常识。它包括了一个最简单的Hello World的

例子,选择器和事件基础,AJAX、FX的用法,以及如何制作jQuery的插件。 这个指南包括了很多代码,

你可以复制它们,并试着修改它们,看看产生的效果。

内容提要
安装jquery
Hello

jQuery
Find me:使用选择器和事件
Rate me:使用AJAX
Animate me(让我生动起来):使用

FX
Sort me(将我有序化):使用tablesorter插件(表格排序)
Plug me:制作您自己的插件

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方法.

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

onclick="alert('Hello world')">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,源文件有

,这是非常不好的写法,你可以将这个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开始!

本章

的相关链接:
jQuery API documentation
Visual jQuery – A categorized browsable API

documentation
jQuery Expressions: CSS
jQuery Expressions: XPath
jQuery

Expressions: Custom
jQuery Special Events
jQuery DOM Traversing
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插件是非常容易的,如果你按照下面的原则来做,可以让其他人也容

易地结合使用你的插件.

为你的插件取一个名字,在这个例子里面我们叫它”foobar”.
创建

一个像这样的文件:jquery.[yourpluginname].js,比如我们创建一个jquery.foobar.js
创建一个或

更多的插件方法,使用继承jQuery对象的方式,如: jQuery.fn.foobar = function() {
// do

something
};可选的:创建一个用于帮助说明的函数,如: jQuery.fooBar = {
height:

5,
calculateBar = function() { … },
checkDependencies = function() { … }

};你现在可以在你的插件中使用这些帮助函数了:

jQuery.fn.foobar = function() {

// do something
jQuery.foobar.checkDependencies(value);
// do something

else
};可选的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
});

广告联系QQ:751753217
无觅关联推荐,快速提升流量