jQuery用法笔记

一、jQuery的基本用法:
随着WEB2.0及ajax思想在互联网上的快速发展传播，陆续出现了一些优秀的Js框架，其中比较著名
的有Prototype、YUI、 jQuery、mootools、Bindows以及国内的JSVM框架等，
jQuery是继prototype之后的又一个优秀的Javascript框架。它是由 John Resig 于 2006 年初创建
的，它有助于简化 JavaScript 以及Ajax 编程。
它具有如下一些特点：
1. 代码简练、语义易懂、学习快速、文档丰富。
2. jQuery是一个轻量级的脚本，其代码非常小巧，最新版的JavaScript包只有20K左右。
3. jQuery支持CSS1-CSS3,以及基本的xPath。
4. jQuery是跨浏览器的，它支持的浏览器包括IE 6.0+, FF 1.5+, Safari 2.0+, Opera 9.0+。
5. 可以很容易的为jQuery扩展其他功能。
6. 能将JS代码和HTML代码完全分离，便于代码和维护和修改。
7. 插件丰富，除了jQuery本身带有的一些特效外，可以通过插件实现更多功能，如表单验证、
tab导航、拖放效果、表格排序、DataGrid，树形菜单、图像特效以及ajax上传等。
使用方法(同prototype)
在需要使用JQuery的页面中引入JQuery的js文件即可。
例如：<script type="text/javascript" src="js/jquery.js"></script>
引入之后便可在页面的任意地方使用jQuery提供的语法。

二、学习教程及参考资料
请参照《jQuery中文API手册》和http://jquery.org.cn/visual/cn/index.xml
推荐两篇不错的jquery教程：《jQuery的起点教程》和《使用 jQuery 简化 Ajax 开发》(说明：以
上文档都放在了【附件】中)

三、语法总结和注意事项
1、关于页面元素的引用
通过jquery的$()引用元素包括通过id、class、元素名以及元素的层级关系及dom或者xpath条件等
方法，且返回的对象为jquery对象（集合对象），不能直接调用dom定义的方法。
如:

$("#msg").html();-->通过ID

$("div").html(); $("input").val(); -->通过元素名(jQuery获取的是一个集合)

$("div p"); -->第一行代码得到所有<div>标签下的<p>元素。

$("div.container") -->第二行代码得到 class为container的<div>元素

$("div #msg"); -->第三行代码得到<div>标签下面id为msg的元素。

$("table a",context); -->第四行代码得到context为上下文的table里面所有的连接元素。

2、jQuery对象与dom对象的相互转换
2.1只有jquery对象才能使用jquery定义的方法。注意dom对象和jquery对象是有区别的，普通的dom对
象一般可以通过$()转换成jquery对象。
如：$(document.getElementById("msg"))则为jquery对象，可以使用jquery的方法。

2.2由于jquery对象本身是一个集合。所以如果jquery对象要转换为dom对象则必须取出其中的某一项，
一般可通过索引取出。
如：$("#msg")[0]，$("div").eq(1)[0]，$("div").get()[1]，$("td")[5]这些都是dom对象，可以
使用dom中的方法，但不能再使用Jquery的方法。

以下几种写法都是正确的：

$("#msg").html();

$("#msg")[0].innerHTML;

$("#msg").eq(0)[0].innerHTML;

$("#msg").get(0).innerHTML;

对于获取的元素集合，获取其中的某一项（通过索引指定）可以使用eq或get(n)方法或者索引号获
取，要注意，eq返回的是jquery对象，而 get(n)和索引返回的是dom元素对象。
如要获取第三个 <div>元素的内容。有如下两种方法：

$("div").eq(2).html(); //调用jquery对象的方法

$("div").get(2).innerHTML; //调用dom的方法属性

3、同一函数实现set和get
Jquery中的很多方法都是如此，主要包括如下几个：

$("#msg").html(); //返回id为msg的元素节点的html内容。

$("#msg").html("<b>new content</b>");

