阮一峰：jQuery官方基础教程笔记

原文地址：http://www.jobbole.com/entry.php/1151

jQuery是目前使用最广泛的javascript函数库。

　　据统计，全世界排名前100万的网站，有46%使用jQuery，远远超过其他库。微软公司甚至把jQuery作为他们的官方库。

　　对于网页开发者来说，学会jQuery是必要的。因为它让你了解业界最通用的技术，为将来学习更高级的库打下基础，并且确实可以很轻松地做出许多复杂的效果。

　　虽然jQuery上手简单，比其他库容易学会，但是要全面掌握，却不轻松。因为它涉及到网页开发的方方面面，提供的各种方法和内部变化有上千种之多。初学者常常感到，入门很方便，提高很困难。

　　目前，互联网上最好的jQuery入门教材，是Rebecca Murphey写的《jQuery基础教程》（jQuery Fundamentals）。在Google里搜索"jQuery培训"，此书排在第一位。jQuery官方团队已经同意，把此书作为官方教程的基础。

　　这本书虽然是入门教材，但也足足有100多页。我对它做了一个详细的笔记，试图理清jQuery的设计思想，找出学习的脉络。我的目标是全面掌握jQuery，遇到问题的时候，心里有底，基本知道使用它的哪一个功能，然后可以迅速从手册中找到具体的写法。

　　下面就是我的笔记，它应该是目前网上不多的jQuery中文教程之一。你只需要一点javascript语言的基本知识，就能看懂它，在最短的时间里，掌握jQuery的所有主要方面（除了ajax和插件开发）。

===========================================

　　jQuery设计思想

　　原文网址：http://jqfundamentals.com/book/
　　
　　阮一峰翻译整理

　　【目录】

　　一、选择网页元素

　　二、改变结果集

　　三、链式操作

　　四、元素的操作：取值和赋值

　　五、元素的操作：移动

　　六、元素的操作：复制、删除和创建

　　七、工具方法

　　八、事件操作

　　九、特殊效果

　　【正文】

　　一、选择网页元素

　　jQuery的基本设计和主要用法，就是"选择某个网页元素，然后对其进行某种操作"。这是它区别于其他函数库的根本特点。

　　使用jQuery的第一步，往往就是将一个选择表达式，放进构造函数jQuery()（简写为$），然后得到被选中的元素。

　　选择表达式可以是CSS选择器：

　

代码:

  $(document) //选择整个文档对象

 　　$('#myId') //选择ID为myId的网页元素

 　　$('div.myClass') //选择class为myClass的div元素

 　　$('input[name=first]') //选择name属性等于first的input元素

　　
　　也可以是jQuery特有的表达式：

代码:

$('a:first') //选择网页中第一个a元素

  $('tr:odd') //选择表格的奇数行

$('#myForm :input') //选择表单中的input元素

 $('div:visible') //选择可见的div元素

 $('div:gt(2)') //选择所有的div元素，除了前三个

 $('div:animated') //选择当前处于动画状态的div元素

　

　　二、改变结果集

　　如果选中多个元素，jQuery提供过滤器，可以缩小结果集：

代码:

$('div').has('p'); //选择包含p元素的div元素

$('div').not('.myClass'); //选择class不等于myClass的div元素　

$('div').filter('.myClass'); //选择class等于myClass的div元素

$('div').first(); //选择第1个div元素

$('div').eq(5); //选择第6个div元素

　
　
　　有时候，我们需要从结果集出发，移动到附近的相关元素，jQuery也提供了在DOM树上的移动方法：

代码:

$('div').next('p'); //选择div元素后面的第一个p元素

 $('div').parent(); //选择div元素的父元素

 $('div').closest('form'); //选择离div最近的那个form父元素

 $('div').children(); //选择div的所有子元素

 $('div').siblings(); //选择div的同级元素

　　　　
　　三、链式操作

　　选中网页元素以后，就可以对它进行某种操作。

　　jQuery允许将所有操作连接在一起，以链条的形式写出来，比如：

　　

代码:

$('div').find('h3').eq(2).html('Hello');

　　分解开来，就是下面这样：

代码:

$('div') //找到div元素

 .find('h3') //选择其中的h3元素

 .eq(2) //选择第3个h3元素

 .html('Hello'); //将它的内容改为Hello

　　
　　
　　这是jQuery最令人称道、最方便的特点。它的原理在于每一步的jQuery操作，返回的都是一个jQuery对象，所以不同操作可以连在一起。

　　jQuery还提供了.end()方法，使得结果集可以后退一步：

代码:

$('div') 

 .find('h3')

 .eq(2)

 .html('Hello')

 .end() //退回到选中所有的h3元素的那一步

 .eq(0) //选中第一个h3元素

 .html('World'); //将它的内容改为World

　　　　
　　四、元素的操作：取值和赋值

　　操作网页元素，最常见的需求是取得它们的值，或者对它们进行赋值。

