jQuery用法札记

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

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

1. $("#msg").html();-->通过ID ?? $("div").html();?$("input").val();?-->通过元素名(jQuery获取的是一个集合) ??
2. $("div?p");?????????????-->第一行代码得到所有<div>标签下的<p>元素。 ?? $("div.container")??????-->第二行代码得到?class为container的<div>元素??? ??
3. $("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的方法。

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

1. $("#msg").html(); ?? $("#msg")[0].innerHTML; ??
2. $("#msg").eq(0)[0].innerHTML; ?? $("#msg").get(0).innerHTML;??

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

1. $("div").eq(2).html();??????????????//调用jquery对象的方法 ?? $("div").get(2).innerHTML;???????//调用dom的方法属性??

?

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

1. $("#msg").html();??????????????//返回id为msg的元素节点的html内容。 ?? $("#msg").html("<b>new?content</b>");?????? ??
2. //将“<b>new?content</b>”?作为html串写入id为msg的元素节点内容中,页面显示粗体的new?content ?? $("#msg").text();??????????????//返回id为msg的元素节点的文本内容。 ??
3. $("#msg").text("<b>new?content</b>");?????? ?? //将“<b>new?content</b>”?作为普通文本串写入id为msg的元素节点内容中,页面显示<b>new?content</b> ??
4. $("#msg").height();??????????????//返回id为msg的元素的高度 ?? $("#msg").height("300");???????//将id为msg的元素的高度设为300 ??
5. $("#msg").width();??????????????//返回id为msg的元素的宽度 ?? $("#msg").width("300");???????//将id为msg的元素的宽度设为300 ??
6. $("input").val(");???????//返回表单输入框的value值 ?? $("input").val("test");???????//将表单输入框的value值设为test ??
7. $("#msg").click();???????//触发id为msg的元素的单击事件 ?? $("#msg").click(fn);???????//为id为msg的元素单击事件添加函数??

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

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

1. $("p").each(function(i){this.style.color=['#f00','#0f0','#00f'][i]})?????? ?? //为索引分别为0，1，2的p元素分别设定不同的字体颜色。 ??
2. $("tr").each(function(i){this.style.backgroundColor=['#ccc','#fff'][i%2]})?????? ?? //实现表格的隔行换色效果 ??
3. $("p").click(function(){alert($(this).html())})????????????? ?? //为每个p元素增加了click事件，单击某个p元素则弹出其内容??

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

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

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

等价于：

1. var?tempArr=[0,1,2]; ?? for(var?i=0;i<tempArr.length;i++){ ??
2. ???????alert("Item?#"+i+":?"+tempArr[i]); ?? }??

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

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

结果为：

1. Name:name,?Value:John ?? Name:lang,?Value:JS??

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

1. var?tempArr=$.map(?[0,1,2],?function(i){?return?i?+?4;?}); ?? tempArr内容为：[4,5,6] ??
2. var?tempArr=$.map(?[0,1,2],?function(i){?return?i?>?0???i?+?1?:?null;?}); ?? tempArr内容为：[2,3]??

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

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

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

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

?

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

1. $("#msg").css("background");??????????????//返回元素的背景颜色 ?? $("#msg").css("background","#ccc")???????//设定元素背景为灰色 ??
2. $("#msg").height(300);?$("#msg").width("200");???????//设定宽高 ?? $("#msg").css({?color:?"red",?background:?"blue"?});//以名值对的形式设定样式 ??
3. $("#msg").addClass("select");???????//为元素增加名称为select的class ?? $("#msg").removeClass("select");???????//删除元素名称为select的class ??
4. $("#msg").toggleClass("select");???????//如果存在（不存在）就删除（添加）名称为select的class??

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

1. $("#msg").click(function(){alert("good")})????//为元素添加了单击事件 ?? $("p").click(function(i){this.style.color=['#f00','#0f0','#00f'][i]})???//为三个不同的p??

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

1. //当鼠标放在表格的某行上时将class置为over，离开时置为out。 ?? $("tr").hover(function(){ ??
2. $(this).addClass("over"); ?? }, ??
3. ???????function(){ ?? ???????$(this).addClass("out"); ??
4. });??

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

1. $(document).ready(function(){alert("Load?Success")}) ?? //页面加载完毕提示“Load?Success”,不同于onload事件，onload需要页面内容加载完毕（图片等 ??
2. ），而ready只要页面html代码下载完毕即触发。与$(fn)等价??

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

1. //每次点击时轮换添加和删除名为selected的class。 ?? $("p").toggle(function(){ ??
2. ???????$(this).addClass("selected");?? ?? },function(){ ??
3. ???????$(this).removeClass("selected"); ?? });??

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

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

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