//将“<b>new content</b>” 作为html串写入id为msg的元素节点内容中,页面显示粗体的new content

$("#msg").text(); //返回id为msg的元素节点的文本内容。

$("#msg").text("<b>new content</b>");

//将“<b>new content</b>” 作为普通文本串写入id为msg的元素节点内容中,页面显示<b>new content</b>

$("#msg").height(); //返回id为msg的元素的高度

$("#msg").height("300"); //将id为msg的元素的高度设为300

$("#msg").width(); //返回id为msg的元素的宽度

$("#msg").width("300"); //将id为msg的元素的宽度设为300

$("input").val("); //返回表单输入框的value值

$("input").val("test"); //将表单输入框的value值设为test

$("#msg").click(); //触发id为msg的元素的单击事件

$("#msg").click(fn); //为id为msg的元素单击事件添加函数

同样blur,focus,select,submit事件都可以有这两种调用方法

4、几个有用的jQuery方法:
0)集合处理功能
对于jquery返回的集合内容无需我们自己循环遍历并对每个对象分别做处理，jquery已经为我们提
供的很方便的方法进行集合的处理。
包括两种形式：

$("p").each(function(i){this.style.color=['#f00','#0f0','#00f'][i]})

//为索引分别为0，1，2的p元素分别设定不同的字体颜色。

$("tr").each(function(i){this.style.backgroundColor=['#ccc','#fff'][i%2]})

//实现表格的隔行换色效果

$("p").click(function(){alert($(this).html())})

//为每个p元素增加了click事件，单击某个p元素则弹出其内容

1)$.browser.浏览器类型：检测浏览器类型。有效参数：safari, opera, msie, mozilla。如检测是
否ie：$.browser.isie，是ie浏览器则返回true。

2)$.each(obj, fn)：通用的迭代函数。可用于近似地迭代对象和数组（代替循环）。
如

$.each( [0,1,2], function(i, n){ alert( "Item #" + i + ": " + n ); });

等价于：

var tempArr=[0,1,2];

for(var i=0;i<tempArr.length;i++){

alert("Item #"+i+": "+tempArr[i]);

}

3)也可以处理json数据，如

$.each( { name: "John", lang: "JS" }, function(i, n){ alert( "Name: " + i + ", Value: "

+ n ); });

结果为：

Name:name, Value:John

Name:lang, Value:JS

4)$.map(array, fn)：数组映射。把一个数组中的项目(处理转换后)保存到到另一个新数组中，并返
回生成的新数组。
如：

var tempArr=$.map( [0,1,2], function(i){ return i + 4; });

tempArr内容为：[4,5,6]

var tempArr=$.map( [0,1,2], function(i){ return i > 0 ? i + 1 : null; });

tempArr内容为：[2,3]

5)$.merge(arr1,arr2):合并两个数组并删除其中重复的项目。
如：

$.merge( [0,1,2], [2,3,4] ) //返回[0,1,2,3,4]

6)$.trim(str)：删除字符串两端的空白字符。
如：

$.trim(" hello, how are you? "); //返回"hello,how are you? "

5、操作元素的样式
主要包括以下几种方式：

$("#msg").css("background"); //返回元素的背景颜色

$("#msg").css("background","#ccc") //设定元素背景为灰色

$("#msg").height(300); $("#msg").width("200"); //设定宽高

$("#msg").css({ color: "red", background: "blue" });//以名值对的形式设定样式

$("#msg").addClass("select"); //为元素增加名称为select的class

$("#msg").removeClass("select"); //删除元素名称为select的class

$("#msg").toggleClass("select"); //如果存在（不存在）就删除（添加）名称为select的class

6、完善的事件处理功能
Jquery已经为我们提供了各种事件处理方法，我们无需在html元素上直接写事件，而可以直接为通
过jquery获取的对象添加事件。
如：

$("#msg").click(function(){alert("good")}) //为元素添加了单击事件

$("p").click(function(i){this.style.color=['#f00','#0f0','#00f'][i]}) //为三个不同的p

