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'的提示。
让我们看一下这些修改是什么含义。$('a') 是一个jQuery选择器(selector),在这里，它选择所有的a标签（译者Keel注：即<a></a>），$号是 jQuery “类”(jQuery 'class')的一个别称，因此$()构造了一个新的jQuery 对象(jQuery object)。函数 click() 是这个jQuery对象的一个方法，它绑定了一个单击事件到所有选中的标签(这里是所有的a标签),并在事件触发时执行了它所提供的alert方法.
这里有一个拟行相似功能的代码:
<a href='#' οnclick='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');
});
});
用这些选择器和事件你已经可以做很多的事情了，但这里有一个更强的好东东！
$(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(); }); });这个代码选择了所有ID为'form'的元素，并在其第一个上call了一个reset()。如果你有一个以上的form，你可以这样做：
$(document).ready(function() { // use this to reset several forms at once $('#reset').click(function() { $('form').each(function() { this.reset(); }); }); });这样你在点击Reset链接后，就选择了文档中所有的form元素，并对它们都执行了一次reset()。
还有一个你可能要面对的问题是不希望某些特定的元素被选择。jQuery 提供了filter() 和not() 方法来解决这个问题。 filter()以过滤表达式来减少不符合的被选择项, not()则用来取消所有符合过滤表达式的被选择项. 考虑一个无序的list，你想要选择所有的没有ul子元素的li元素。
$(document).ready(function() { $('li').not(':has(ul)').css('border', '1px solid black');//原文为$('li').not('[ul]').css('border', '1px solid black'); });这个代码选择了所有的li元素，然后去除了有ul子元素的li元素。刷新浏览器后，所有的li元素都有了一个边框,
可以在子元素和属性(elements and attributes)上用作过滤器，比如你可能想选择所有的带有name属性的链接:$(document).ready(function() { $('a[name]').css('background-color','#eee'); //原文为“$('a[@name]').background('#eee');”在jQuery1.2及以上版本中,@符号应该去除,background方法被css方法取代 });这个代码给所有带有name属性的链接加了一个背景色
更常见的情况是以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元素，这让我们可以快速地选择在被点击问题下面的答案。
除了选择同级别的元素外，你也可以选择父级的元素。可能你想在用户鼠标移到文章某段的某个链接时，它的父级元素--也就是文章的这一段突出显示，试试这个：
$(document).ready(function() { $('a').hover(function() { $(this).parents('p').addClass('highlight'); }, function() { $(this).parents('p').removeClass('highlight'); }); });测试效果可以看到，移到文章某段的链接时，它所在的段全用上highlight样式，移走之后又恢复原样。
在我们继续之前我们先来看看这一步： 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] = '<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.
一个在使用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插件列表的前面的，当然也有很多其他的插件，比如我们下一章讲到的表格排序插件。
本章的相关链接:
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插件是非常容易的,如果你按照下面的原则来做,可以让其他人也容易地结合使用你的插件.
- 为你的插件取一个名字,在这个例子里面我们叫它'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; });注：在jQuery1.2及以上版本中，选择所有checkbox应该使用 input:checkbox , 因此以上代码第一行可写为:
$('input:checkbox').each(function() {无论何时候，当你的代码出现each时，你应该重写上面的代码来构造一个插件,很直接地:
$.fn.check = function() { return this.each(function() { this.checked = true; }); };这个插件现在可以这样用:
$('input:checkbox').check();注：在jQuery1.2及以上版本中，选择所有checkbox应该使用 input:checkbox 原文为：$('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 });
4974
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