1. $("p").bind("click",?function(){alert($(this).text());});? ?? //为每个p元素添加单击事件 ??
2. $("p").unbind();???????//删除所有p元素上的所有事件 ?? $("p").unbind("click")???????//删除所有p元素上的单击事件??

7、扩展我们需要的功能

1. $.extend({ ?? ???????min:?function(a,?b){return?a?<?b?a:b;?}, ??
2. ???????max:?function(a,?b){return?a?>?b?a:b;?} ?? });???????//为jquery扩展了min,max两个方法??

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

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

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

8、渐入淡出

1. $("#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")。
如：

1. jQuery.noConflict(); ?? //?开始使用jQuery ??
2. jQuery("div???p").hide(); ?? //?使用其他库的?$() ??
3. $("content").style.display?=?'none';??

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

1. $.post(’save.cgi’,?{text:?‘my?string’,number:?23},?function()?{ ?? alert(’Your?data?has?been?saved.’); ??
2. });??

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

1. $.ajax({ ?? url:?‘document.xml’, ??
2. type:?‘GET’, ?? dataType:?‘xml’, ??
3. timeout:?1000, ?? error:?function(){ ??
4. alert(’Error?loading?XML?document’); ?? }, ??
5. success:?function(xml){ ?? //?do?something?with?xml ??
6. } ?? });??

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

1. <div?id="result"?style="backgroundrange;border:1px?solid? ?? width:300px;height:400px;"></div>??
2. <form?id="formtest"?action=""?method="post">?? <p><span>输入姓名:</span><input?type="text"?name="username"?id="input1"?/></p>??
3. <p><span>输入年龄:</span><input?type="text"?name="age"?id="input2"?/></p>?? <p><span>输入性别:</span><input?type="text"?name="sex"?id="input3"?/></p>??
4. <p><span>输入工作:</span><input?type="text"?name="job"?id="input4"?/></p>?? </form>??
5. <button?id="send_ajax">提交</button>?? <button?id="test_post">OST提交</button>??
6. <button?id="test_get">GET提交</button>??

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

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

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

1. ????<script?type="text/javascript"> ?? ????//$.ajax()方式 ??
2. ????$(document).ready(function?(){ ?? ???????$('#send_ajax').click(function?(){?//直接把onclick事件写在了JS中，而不需要混在 ??
3. XHTML中了 ?? ??????????????var?params=$('input').serialize();?//序列化表单的值，与prototype中的 ??
4. form.serialize()相同 ?? ?????????????$.ajax({ ??
5. ???????????????????url?：'ajax_test.php',??//后台处理程序 ?? ???????????????????type:'post',????//数据发送方式 ??
6. ?????????????????dataType:'json',??//接受数据格式 ?? ???????????????????data:params,??//要传递的数据 ??
7. ???????????????????success:update_page??//回传函数(这里是函数名) ?? ???????????????????}); ??
8. ????????????}); ?? ????}); ??
9. ????function?update_page?(json)?{?//回传函数实体，参数为XMLhttpRequest.responseText ?? ???????????var?str="姓名:"+json.username+""; ??
10. ???????????str+="年龄:"+json.age+""; ?? ???????????str+="性别:"+json.sex+""; ??
11. ???????????str+="工作:"+json.job; ?? ???????????$("#result").html(str); ??
12. ????} ??

?
(三)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??

1. <package?name="ajax"?extends="json-default">?? ????????<action?name="ajaxRequest"??class="org.david.struts2.HelloWorld">??
2. ????????????<result?type="json"></result>?? ????????</action>??
3. </package>???????? ??

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

1. <SCRIPT?type="text/javascript"?src="js/jquery-1.2.6.min.js"></script> ?? <SCRIPT?type="text/javascript"> ??
2. ???????????function?clickButton() ?? ???????????{???? ??
3. ???????????????var?url?=?'ajaxRequest.action'; ?? ???????????????var?params?=?{ ??
4. ??????????????????????????name:$('#name').attr('value'), ?? ??????????????????????????contactEmail:$('#contactEmail').attr('value'), ??
5. ??????????????????????????subject:$('#subject').attr('value'), ?? ??????????????????????????content:$('#content').attr('value')???????????????? ??
6. ??????????????????????};?//通过id获得输入值 ?? ????????????????jQuery.post(url,?params,?callbackFun,?'json'); ??
7. ??????????????}? ?? /url：响应aciton；params：传入参数；callbackFun：响应完成后的回调函数； ??
8. ???????????function?callbackFun(data) ?? ???????????{ ??
9. ????????????????alert("SUCCESS"); ?? ???????????} ??
10. ????</SCRIPT>??

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

?

?

?

来自：http://ajava.org/course/ajax/14528.html