元素单击事件分别设定不同的处理
jQuery中几个自定义的事件：
（1）hover(fn1,fn2)：当鼠标移动到一个匹配的元素上面时，会触发指定的第一个函数。当鼠标移
出这个元素时，会触发指定的第二个函数。

//当鼠标放在表格的某行上时将class置为over，离开时置为out。

$("tr").hover(function(){

$(this).addClass("over");

},

function(){

$(this).addClass("out");

});

（2）ready(fn):当DOM载入就绪可以查询及操纵时绑定一个要执行的函数。

$(document).ready(function(){alert("Load Success")})

//页面加载完毕提示“Load Success”,不同于onload事件，onload需要页面内容加载完毕（图片等

），而ready只要页面html代码下载完毕即触发。与$(fn)等价

（3）toggle(evenFn,oddFn): 每次点击时切换要调用的函数。如果点击了一个匹配的元素，则触发
指定的第一个函数，当再次点击同一元素时，则触发指定的第二个函数。随后的每次点击都重复对
这两个函数的轮番调用。

//每次点击时轮换添加和删除名为selected的class。

$("p").toggle(function(){

$(this).addClass("selected");

},function(){

$(this).removeClass("selected");

});

（4）trigger(eventtype): 在每一个匹配的元素上触发某类事件。
例如：

$("p").trigger("click"); //触发所有p元素的click事件

（5）bind(eventtype,fn)，unbind(eventtype): 事件的绑定与反绑定
从每一个匹配的元素中（添加）删除绑定的事件。
例如：

$("p").bind("click", function(){alert($(this).text());});

//为每个p元素添加单击事件

$("p").unbind(); //删除所有p元素上的所有事件

$("p").unbind("click") //删除所有p元素上的单击事件

7、扩展我们需要的功能

$.extend({

min: function(a, b){return a < b?a:b; },

max: function(a, b){return a > b?a:b; }

}); //为jquery扩展了min,max两个方法

使用扩展的方法（通过“$.方法名”调用）：

alert("a=10,b=20,max="+$.max(10,20)+",min="+$.min(10,20));

----------->ajax编程,请见其它笔记.

8、渐入淡出

$("#msg").fadeIn("fast");

$("#msg").fadeOut("slow");

没错，上面两行代码已经分别实现了一个id为Msg的jquery对象的渐入和淡出。做一个像Gmail一样
的动态加载通知条，用jquery就那么简单。两个函数接受的参数除了快慢等，还可以接收整型，作
为渐入或淡出的完成时间，单位为MS。

9.plugin这也是一个插件的时代。
jquery插件给我的感觉清一色的清洁，简单。如Jtip，要使用它的功能，只需要在你的元素的class
上加上Jtip,并引入jtip.js及其样式即可以了。其他事情插件全包。我喜欢jquery的一个重要原因
是发现她已经有了很多很好，很精彩的插件。

10.解决自定义方法或其他类库与jQuery的冲突
很多时候我们自己定义了$(id)方法来获取一个元素，或者其他的一些js类库如prototype也都定义
了$方法，如果同时把这些内容放在一起就会引起变量方法定义冲突，Jquery对此专门提供了方法用
于解决此问题。
使用jquery中的jQuery.noConflict();方法即可把变量$的控制权让渡给第一个实现它的那个库或之
前自定义的$方法。之后应用 Jquery的时候只要将所有的$换成jQuery即可，如原来引用对象方法
$("#msg")改为jQuery("#msg")。
如：

jQuery.noConflict();

// 开始使用jQuery

jQuery("div p").hide();

// 使用其他库的 $()

$("content").style.display = 'none';

(二)基于jQuery的Ajax用法:
基于JQuery框架的AJAX
在JQuery中，AJAX有三种实现方式：$.ajax(),$.post,$.get()。
(1)使用$.post实现Ajax向页面发送数据 ($.get()的用法与此相似)

$.post(’save.cgi’, {text: ‘my string’,number: 23}, function() {

alert(’Your data has been saved.’);

});

