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格式的数据

评论

1 楼 ksegg 2010-09-21  

(说明：以 上文档都放在了【附件】中)
附件呢？