　　jQuery使用同一个函数，来完成取值（getter）和赋值（setter）。到底是取值还是赋值，由函数的参数决定。

　　

代码:

$('h1').html(); //html()没有参数，表示取出h1的值

 　　$('h1').html('Hello'); //html()有参数Hello，表示对h1进行赋值

　
　
　　常见的取值和赋值函数如下：

　　

代码:

.html()  取出或设置html内容

 　　.text()  取出或设置text内容

 　　.attr()  取出或设置某个属性的值

 　　.width()  取出或设置某个元素的宽度

 　　.height()  取出或设置某个元素的高度

 　　.val()  取出某个表单元素的值

　　
　　
　　需要注意的是，如果结果集包含多个元素，那么赋值的时候，将对其中所有的元素赋值；取值的时候，则是只取出第一个元素的值（.text()例外，它取出所有元素的text内容）。

　　五、元素的操作：移动

　　如果要移动选中的元素，有两种方法：一种是直接移动该元素，另一种是移动其他元素，使得目标元素达到我们想要的位置。

　　假定我们选中了一个div元素，需要把它移动到p元素后面。

　　第一种方法是使用.insertAfter()，把div元素移动p元素后面：

　　

代码:

$('div').insertAfter('p');

　　

　　第二种方法是使用.after()，把p元素加到div元素前面：

　　

代码:

$('p').after('div');

　　
　　
　　表面上看，这两种方法的效果是一样的，唯一的不同似乎只是操作视角的不同。但是实际上，它们有一个重大差别，那就是返回的元素不一样。第一种方法返回div元素，第二种方法返回p元素。你可以根据需要，选择到底使用哪一种方法。

　　使用这种模式的操作方法，一共有四对：

　　

代码:

.insertAfter()和.after()：在现存元素的外部，从后面插入元素

 　　.insertBefore()和.before()：在现存元素的外部，从前面插入元素

 　　.appendTo()和.append()：在现存元素的内部，从后面插入元素

 　　.prependTo()和.prepend()：在现存元素的内部，从前面插入元素

　　

　　六、元素的操作：复制、删除和创建

　　复制元素使用.clone()。

　　删除元素使用.remove()和.detach()。两者的区别在于，前者不保留被删除元素的事件，后者保留，有利于重新插入文档时使用。

　　清空元素内容（但是不删除该元素）使用.empty()。

　　创建新元素的方法非常简单，只要把新元素直接传入jQuery的构造函数就行了：

　

代码:

$('Hello
');
 $('

new list item');
 $('ul').append('list item
');

　　

• 　　七、工具方法
  
  　　除了对选中的元素进行操作以外，jQuery还提供一些工具方法（utility），不必选中元素，就可以直接使用。
  
  　　如果你懂得Javascript语言的继承原理，那么就能理解工具方法的实质。它是定义在jQuery构造函数上的方法，即jQuery.method()，所以可以直接使用。而那些操作元素的方法，是定义在构造函数的prototype对象上的方法，即jQuery.prototype.method()，所以必须生成实例（即选中元素）后使用。如果不理解这种区别，问题也不大，只要把工具方法理解成，是像javascript原生函数那样，可以直接使用的方法就行了。
  
  　　常用的工具方法有以下几种：
  
  代码:

  $.trim()去除字符串两端的空格。

• $.each() 遍历一个数组或对象。
• $.inArray() 返回一个值在数组中的索引位置。如果该值不在数组中，则返回-1。
• $.grep() 返回数组中符合某种标准的元素。
• $.extend() 将多个对象，合并到第一个对象。
• $.makeArray() 将对象转化为数组。
• $.type() 判断对象的类别（函数对象、日期对象、数组对象、正则对象等等）。
• $.isArray() 判断某个参数是否为数组。
• $.isEmptyObject() 判断某个对象是否为空（不含有任何属性）。
• $.isFunction() 判断某个参数是否为函数。
• $.isPlainObject() 判断某个参数是否为用"{}"或"new Object"建立的对象。
• $.support() 判断浏览器是否支持某个特性。

• 　
• 　　八、事件操作
• 
  　　jQuery可以对网页元素绑定事件。根据不同的事件，运行相应的函数。
  　　
  
  代码:

  $('p').click(function(){
   　　　　alert('Hello');
  });

  　　
• 　　目前，jQuery主要支持以下事件：
• 
  
  代码:

  　　.blur()表单元素失去焦点。

• 　　.change() 表单元素的值发生变化
• 　　.click() 鼠标单击
• 　　.dblclick() 鼠标双击
• 　　.focus() 表单元素获得焦点
• 　　.focusin() 子元素获得焦点
• 　　.focusout() 子元素失去焦点
• 　　.hover() 同时为mouseenter和mouseleave事件指定处理函数
• 　　.keydown() 按下键盘（长时间按键，只返回一个事件）
• 　　.keypress() 按下键盘（长时间按键，将返回多个事件）
• 　　.keyup() 松开键盘
• 　　.load() 元素加载完毕
• 　　.mousedown() 按下鼠标
• 　　.mouseenter() 鼠标进入（进入子元素不触发）
• 　　.mouseleave() 鼠标离开（离开子元素不触发）
• 　　.mousemove() 鼠标在元素内部移动
• 　　.mouseout() 鼠标离开（离开子元素也触发）
• 　　.mouseover() 鼠标进入（进入子元素也触发）
• 　　.mouseup() 松开鼠标
• 　　.ready() DOM加载完成
• 　　.resize() 浏览器窗口的大小发生改变
• 　　.scroll() 滚动条的位置发生变化
• 　　.select() 用户选中文本框中的内容
• 　　.submit() 用户递交表单
• 　　.toggle() 根据鼠标点击的次数，依次运行多个函数
• 　　.unload() 用户离开页面

• 　
• 　　以上这些事件在jQuery内部，都是.bind()的便捷方式。使用.bind()可以更灵活地控制事件，比如为多个事件绑定同一个函数：
  
  　
  代码:

  　$('input').bind(

• 　　　　'click change'， //同时绑定click和change事件
• 　　　　function(){
• 　　　　　　alert('Hello');
• 　　　　} 　　);

• 　　
• 　　
• 　　有时，你只想让事件运行一次，这时可以使用.one()方法。
  
  　　
  代码:

  $("p").one("click"， function(){

• 　　　　alert("Hello"); //只运行一次，以后的点击不会运行
• 　　});

• 　　
• .unbind()用来解除事件绑定。
  
  　　
  代码:

  $('p').unbind('click');

  　　
• 　　所有的事件处理函数，都可以接受一个事件对象（event object）作为参数，比如下面例子中的e：
  
  　　
  代码:

  $("p").click(function(e){
   　　　　alert(e.type); //"click"
   　　});

  　　
• 　　这个事件对象有一些很有用的属性和方法：
  
  　　
  代码:

  event.pageX事件发生时，鼠标距离网页左上角的水平距离

• 　　event.pageY 事件发生时，鼠标距离网页左上角的垂直距离
• 　　event.type 事件的类型（比如click）
• 　　event.which 按下了哪一个键
• 　　event.data 在事件对象上绑定数据，然后传入事件处理函数
• 　　event.target 事件针对的网页元素
• 　　event.preventDefault() 阻止事件的默认行为（比如点击链接，会自动打开新页面）
• 　　event.stopPropagation() 停止事件向上层元素冒泡

• 　　在事件处理函数中，可以用this关键字，返回事件针对的DOM元素：
  
  　　
  代码:

  $('a').click(function(){

• 　　　　if ($(this).attr('href').match('evil')){ //如果确认为有害链接
• 　　　　　　e.preventDefault(); //阻止打开
• 　　　　　　$(this).addClass('evil'); //加上表示有害的class 　　　　} 　　});

• 　
• 　　
• 　　有两种方法，可以自动触发一个事件。一种是直接使用事件函数，另一种是使用.trigger()或.triggerHandler()。
  
  　　
  代码:

  $('a').click();
   　　$('a').trigger('click');

  　　
• 　　
• 　　九、特殊效果
  　　jQuery允许对象呈现某些特殊效果。
  
  　　
  代码:

  $('h1').show(); //展现一个h1标题

  　　常用的特殊效果如下：
  
  　
  代码:

  　.fadeIn()淡入

• 　　.fadeOut() 淡出
• 　　.fadeTo() 调整透明度
• 　　.hide() 隐藏元素
• 　　.show() 显示元素
• 　　.slideDown() 向下展开
• 　　.slideUp() 向上卷起
• 　　.slideToggle() 依次展开或卷起某个元素
• 　　.toggle() 依次展示或隐藏某个元素

• 　　
• 　　
• 　　除了.show()和.hide()，所有其他特效的默认执行时间都是400ms（毫秒），但是你可以改变这个设置。
  
  　　
  代码:

  $('h1').fadeIn(300); // 300毫秒内淡入

• 　　$('h1').fadeOut('slow'); //缓慢地淡出
• 　　在特效结束后，可以指定执行某个函数。
• 　　$('p').fadeOut(300, function(){$(this).remove(); });

• 　　
• 　　更复杂的特效，可以用.animate()自定义。
  
  　
  代码:

  　$('div').animate(

• 　　　　{
• 　　　　　　left : "+=50"，//不断右移
• 　　　　　　opacity : 0.25 //指定透明度
• 　　　　},
• 　　　　300, // 持续时间
• 　　　　function(){ alert('done!'); }//回调函数
• 　　);

• 　
• 
  　　stop()[/URL]和.delay()用来停止或延缓特效的执行。
• 
  　　$.fx.off如果设置为true，则关闭所有网页特效。

完