第一章 入门
基本功能:访问和操作 dom 元素,控制页面样式,对页面的事件处理,与ajax完美结合,有丰富的插件。
在jQuery库中,通过本身自带的方法获取页面元素的对象,称为jQuery对象
第二章 选择器
基本选择器是最简单的选择器也是最常用的选择器,它通过元素的id,class和标签来查找dom元素。
1. 基础选择器Basics
名称说明举例
#id根据元素Id选择(返回的是单个元素)$("divId") 选择ID为divId的元素
element根据元素的名称选择,(返回的是集合元素)$("a") 选择所有元素
.class根据元素的css类选择(返回的是集合元素)$(".bgRed") 选择所用CSS类为bgRed的元素
*选择所有元素(返回的是集合元素)$("*")选择页面所有元素
selector2,
selectorN可以将几个选择器用","分隔开然后再拼成一个选择器字符串.会同时选中这几个选择器匹配的内容.
(返回的是集合元素)$("#divId, a, .bgRed")
2.层次选择器Hierarchy
名称说明举例
ancestor descendant使用"form input"的形式选中form中的所有input元素.即ancestor(祖先)为from, descendant(子孙)为input.$(".bgRed div") 选择CSS类为bgRed的元素中的所有
元素.
parent > child选择parent的直接子节点child. child必须包含在parent中并且父类是parent元素.$(".myList>li") 选择CSS类为myList元素中的直接子节点
对象.
prev + nextprev和next是两个同级别的元素. 选中在prev元素后面的next元素.$("#hibiscus+img")选在id为hibiscus元素后面的img对象.
prev ~ siblings选择prev后面的根据siblings过滤的元素
注:siblings是过滤器$("#someDiv~[title]")选择id为someDiv的对象后面所有带有title属性的元素
2.层次选择器Hierarchy
名称说明举例
ancestor descendant使用"form input"的形式选中form中的所有input元素.即ancestor(祖先)为from, descendant(子孙)为input.$(".bgRed div") 选择CSS类为bgRed的元素中的所有
元素.
parent > child选择parent的直接子节点child. child必须包含在parent中并且父类是parent元素.$(".myList>li") 选择CSS类为myList元素中的直接子节点
对象.
prev + nextprev和next是两个同级别的元素. 选中在prev元素后面的next元素.$("#hibiscus+img")选在id为hibiscus元素后面的img对象.
prev ~ siblings选择prev后面的根据siblings过滤的元素
注:siblings是过滤器$("#someDiv~[title]")选择id为someDiv的对象后面所有带有title属性的元素
过滤选择器:主要是通过特定的过滤规则来筛选出所需的dom 元素,过滤规则则与 css 中的为类选择器语法相同。
3.基本过滤器Basic Filters
名称
说明举例
:first匹配找到的第一个元素查找表格的第一行:$("tr:first")
:last匹配找到的最后一个元素查找表格的最后一行:$("tr:last")
:not(selector)去除所有与给定选择器匹配的元素查找所有未选中的 input 元素: $("input:not(:checked)")
:even匹配所有索引值为偶数的元素,从 0 开始计数查找表格的1、3、5...行:$("tr:even")
:odd匹配所有索引值为奇数的元素,从 0 开始计数查找表格的2、4、6行:$("tr:odd")
:eq(index)匹配一个给定索引值的元素
注:index从 0 开始计数查找第二行:$("tr:eq(1)")
:gt(index)匹配所有大于给定索引值的元素
注:index从 0 开始计数查找第二第三行,即索引值是1和2,也就是比0大:$("tr:gt(0)")
:lt(index)选择结果集中索引小于 N 的 elements
注:index从 0 开始计数查找第一第二行,即索引值是0和1,也就是比2小:$("tr:lt(2)")
:header选择所有h1,h2,h3一类的header标签.给页面内所有标题加上背景色: $(":header").css("background", "#EEE");
:animated匹配所有正在执行动画效果的元素只有对不在执行动画效果的元素执行一个动画特效:
$("#run").click(function(){
$("div:not(:animated)").animate({ left: "+=20" }, 1000);
});
内容过滤器 Content Filters
名称说明举例
:contains(text)匹配包含给定文本的元素查找所有包含 "John" 的 div 元素:$("div:contains('John')")
:empty匹配所有不包含子元素或者文本的空元素查找所有不包含子元素或者文本的空元素:$("td:empty")
:has(selector)匹配含有选择器所匹配的元素的元素给所有包含 p 元素的 div 元素添加一个 text 类: $("div:has(p)").addClass("test");
:parent匹配含有子元素或者文本的元素查找所有含有子元素或者文本的 td 元素:$("td:parent")
可见性过滤器Visibility Filters
名称说明举例
匹配所有的不可见元素
注:在1.3.2版本中, hidden匹配自身或者父类在文档中不占用空间的元素.如果使用CSS visibility属性让其不显示但是占位,则不输入hidden.查找所有不可见的 tr 元素:$("tr:hidden")
:visible匹配所有的可见元素查找所有可见的 tr 元素:$("tr:visible")
属性过滤器Attribute Filters
名称说明举例
[attribute]匹配包含给定属性的元素查找所有含有 id 属性的 div 元素:
$("div[id]")
[attribute=value]匹配给定的属性是某个特定值的元素查找所有 name 属性是 newsletter 的 input 元素:
$("input[name='newsletter']").attr("checked", true);
[attribute!=value]匹配给定的属性是不包含某个特定值的元素查找所有 name 属性不是 newsletter 的 input 元素:
$("input[name!='newsletter']").attr("checked", true);
[attribute^=value]匹配给定的属性是以某些值开始的元素$("input[name^='news']")
[attribute$=value]匹配给定的属性是以某些值结尾的元素查找所有 name 以 'letter' 结尾的 input 元素:
$("input[name$='letter']")
[attribute*=value]匹配给定的属性是以包含某些值的元素
查找所有 name 包含 'man' 的 input 元素:
$("input[name*='man']")
[attributeFilter1][attributeFilter2][attributeFilterN]复合属性选择器,需要同时满足多个条件时使用。找到所有含有 id 属性,并且它的 name 属性是以 man 结尾的:
$("input[id][name$='man']")
7.子元素过滤器Child Filters
名称说明举例
:nth-child(index/even/odd/equation)匹配其父元素下的第N个子或奇偶元素
':eq(index)' 只匹配一个元素,而这个将为每一个父元素匹配子元素。:nth-child从1开始的,而:eq()是从0算起的!
可以使用:
nth-child(even)
:nth-child(odd)
:nth-child(3n)
:nth-child(2)
:nth-child(3n+1)
:nth-child(3n+2)在每个 ul 查找第 2 个li:
$("ul li:nth-child(2)")
:first-child匹配第一个子元素
':first' 只匹配一个元素,而此选择符将为每个父元素匹配一个子元素在每个 ul 中查找第一个 li:
$("ul li:first-child")
:last-child匹配最后一个子元素
':last'只匹配一个元素,而此选择符将为每个父元素匹配一个子元素在每个 ul 中查找最后一个 li:
$("ul li:last-child")
:only-child如果某个元素是父元素中唯一的子元素,那将会被匹配
如果父元素中含有其他元素,那将不会被匹配。在 ul 中查找是唯一子元素的 li:
$("ul li:only-child")
表单过滤器Form Filters
名称说明解释
:enabled匹配所有可用元素
查找所有可用的input元素:
$("input:enabled")
:disabled匹配所有不可用元素查找所有不可用的input元素:
$("input:disabled")
:checked匹配所有选中的被选中元素(复选框、单选框等,不包括select中的option)查找所有选中的复选框元素:
$("input:checked")
:selected匹配所有选中的option元素查找所有选中的选项元素:
$("select option:selected")
表单选择器:
表单选择器 Forms
名称说明解释
:input匹配所有 input, textarea, select 和 button 元素查找所有的input元素:
$(":input")
:text匹配所有的文本框查找所有文本框:
$(":text")
:password匹配所有密码框查找所有密码框:
$(":password")
:radio匹配所有单选按钮查找所有单选按钮
:checkbox匹配所有复选框查找所有复选框:
$(":checkbox")
:submit匹配所有提交按钮查找所有提交按钮:
$(":submit")
:image匹配所有图像域
匹配所有图像域:
$(":image")
:reset匹配所有重置按钮查找所有重置按钮:
$(":reset")
:button匹配所有按钮查找所有按钮:
$(":button")
:file匹配所有文件域查找所有文件域:
$(":file")
第三章 DOM操作
1.获取元素的属性。 attr(); 也可以用这个方法来设置元素属性。
attr(key,value)方法设置元素的属性 key 表示属性,value 表示属性值
attr()方法还可以绑定一个function()函数,通过该函数返回的值作为元素的属性值,其语法格式如下所示:
2.删除元素的属性使用removeAttr() 格式。
3.获取和设置元素内容
操作元素内容的方法包括html()和text() 。
html()方法仅支持XHTML的文档,不能用于XML文档,而text()既支持HTML文档,也支持XML文档。
在页面中,用html()和text()方法获取div标记中的内容,将内容分别作为html(val)和text(val)的参数,分别设置元素的内容,并将结果显示在页面中。
4.获取和设置元素值 val()
其中,如果不带参数val,是获取某元素的值;反之,则是将参数val的值赋给某元素,即设置元素的值。该方法常用于表单中获取或设置对象的值。
5. 直接设置元素样式值css(name,value) 格式:
6 增加元素CSS类别通过addClass()方法增加元素类别的名称,其语法格式如下
切换元素CSS类别通过toggleClass()方法切换不同的元素类别,其语法格式如下:
删除元素CSS类别与增加类别的addClass()方法相对应,removeClass()方法则用于删除类别,其语法格式如下
页面元素操作:
创建节点元素函数$()用于动态创建页面元素,其语法格式如下:
内部插入节点append() 方法: 在元素的内如插入元素
append(function(index,html))
该方法是jQuery 1.4中新增的,其功能是将一个function函数作为append方法的参数,该函数的功能必须返回一个字符串,作为append方法插入的内容,其中index参数为对象在这个集合中的索引值,html参数为该对象原有的html值。
appendTo(content)
该方法用于将一个元素插入另一个指定的元素内容中
外部插入节点
after(function)方法也是jQuery 1.4中新增的方法,其function()参数将返回插入元素外部后面部分的内容。示例3-13演示了调用after()方法,以function的返回值为参数,在指定元素的外部插入一个节点的过程。
复制元素节点
cklone ()其功能为复制匹配的DOM元素并且选中复制成功的元素。该方法仅是复制元素本身,被复制后的新元素不具有任何元素行为。如果需要在复制时将该元素的全部行为也进行复制,可以通过方法clone(true)实现,其格式为: clone(true)
替换元素节点replaceWith()和replaceAll()这两种方法
replaceWith()该方法的功能是将所有选择的元素替换成指定的HTML或DOM元素,其中参数content为被所选择元素替换的内容。
replaceAll()该方法的功能是将所有选择的元素替换成指定selector的元素,其中参数selector为需要被替换的元素。
包裹元素节点
不仅可以通过方法替换元素节点,还可以根据需求包裹某个指定的节点,对节点的包裹也是DOM对象操作中很重要的一项wrap(html)与wrapInner(html)方法比较常用
遍历元素
在传统的JavaScript中,先获取元素的总长度,然后以for循环语句递减总长度,访问其中的某个元素,代码相对复杂;而在jQuery中,可以直接使用each()方法实现元素的遍历。其语法格式如下:
$("button").click(function(){
$("li").each(function(){
alert($(this).text())
});
});
删除页面元素remove() 删除节点元素empty() 清空所选的元素或是后代元素。
查找页面元素 find() 方法find() 方法获得当前元素集合中每个元素的后代,通过选择器、jQuery 对象或元素来筛选。
.find(selector) 选择器
var item1 = $('li.item-1')[0];
$('li.item-ii').find( item1 ).css('background-color', 'red'); 还可以通过传递一个元素进行查找
第4章 jQuery中的事件与应用
在浏览器里,事件的触发有个冒泡现象,body下有个div ,div下有个按钮, 同时监听三个元素的点击事件,然后只是去点击那个按钮,div 和body的点击事件也会被触发,这就是事件冒泡。可以通过stopPropagation()方法可以阻止冒泡过程的发生 event.stopPropagation()
使用bind()方法绑定事件bind()功能是为每个选择元素的事件绑定处理函数,其语法格式如下:
其中参数type为一个或多个类型的字符串,如"click"或"change",也可以自定义类型;可以被参数type调用的类型包括blur、focus、load、resize、scroll、unload、click、dblclick、mousedown、mouseup、mousemove、mouseover、mouseout、mouseenter、mouseleave、change、select、submit、keydown、keypress、keyup、error。
参数data是作为event.data属性值传递给事件对象的额外数据对象。
参数fn是绑定到每个选择元素的事件中的处理函数。
切换事件
在jQuery中,有两个方法用于事件的切换,一个是方法hover(),另一个是方法toggle()。所谓切换事件,即有两个以上的事件绑定于一个元素,在元素的行为动作间进行切换。如一个超级链接标记<a>,若想实现当鼠标悬停时触发一个事件,鼠标移出时又触发另一个事件,就可以调用jQuery中的hover()方法轻松实现。
toggle()方法
在toggle()方法中,可以依次调用N个指定的函数,直到最后一个函数,然后重复对这些函数轮番调用。
依次调用的意思是:每次触发的时候,调用函数调用一次,顺序是根据一开始排好的顺序
移除事件unbind()的功能是移除元素绑定的事件,其调用的语法格式如下:
one()方法one()方法功能是为所选的元素绑定一个仅触发一次的处理函数,其调用的语法格式为:
trigger()方法在前端页面开发中,有时希望页面在DOM加载完毕后,自动执行一些人性化的操作,如:文本框中的内容处于全部被选中状态,某个按钮处于焦点中。利用传统的JavaScript语言需要编写复杂的代码才可实现上述功能;而在jQuery中,仅需要调用一个trigger()方法就可以轻松实现。
trigger()方法的功能是在所选择的元素上触发指定类型的事件。其调用的语法格式为:
$.ajax()方法
通过 HTTP 请求加载远程数据。
jQuery 底层 AJAX 实现。简单易用的高层实现见 $.get, $.post 等。$.ajax() 返回其创建的 XMLHttpRequest 对象。大多数情况下你无需直接操作该函数,除非你需要操作不常用的选项,以获得更多的灵活性。
最简单的情况下,$.ajax()可以不带任何参数直接使用。
注意,所有的选项都可以通过$.ajaxSetup()函数来全局设置。
回调函数
如果要处理$.ajax()得到的数据,则需要使用回调函数。beforeSend、error、dataFilter、success、complete。
beforeSend 在发送请求之前调用,并且传入一个XMLHttpRequest作为参数。
error 在请求出错时调用。传入XMLHttpRequest对象,描述错误类型的字符串以及一个异常对象(如果有的话)
dataFilter 在请求成功之后调用。传入返回的数据以及"dataType"参数的值。并且必须返回新的数据(可能是处理过的)传递给success回调函数。
success 当请求之后调用。传入返回后的数据,以及包含成功代码的字符串。
complete 当请求完成之后调用这个函数,无论成功或失败。传入XMLHttpRequest对象,以及一个包含成功或错误代码的字符串。
数据类型
$.ajax()函数依赖服务器提供的信息来处理返回的数据。如果服务器报告说返回的数据是XML,那么返回的结果就可以用普通的XML方法或者jQuery的选择器来遍历。如果见得到其他类型,比如HTML,则数据就以文本形式来对待。
通过dataType选项还可以指定其他不同数据处理方式。除了单纯的XML,还可以指定 html、json、jsonp、script或者text。
其中,text和xml类型返回的数据不会经过处理。数据仅仅简单的将XMLHttpRequest的responseText或responseHTML属性传递给success回调函数,
'''注意''',我们必须确保网页服务器报告的MIME类型与我们选择的dataType所匹配。比如说,XML的话,服务器端就必须声明 text/xml 或者 application/xml 来获得一致的结果。
如果指定为html类型,任何内嵌的JavaScript都会在HTML作为一个字符串返回之前执行。类似的,指定script类型的话,也会先执行服务器端生成JavaScript,然后再把脚本作为一个文本数据返回。
如果指定为json类型,则会把获取到的数据作为一个JavaScript对象来解析,并且把构建好的对象作为结果返回。为了实现这个目的,他首先尝试使用JSON.parse()。如果浏览器不支持,则使用一个函数来构建。JSON数据是一种能很方便通过JavaScript解析的结构化数据。如果获取的数据文件存放在远程服务器上(域名不同,也就是跨域获取数据),则需要使用jsonp类型。使用这种类型的话,会创建一个查询字符串参数 callback=? ,这个参数会加在请求的URL后面。服务器端应当在JSON数据前加上回调函数名,以便完成一个有效的JSONP请求。如果要指定回调函数的参数名来取代默认的callback,可以通过设置$.ajax()的jsonp参数。
注意,JSONP是JSON格式的扩展。他要求一些服务器端的代码来检测并处理查询字符串参数。更多信息可以参阅最初的文章。
如果指定了script或者jsonp类型,那么当从服务器接收到数据时,实际上是用了<script>标签而不是XMLHttpRequest对象。这种情况下,$.ajax()不再返回一个XMLHttpRequest对象,并且也不会传递事件处理函数,比如beforeSend。
发送数据到服务器
默认情况下,Ajax请求使用GET方法。如果要使用POST方法,可以设定type参数值。这个选项也会影响data选项中的内容如何发送到服务器。
data选项既可以包含一个查询字符串,比如 key1=value1&key2=value2 ,也可以是一个映射,比如 {key1: 'value1', key2: 'value2'} 。如果使用了后者的形式,则数据再发送器会被转换成查询字符串。这个处理过程也可以通过设置processData选项为false来回避。如果我们希望发送一个XML对象给服务器时,这种处理可能并不合适。并且在这种情况下,我们也应当改变contentType选项的值,用其他合适的MIME类型来取代默认的 application/x-www-form-urlencoded 。
高级选项
global选项用于阻止响应注册的回调函数,比如.ajaxSend,或者ajaxError,以及类似的方法。这在有些时候很有用,比如发送的请求非常频繁且简短的时候,就可以在ajaxSend里禁用这个。更多关于这些方法的详细信息,请参阅下面的内容。
如果服务器需要HTTP认证,可以使用用户名和密码可以通过username和password选项来设置。
Ajax请求是限时的,所以错误警告被捕获并处理后,可以用来提升用户体验。请求超时这个参数通常就保留其默认值,要不就通过jQuery.ajaxSetup来全局设定,很少为特定的请求重新设置timeout选项。
默认情况下,请求总会被发出去,但浏览器有可能从他的缓存中调取数据。要禁止使用缓存的结果,可以设置cache参数为false。如果希望判断数据自从上次请求后没有更改过就报告出错的话,可以设置ifModified为true。
scriptCharset允许给<script>标签的请求设定一个特定的字符集,用于script或者jsonp类似的数据。当脚本和页面字符集不同时,这特别好用。
Ajax的第一个字母是asynchronous的开头字母,这意味着所有的操作都是并行的,完成的顺序没有前后关系。$.ajax()的async参数总是设置成true,这标志着在请求开始后,其他代码依然能够执行。强烈不建议把这个选项设置成false,这意味着所有的请求都不再是异步的了,这也会导致浏览器被锁死。
$.ajax函数返回他创建的XMLHttpRequest对象。通常jQuery只在内部处理并创建这个对象,但用户也可以通过xhr选项来传递一个自己创建的xhr对象。返回的对象通常已经被丢弃了,但依然提供一个底层接口来观察和操控请求。比如说,调用对象上的.abort()可以在请求完成前挂起请求。
参数
url,[settings]ObjectV1.5
url:一个用来包含发送请求的URL字符串。
settings:AJAX 请求设置。所有选项都是可选的。
V1.0settings:选项
acceptsMap
默认: 取决于数据类型。
内容类型发送请求头,告诉服务器什么样的响应会接受返回。如果accepts设置需要修改,推荐在$.ajaxSetup()方法中做一次。
asyncBoolean
(默认: true) 默认设置下,所有请求均为异步请求。如果需要发送同步请求,请将此选项设置为 false。注意,同步请求将锁住浏览器,用户其它操作必须等待请求完成才可以执行。
beforeSend(XHR)Function
发送请求前可修改 XMLHttpRequest 对象的函数,如添加自定义 HTTP 头。XMLHttpRequest 对象是唯一的参数。这是一个Ajax 事件。如果返回false可以取消本次ajax请求。
function (XMLHttpRequest) {
this; // 调用本次AJAX请求时传递的options参数
}
cacheBoolean
(默认: true,dataType为script和jsonp时默认为false) jQuery 1.2 新功能,设置为 false 将不缓存此页面。
complete(XHR, TS)Function
请求完成后回调函数 (请求成功或失败之后均调用)。参数: XMLHttpRequest 对象和一个描述成功请求类型的字符串。Ajax 事件。
function (XMLHttpRequest, textStatus) {
this; // 调用本次AJAX请求时传递的options参数
}
contentsMapV1.5
一个以"{字符串:正则表达式}"配对的对象,用来确定jQuery将如何解析响应,给定其内容类型。
contentTypeString
(默认: "application/x-www-form-urlencoded") 发送信息至服务器时内容编码类型。默认值适合大多数情况。如果你明确地传递了一个content-type给 $.ajax() 那么他必定会发送给服务器(即使没有数据要发送)
contextObject
这个对象用于设置Ajax相关回调函数的上下文。也就是说,让回调函数内this指向这个对象(如果不设定这个参数,那么this就指向调用本次AJAX请求时传递的options参数)。比如指定一个DOM元素作为context参数,这样就设置了success回调函数的上下文为这个DOM元素。就像这样:
$.ajax({ url: "test.html", context: document.body, success: function(){
$(this).addClass("done");
}});
convertersmapV1.5
默认: {"* text": window.String, "text html": true, "text json": jQuery.parseJSON, "text xml": jQuery.parseXML}
一个数据类型对数据类型转换器的对象。每个转换器的值是一个函数,返回响应的转化值
crossDomainmapV1.5
默认: 同域请求为false
跨域请求为true如果你想强制跨域请求(如JSONP形式)同一域,设置crossDomain为true。这使得例如,服务器端重定向到另一个域
dataObject,String
发送到服务器的数据。将自动转换为请求字符串格式。GET 请求中将附加在 URL 后。查看 processData 选项说明以禁止此自动转换。必须为 Key/Value 格式。如果为数组,jQuery 将自动为不同值对应同一个名称。如 {foo:["bar1", "bar2"]} 转换为 "&foo=bar1&foo=bar2"。
dataFilterFunction
给Ajax返回的原始数据的进行预处理的函数。提供data和type两个参数:data是Ajax返回的原始数据,type是调用jQuery.ajax时提供的dataType参数。函数返回的值将由jQuery进一步处理。
function (data, type) {
// 对Ajax返回的原始数据进行预处理
return data // 返回处理后的数据
}
dataTypeString
预期服务器返回的数据类型。如果不指定,jQuery 将自动根据 HTTP 包 MIME 信息来智能判断,比如XML MIME类型就被识别为XML。在1.4中,JSON就会生成一个JavaScript对象,而script则会执行这个脚本。随后服务器端返回的数据会根据这个值解析后,传递给回调函数。可用值:
"xml": 返回 XML 文档,可用 jQuery 处理。
"html": 返回纯文本 HTML 信息;包含的script标签会在插入dom时执行。
"script": 返回纯文本 JavaScript 代码。不会自动缓存结果。除非设置了"cache"参数。'''注意:'''在远程请求时(不在同一个域下),所有POST请求都将转为GET请求。(因为将使用DOM的script标签来加载)
"json": 返回 JSON 数据 。
"jsonp":JSONP格式。使用JSONP形式调用函数时,如 "myurl?callback=?" jQuery 将自动替换 ? 为正确的函数名,以执行回调函数。
"text": 返回纯文本字符串
errorFunction
(默认: 自动判断 (xml 或 html)) 请求失败时调用此函数。有以下三个参数:XMLHttpRequest 对象、错误信息、(可选)捕获的异常对象。如果发生了错误,错误信息(第二个参数)除了得到null之外,还可能是"timeout", "error", "notmodified" 和 "parsererror"。Ajax 事件。
function (XMLHttpRequest, textStatus, errorThrown) {
// 通常 textStatus 和 errorThrown 之中
// 只有一个会包含信息
this; // 调用本次AJAX请求时传递的options参数
}
globalBoolean
(默认: true) 是否触发全局 AJAX 事件。设置为 false 将不会触发全局 AJAX 事件,如 ajaxStart 或 ajaxStop 可用于控制不同的Ajax 事件。
headersmapV1.5
Default: {}
一个额外的"{键:值}"对映射到请求一起发送。此设置被设置之前beforeSend函数被调用;因此,消息头中的值设置可以在覆盖beforeSend函数范围内的任何设置。
ifModifiedBoolean
(默认: false) 仅在服务器数据改变时获取新数据。使用 HTTP 包 Last-Modified 头信息判断。在jQuery 1.4中,他也会检查服务器指定的'etag'来确定数据没有被修改过。
isLocalmapV1.5.1
默认: 取决于当前的位置协议
允许当前环境被认定为“本地”,(如文件系统),即使jQuery默认情况下不会承认它。以下协议目前公认为本地:file, *-extension, and widget。如果isLocal设置需要修改,建议在$.ajaxSetup()方法中这样做一次。
jsonpString
在一个jsonp请求中重写回调函数的名字。这个值用来替代在"callback=?"这种GET或POST请求中URL参数里的"callback"部分,比如{jsonp:'onJsonPLoad'}会导致将"onJsonPLoad=?"传给服务器。
jsonpCallbackString
为jsonp请求指定一个回调函数名。这个值将用来取代jQuery自动生成的随机函数名。这主要用来让jQuery生成度独特的函数名,这样管理请求更容易,也能方便地提供回调函数和错误处理。你也可以在想让浏览器缓存GET请求的时候,指定这个回调函数名。
mimeTypeStringV1.5.1
一个mime类型用来覆盖XHR的 MIME类型。
passwordString
用于响应HTTP访问认证请求的密码
processDataBoolean
(默认: true) 默认情况下,通过data选项传递进来的数据,如果是一个对象(技术上讲只要不是字符串),都会处理转化成一个查询字符串,以配合默认内容类型 "application/x-www-form-urlencoded"。如果要发送 DOM 树信息或其它不希望转换的信息,请设置为 false。
scriptCharsetString
只有当请求时dataType为"jsonp"或"script",并且type是"GET"才会用于强制修改charset。通常只在本地和远程的内容编码不同时使用。
statusCodemapV1.5
默认: {}
一组数值的HTTP代码和函数对象,当响应时调用了相应的代码。例如,如果响应状态是404,将触发以下警报:
$.ajax({
statusCode: {404: function() {
alert('page not found');
}
});
success(data, textStatus, jqXHR)Function,Array
请求成功后的回调函数。参数:由服务器返回,并根据dataType参数进行处理后的数据;描述状态的字符串。还有 jqXHR(在jQuery 1.4.x的中,XMLHttpRequest) 对象 。在jQuery 1.5, 成功设置可以接受一个函数数组。每个函数将被依次调用。Ajax 事件。
function (data, textStatus) {
// data 可能是 xmlDoc, jsonObj, html, text, 等等...
this; // 调用本次AJAX请求时传递的options参数
}
traditionalBoolean
如果你想要用传统的方式来序列化数据,那么就设置为true。请参考工具分类下面的jQuery.param 方法。
timeoutNumber
设置请求超时时间(毫秒)。此设置将覆盖全局设置。
typeString
(默认: "GET") 请求方式 ("POST" 或 "GET"), 默认为 "GET"。注意:其它 HTTP 请求方法,如 PUT 和 DELETE 也可以使用,但仅部分浏览器支持。
urlString
(默认: 当前页地址) 发送请求的地址。
usernameString
用于响应HTTP访问认证请求的用户名
xhrFunction
需要返回一个XMLHttpRequest 对象。默认在IE下是ActiveXObject 而其他情况下是XMLHttpRequest 。用于重写或者提供一个增强的XMLHttpRequest 对象。这个参数在jQuery 1.3以前不可用。
xhrFieldsmapV1.5
一对“文件名-文件值”在本机设置XHR对象。例如,如果需要的话,你可以用它来设置withCredentials为true的跨域请求。
示例
描述:
加载并执行一个 JS 文件。
jQuery 代码:
$.ajax({
type: "GET",
url: "test.js",
dataType: "script"
});
描述:
保存数据到服务器,成功时显示信息。
jQuery 代码:
$.ajax({
type: "POST",
url: "some.php",
data: "name=John&location=Boston",
success: function(msg){
alert( "Data Saved: " + msg );
}
});
描述:
装入一个 HTML 网页最新版本。
jQuery 代码:
$.ajax({
url: "test.html",
cache: false,
success: function(html){
$("#results").append(html);
}
});
描述:
同步加载数据。发送请求时锁住浏览器。需要锁定用户交互操作时使用同步方式。
jQuery 代码:
var html = $.ajax({
url: "some.php",
async: false
}).responseText;
描述:
发送 XML 数据至服务器。设置 processData 选项为 false,防止自动转换数据格式。
jQuery 代码:
var xmlDocument = [create xml document];
$.ajax({
url: "page.php",
processData: false,
data: xmlDocument,
success: handleResponse
});
第5章 jQuery的动画与特效
show()与hide()方法 较常用,不解释。
滑动 slideDown()与slideUp()方法
要实现元素的滑动效果,需要调用jQuery中的两个方法,一个是slideDown(),另一个是slideUp(),其调用的语法格式介绍如下。
其功能是以动画的效果将所选择元素的高度向下增大,使其呈现一种“滑动”的效果,而元素的其他属性并不发生变化;参数speed为动画显示的速度,可选项[callback]为动画显示完成后,执行的回调函数。
淡入淡出fadeIn()与fadeOut()方法
jQuery实用工具函数
盒子模型
盒子模型是CSS中的专术名词,用以描述页面设置中的各种属性,如内容(content)、填充(padding)、边框(border)、边界(margin)。由于这些属性拼合在一起,与日常生活中的“盒子”很相像,因此称为盒子模型。
盒子模型分为两类:一类是W3C盒子模型;另一类是IE盒子模型。两者最根本的区别在于属性height与width这两个值是否包含padding与border。
W3C盒子模型不包含padding与border,仅指内容(content)的height和width。
IE盒子模型的height和width的长度包含padding与border,
遍历数组
使用$.each()工具函数可以实现页面中元素的遍历,此外还可以完成指定数组的遍历,其调用的语法格式如下:
其中,参数obj表示要遍历的数组或对象。fn为每个遍历元素执行的回调函数,该函数包含两个参数:para1表示数组的序号或对象的属性;para2表示数组的元素和对象的属性。
$.each()函数除了遍历数组外,还可以遍历对象,获取对象的属性和值。
数据筛选
在操作数组时,有时需要根据各种条件筛选元素,传统的JavaScript代码将遍历整个数组,在遍历中设置筛选规则,然后获取符合规则的元素。而在jQuery中,可以使用工具函数jQuery.grep(),很方便地筛选数组中的任何元素,该函数调用的语法格式如下
参数array为要筛选的原数组,回调函数fn中可以设置两个参数,其中elementOfArray为数组中的元素,indexInArray为元素在数组中的序列号。另外,可选项[invert]为布尔值,表示是否根据fn的规则取反向结果,默认值为false,表示不取反,如果为true表示取反,即返回与回调函数fn规则相反的数据。
数据变更
虽然可以通过$.grep()函数筛选数组中的元素,但如果要按指定条件修改数组中的所选元素,还需调用另外一个工具函数$.map(),其调用的语法格式如下:
其中,参数array为要变更的原数组。回调函数fn中可以设置两个参数,其中elementOfArray为数组中的元素,indexInArray为元素在数组中的序列号。
数据搜索
在jQuery中,如果要在数组中搜索某个元素,可以使用工具函数$.inArray()。该方法相当于用JavaScript中的indexOf()函数搜索字符串中的某个字符。在工具函数$.inArray()中,如果找到了指定的某个元素,则返回该元素在数组中的索引号,否则返回-1值。其调用的格式如下所示:
字符串操作
在jQuery中,如果要除掉字符中左右两边的空格符,可以使用工具函数$.trim()。该函数常用于字符串操作,也是jQuery核心库中唯一针对字符串操作的工具函数,其调用的语法格式如下所示