(2)如果您确实需要编写一些复杂的 Ajax 脚本，那么需要用到 $.ajax() 函数。您可以指定 xml、
script、html 或者 json，jQuery 将自动为回调函数准备合适的结果，这样您便可以立即使用该结果。还可以指定 beforeSend、error、success 或者 complete 回调函数，向用户提供更多有关Ajax 体验的反馈。
$.ajax() 使 Ajax 由复杂变简单

$.ajax({

url: ‘document.xml’,

type: ‘GET’,

dataType: ‘xml’,

timeout: 1000,

error: function(){

alert(’Error loading XML document’);

},

success: function(xml){

// do something with xml

}

});

另一实例:
XHTML(主要):
代码: 复制内容到剪贴板

<div id="result" style="backgroundrange;border:1px solid

width:300px;height:400px;"></div>

<form id="formtest" action="" method="post">

<p><span>输入姓名:</span><input type="text" name="username" id="input1" /></p>

<p><span>输入年龄:</span><input type="text" name="age" id="input2" /></p>

<p><span>输入性别:</span><input type="text" name="sex" id="input3" /></p>

<p><span>输入工作:</span><input type="text" name="job" id="input4" /></p>

</form>

<button id="send_ajax">提交</button>

<button id="test_post">OST提交</button>

<button id="test_get">GET提交</button>

JS:
1、引入jquery框架：
代码: 复制内容到剪贴板

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

2、构建AJAX，JQUERY的好处是不需要在XHTML中使用JS代码来触发事件了，可以直接封装在JS
文件中：
代码: 复制内容到剪贴板

<script type="text/javascript">

//$.ajax()方式

$(document).ready(function (){

$('#send_ajax').click(function (){ //直接把onclick事件写在了JS中，而不需要混在

XHTML中了

var params=$('input').serialize(); //序列化表单的值，与prototype中的

form.serialize()相同

$.ajax({

url ：'ajax_test.php', //后台处理程序

type:'post', //数据发送方式

dataType:'json', //接受数据格式

data:params, //要传递的数据

success:update_page //回传函数(这里是函数名)

});

});

});

function update_page (json) { //回传函数实体，参数为XMLhttpRequest.responseText

var str="姓名:"+json.username+"";

str+="年龄:"+json.age+"";

str+="性别:"+json.sex+"";

str+="工作:"+json.job;

$("#result").html(str);

}

(三)Struts2 + jQuery 的简单例子使用
JSON插件提供了一种名为json的ResultType，一旦为某个Action指定了一个类型为json的Result，
则该Result无需映射到任何视图资源。
因为,JSON插件允许我们在JavaScript中异步调用Action，且负责将Action里的状态信息序列化成
JSON格式的数据，并将该数据返回给客户端页面的JavaScript 。这样就可以完成Ajax交互。
1、将struts2的json插件加入web工程的lib，jsonplugin的下载地址：
http://code.google.com/p/jsonplugin/downloads/list

2、struts.xml添加专为ajax使用的package

<package name="ajax" extends="json-default">

<action name="ajaxRequest" class="org.david.struts2.HelloWorld">

<result type="json"></result>

</action>

</package>

3、在页面中引入 jquery的js文件库

<SCRIPT type="text/javascript" src="js/jquery-1.2.6.min.js"></script>

<SCRIPT type="text/javascript">

function clickButton()

{

var url = 'ajaxRequest.action';

var params = {

name:$('#name').attr('value'),

contactEmail:$('#contactEmail').attr('value'),

subject:$('#subject').attr('value'),

content:$('#content').attr('value')

}; //通过id获得输入值

jQuery.post(url, params, callbackFun, 'json');

}

/url：响应aciton；params：传入参数；callbackFun：响应完成后的回调函数；

function callbackFun(data)

{

alert("SUCCESS");

}

</SCRIPT>

4、action逻辑与普通的ation写法无大区别。
JSON将Action里的状态信息序列化成JSON格式的数据