jQuery大部分功能需要根据文档的DOM模型来工作,首先需要正确地解析到整个文档的DOM模型结构。使用jQuery需要在整个文档被浏览器完全加载后才开始进行。
$(document).ready(function () {
alert("Hello World!");
$("p").click(function (event) {
alert("Thanks for visiting!");
})
});
$是在jQuery中使用的变量名,可以使用jQuery.noConflict()避免冲突,它的返回值就是jQuery对象。
jQuery.noConflict();
$j = jQuery.noConflict();
jQuery对象与DOM对象之间的转换
使用$()得到的是一个jQuery对象。它封装了很多 DOM 对象的操作,但是它和 DOM 对象之间是不同的。只有当obj是一个DOM对象时才能使用obj.innerHTML;相应地,如果是jQuery对象应该使用 obj.html() 。
从 DOM 对象转到 jQuery 对象: $(obj)
从 jQuery 对象转到 DOM 对象: obj[0]
比较正规地从 jQuery 对象到 DOM 的转换,是使用 jQuery 对象的 get() 方法:
$(function () {
$("li").get();
$("li").get(0);
$("li").get(-1);
});
jQuery选择器
1. 常规选择器
$("*") 选择所有节点
$("#id") ID选择器,注意其中的一些特殊字符,如.
$(".class") 类选择器
$("tag") 标签选择器
$("子元素")
$("直接子元素")
:focus 获取焦点元素
:first-child/:last-child 选择第一个/最后一个元素
:first/:last 截取第一个/最后一个符合条件的元素
("pre+next") 直接兄弟元素
("pre~siblings") 兄弟元素
:nth-child() 索引选择,索引从1开始
:nth-child(odd)
:nth-child(even)
:nth-child(4n)
2. 属性选择器
[name~="value"] 属性中包括某单词
[name="value"] 属性完全等于指定值
[name!="value"] 属性不等于指定值
[name] 包括有指定属性的元素
3. 控件选择器
:checked 选择所有被选中的元素
:selected 被选择的元素
:disabled/:enabled 选择被禁用/未禁用的元素
:hidden 隐藏元素,不仅是[type="hidden"],还有displa:none
:visible 可见控件,visibility:hidden和opacity:0同样被认为是可见
:input :button :checkbox :file :image :password :radio :reset :submit :text 具体控件,图像控件是[type="image"]
4. 其他选择器
[name="value"] [name2="value2"] 多个AND条件
("selector1, selector2, selectorN") 多个OR条件
:not() 否定选择
(':contains("text")') 包含有指定内容的元素
:eq() :lt() :gt() :even :odd 列表索引选择(不支持负数)
(':has(selector)') 符合条件的再次过滤
:header 选择h1,h2,h3...标题元素
:only-child 仅有一个子元素的元素
:empty 空元素,即无内容也无元素
:parent 非空元素
节点漫游
1. 调用链处理
.add() 向已有的节点序列中添加新的对象
.andSelf() 在调用链中,随时加入原始序列
.eq() 指定索引选取节点,支持负数
.filter() .is() .not() .find() .first() .last() .has() 序列选择
.end() 节点回溯
$(function () {
$('ul.first').find('.foo').css('background-color', 'red')
.end().find('.bar').css('background-color', 'green');
});
2. 子节点
.children() 所有的子节点,可加入过滤条件,.children(selector)
3. 兄弟节点
.siblings() .next() .nextAll() .nextUntil() .prevAll() .prevUntil() .closet() 选择兄弟节点
4. 父节点
.parent() .parents() .parentUntil() 父节点选择
元素控制
1. attributes和properties的区别
attributes 是XML结构中的属性节点
properties 是DOM对象,对象属性 $('body').get(0).tagName;2. 类与属性控制
.addCLass() .hasClass() .removeClass() 添加一个类,判断是否有指定类,删除类
$('body').addClass('test');
$('body').addClass(function (index, current) {
return current + 'new';
});
$('body').removeClass('test');
$('body').removeClass(function (index, current) {
return current + ' ' + 'other';
});
.toggleClass() 类的开关式转换
$('img').toggleClass(); //对所有类的开关
$('img').toggleClass('test'); //对指定类的开关
$('img').toggleClass(isTrue); //根据`isTrue`判断所有类的开关
$('img').toggleClass('test', isTrue); //根据`isTrue`判断指定类的开关
//同 `$('img').toggleClass('test');` 只是类名由函数返回
$('img').toggleClass(function (index, className, isTrue) {
return 'name'
});
// `isTrue`作为函数的第三个参数传入
$('img').toggleClass(function (index, className, isTrue) {
return 'name'
}, isTrue);
.attr() 获取或设置一个属性值
// $("#greatphoto").attr('alt'); //获取属性`
$("#greatphoto").attr('alt', 'Shenzhen Brush Seller'); //设置属性`
// 同时设置多个属性
$('#greatphoto').attr({
alt: 'Shen Brush Seller',
title: 'photo by Kelly Clark'
});
//设置属性为函数返回值,函数的上下文为当前元素
$('#greatphoto').attr('title', function (i, val) {
return val + ' - photo by Kelly Clark';
})
.prop() 用法同.attr(),只是对象变成了properties
.removeAttr() .removeProp() 删除属性
.val() 设置或获取元素的表单值,通常用于表单元素
$('input').val();
$('input').val('other');
.html() 设置或获取元素的节点html
$('div').html();
$('div').html('<div>测试</div>');
$('div').html(function (index, old) {
return old + '<span>另外的内容</span>';
});
3. 样式控制
.css() 获取或设置指定的CSS样式
$('body').css('background-color', 'red');
$('body').css('background-color', function (index, value) {
return value + '1';
});
$('body').css({color: 'green', 'background-color': 'red'});
.width() .height() 获取或设置元素的宽和高
$('body').width();
$('body').width(50);
$('body').width(function (index, value) {
return value += 10;
})
.innerWidth() .innerHeight() .outerHeight() .outerWidth() 元素的其他尺寸值
.scrollLefgt() .scrollTop() 获取或设置滚动条的位置
.offset() .position() 获取元素的坐标
offset是相对于document,position是相对于父级元素
结构控制
1. 文本节点
.html() .text() 设置和获取节点的文本值。设置时.text()会转义标签,获取时.text()会移除所有标签。
2. 子节点
.append() .prepend()
$('.inner').append('<p>Test</p>');
参数可以有多种形式:
var $newdiv1 = $('<div id="object1"/>'),
newdiv2 = document.createElement('div'),
existingdiv1 = document.getElementById('foo');
$('body').append($newdiv1, [newdiv2, existingdiv1]);
3. 兄弟节点
.after() .before()
$('.inner').after('<p>Test</p>');
4. 父节点
.wrap() .wrap() .wrapInner()
$('.inner').wrap('<div class="new"></div>');
$('.inner').wrapAll('<div class="new"></div>');
$('.inner').wrapInner('<div class="new"></div>');
5. 复制/删除/替换节点
.clone() 复制节点,可选参数表示是否处理已绑定的事件与数据
.clone(true) 处理当前节点的事件与数据
.clone(true, true) 处理当前节点及所有子节点的事件与数据
.detach() 暂时移除节点,之后可以再次恢复指定位置
.remove() 永久移除节点
.empty() 清除一个节点的所有内部内容
.unwrap() 移除节点的父节点
工具函数
.map() 遍历所有成员
$(':checkbox').map(function () {
return this.id;
}).get().join(',');
$(':checkbox').map(function (index, node) {
return node.id;
}).get().join(',');
.slice() 序列切片,支持一个或两个参数,支持负数
$('li').slice(2).css('background-color', 'red');
$('li').slice(2, 4).css('background-color', 'green');
$('li').slice(-2, -1).css('background-color', 'blue');
通用工具
$.each() $.map() 遍历列表,$.map()可以用于对象
$.each([52, 97], function (index, value) {
console.log((index + ' : ' + value));
});
$.map([0, 1, 2], function (index, n) {
return n + 4;
});
$.map([0, 1, 2], function (n) {
return n > 0 ? n + 1 : null;
});
$.map([0, 1, 2], function (n) {
return [n, n + 1];
});
var dimensions = {width: 10, height: 15, length: 20};
$.map(dimensions, function (value, key) {
return value * 2;
});
var dimensions = {width: 10, height: 15, length: 20};
$.map(dimensions, function (value, key) {
return key;
});
$.extend() 合并对象,第一个参数表示是否进行递归深入
var object = $.extend({}, object1, object2);
var object = $.extend(true, {}, object1, object2);
$.merge() 合并列表
$.merge([0, 1, 2], [2, 3, 4]);
.grep() 过滤列表,第三个参数表示是否为取反
$.grep([0, 1, 2], function (array, index) {
return n > 0;
});//[1,2]
$.grep([0, 1, 2], function (array, index) {
return n > 0;
}, true);//[0]
$.inArray() 存在判断
$.inArray(value, array [, fromIndex])
$.isArray() $.isEmptyObject() $.isFunction() $.iSNumeric() $.isPainObject() $.isWindow $.isXMLDoc() 类型判断
$.noop() 空函数
$.now() 当前时间戳,值为(new Date).getTime()
$.parseJson() $.parseXML() 把字符串解析为对象
var xml = "<rss version='2.0'><channel><title>RSS Title</title></channel></rss>",
xmlDoc = $.parseXML(xml),
$xml = $(xmlDoc),
$title = $xml.find("title");
$.trim() 去头去尾 $.trim(str)
$.type() 判断参数的类型
$.unique() 遍历后去重。$.unique(arraty)
上下文绑定
$.proxy() 为函数绑定上下文
$.proxy(function,context)
$.proxy(context,name)
var o = {
x: '123',
f: function () {
console.log(this.x)
},
};
var go = function (f) {
f()
};
o.f();// 123
go(o.f);// undefined
go($.proxy(o.f, o));//123
$.proxy(o, 'f')(); //123
当一个函数被传递之后,它就失去了原先的上下文。
把数据存到节点中
jQuery提供了一种机制,可以把节点作为数据存储的容器。
$.data() 往节点中获取/设置数据
$.removeData() 删除数据
在内部实现上,jQuery会在指定节点添加一个内部标识,以此为key,把数据存在内部闭包的一个结构中。
事实上,jQuery的事件绑定机制也使用了这套数据接口。
.
d
a
t
a
(
.data(
.data((’#data’).get(0), ‘test’, ‘123’);
$(’#data’).data(‘test’, ‘456’);
事件处理
1. 事件绑定
在 jQuery1.7之后,推荐统一使用on()来进行事件绑定。
.on() 绑定事件 on()的基本使用方式是:.on(event,handler)
.off() 移除事件
.one() 绑定单次事件
$('#btn').on('click', function (eventObj) {
console.log('Hello');
})
对于handler,它默认的上下文是触发事件的节点:
$('#btn').on('click', function (eventObj) {
console.log(this);
})
使用$.proxy()可以随意控制上下文:
$('#btn').on('click',
$.proxy(function (eventObj) {
console.log(this.a);
}, {a: 123})); // 123
event参数还支持通过:
-
以
.
分割的子名字 -
以空格分割的多个事件
$(’#btn’).on(‘click.my’, (function (eventObj) {
console.log(‘123’);
}
)
);
var f = function () {
$(’#btn’).off(‘click.my’)
};
多个事件:
$('#btn').on('click.my click.other',
(function (eventObj) {
console.log('123');
}
)
);
var f = function () {
$('#btn').off('click.my')
}
on()的另一种调用形式:
$('#btn').on({
'click': function (eventObj) {
console.log('click');
},
'mousemove': function (eventObj) {
console.log('move');
}
});
off()的使用方式与on()完全类似:
var f = function (eventObj) {
console.log('Hello');
};
$('#btn').on('click', f);
$('#btn').off('click');
2. 事件触发
事件的触发有两种方式,一是使用预定的“事件函数”(.click(),.focus()),二是使用trigger()或triggerHandler()。
$('#btn').on('click', function (eventObj) {
console.log("hello");
});
$('#btn').click();
$('#btn').trigger('click');
trigger()与triggerHandler()不同之处在于前面是触发事件,而后者是执行绑定函数。
$('#btn').on('focus', function (event) {
console.log("Hello");
});
$('#btn').triggerHandler('focus');
trigger()和triggerHandler()也用于触发自定义事件。
$('#btn').on('my', function (event) {
console.log("Hello");
});
$('#btn').triggerHandler('my');
trigger()和triggerHandler()触发事件时,可以带上参数:
$('#btn').on('my', function (event) {
console.log(obj);
});
$('#btn').trigger('my', {a: 123});
3. 事件类型
行为事件:
.click() 单击
.dbclick() 双击
.blur() 失去焦点时
.change() 值变化时
.focus() 获取焦点时
.focusin() jQuery扩展的获取焦点
.focusout() jQuery扩展的失去焦点
.resize() 调整大小
.scroll() 滚动
.select() 被选择
.submit() 表单被提交
键盘事件:
.keydown() 按下键
.keyup() 放开键
鼠标事件:
.mousedown() 点下鼠标
.mouseup() 松开鼠标
.mouseover() 光标移入
.mouseout() 光标移出
.mousemove() 光标在其上移动
.mouseleave() .mouseenter() 光标移出/移入
页面事件:
.ready() 准备就绪
.unload() 离开当前页时,针对window对象
.error() 发生错误时
.load() 正在载入
4. 事件对象
event.currentTarget,event,target 事件绑定节点/事件的触发节点(冒泡行为)
event.delegateTarget 绑定事件的对象,通常就是event.currentTarget
event.relatedTarget 相关的节点,主要用于一些转换式的事件。比如鼠标移入,表示它从哪个节点来的
event.which 标明哪个按钮触发了事件,鼠标和键盘的键标识统一在这个属性中
event.preventDefault() event.isDefaultPrevented() 禁止默认行为
event.stopImmediateProgation() event.isImmediateProgationStopped() 不仅禁止冒泡。还终止绑定函数链的继续进行
event.stopPropagation(),event.isPropagationStopped() 禁止冒泡
event.pageX,event.pageY 事件触发时相对于document的鼠标位置
event.namespace 事件触发时的名字空间,比如trigger('click.namespace')
event.data 额外传入的数据
event.result 上一个绑定函数的返回值
event.timeStamp 事件触发时的时间,其值为(new Date).getTime()
event.type 事件类型
如果一个绑定函数最后返回了false,则默认是event.preventDefault()和event.stopPropagation()行为。
AJAX
1. 请求与回调
jQuery的AJAX,核心的请求处理函数只有一个,就是$.ajax(),然后就是一个简单的上层函数。
$.ajax() 的基本使用形式是:
jQuey.ajax(settings) settings是一个对象,里面包含了所有的配置项。
url 请求的地址。
type 请求的方法类型,GET,POST。默认是GET。
data 要发送的数据
dataType 服务器返回的数据类型,支持xml,html,script,json,jsonp,text
success 请求成功时调用的处理函数 success(data, textStatus, jqXHR)
context 回调函数执行时的上下文
cache 默认为true,是否为请求单独添加一个随机参数以防止浏览器缓存
error 请求错误时的调用函数。
error(jqXHR, textStatus, errorThrown)
第二个参数是表示请求状态的字符串:timeout,error,abort,parsererror
第三个参数是当HTTP错误发生时,具体的错误描述:Not Found,Internal Server Error等
complete 请求结束(无论成功或失败)时的一个回调函数。
complete(jqXHR, textStatus)
第二个参数时表示请求状态的字符串:success,notmodified,error,timeout,abort,parsererror。
jsonp 一个参数名,默认是callback,一般用于指明回调函数名。设置成false可以让请求没有callback参数。
jsonpCallback callback参数值。默认是自动生成的一个随机值。
2. 请求的状态
对于全局的所有AJAX请求而言,可以在任意节点上绑定到全局任意AJAX请求的每一个事件:
$('#loading').ajaxStart(function () {
$(this).show();
});
.ajaxStart() 请求将要发出时
.ajaxSend() 请求将要发出时(在.ajaxStart()后)
.ajaxSuccess() 请求成功
.ajaxError() 请求错误
.ajaxComplete() 请求完成
.ajaxStop() 请求结束(在.ajaxComplete()后)
3. 工具函数
.serialize() 解析表单参数项,返回字符串
$('form').submit(function () {
alert($(this).serialize());
return false;
});
.serializeArray() 解析表单参数项,返回一个列表对象。
$('form').submit(function () {
alert($(this).serializeArray());
return false;
});
泛化回调
- Deferred
Deferred对象是在jQuery1.5中引入的回调管理对象。其作用是把一堆函数按顺序放入一个调用链,然后根据状态来依次调用这些函数。AJAX的所有操作都是使用它来进行封装的。
var obj = $.Deferred(function (a) {
});
obj.done(function () {
console.log("1");
});
obj.done(function () {
console.log("2");
});
obj.resolve();
总的来说:jQuery的Deferred对象有三个状态:done,fail,process。
- `process` 只能先于其他两个状态先被激发。
- `done`和`fail`互斥,只能激发一个。
- `process`可以被重复激发,而`done`和`fail`只能激发一次。
-
然后,jQuery提供了一些函数用于添加回调,激发状态等。
deferred.done() 添加一个或多个成功回调
deferred.fail() 添加一个或多个失败回调
deferred.always() 添加一个函数,同时应用于成功和失败
deferred.progress() 添加一个函数用于准备回调
deferred.then() 依次接受三个函数,分别用于成功,失败,准备状态
deferred.reject() 激发失败状态
deferred.resolve() 激发成功状态
deferred.notify() 激发准备状态
如果一个Deferred已经被激发,则新添加的对应的函数会被立即执行。
jQuery还提供了一个jQuery.when()的回调管理函数,可以用于方便地管理多个事件并发的情况。
var defer = $.ajax({
url: 'test.html',
dataType: 'json'
});
defer.done(function (data) {
console.log(data);
});
done()做的事和使用success()定义是一样的。
当我们需要完成,像“请求A和请求B都完成时,执行函数”之类的需求时,使用$.when()就可以了。
var defer_1 = $.ajax({
url: 'json.html',
dataType: 'json'
});
var defer_2 = $.ajax({
url: 'jsonp.html',
dataType: 'jsonp'
});
var new_defer = $.when(defer_1, defer_2);
new_defer.done(function () {
console.log("hello");
});
在$.when()中的Deferred,只要有一个是fail,则整体结果为fail。
Deferred的回调函数的执行顺序与它们的添加顺序一致。
这里特别注意一点,就是done/fail/always与then的返回值的区别。从功能上看,它们都可以添加回调函数,但是,方法的返回值是不同的。前组的返回值是原来的那个defer对象,而then返回的是一个新的defer对象。
then返回新的defer这种形式,可以用于方便地实现异步函数的链式调用。
defer.done(function () {
return $.ajax({
url: '/json',
dataType: 'json',
success: function () {
console.log("inner");
}
})
}).done(function () {
console.log("hello");
});
等同于是调用了两次 defer.done, defer.done ,注册的两次回调函数依次被执行后,看到的输出是:hello,inner。
这是两次 defer.done 的结果,第一个回调函数返回了一个新的 defer 没任何作用。
如果换成 then 方法:defer.then(function () {…});
它跟两次 defer.done 是不同的。 new_defer 会在 inner 那里的 defer 被触发时再被触发,所以输出结果是:inner,hello。
更一般地来说 then 的行为,就是前面的注册函数的返回值,会作为后面注册函数的参数值:
var defer = $.ajax({
url: '/json',
dataType: 'json'
});
defer.then(function (res) {
console.log(res);
return 1;
}).then(function (res) {
console.log(res);
return 2;
}).then(function (res) {
console.log(res);
});
上面代码的输入结果是:ajax response,1,2。
- Callbacks
事实上,Deferred机制,只是在Callbacks机制的上层进行了一层简单封装。Callbacks对象才是真正的jQuery中定义的原始的回调管理机制。
var obj = $.Callbacks();
obj.add(function () {
console.log("1");
});
obj.add(function () {
console.log("2");
});
obj.fire();
Callbacks对象的初始化支持一组控制参数:
$.Callbacks(flags) 初始化一个回调管理对象。flags是空格分割的多个字符串,以定义此回调对象的行为:
once 回调链只能被激发一次
memory 回调链被激发后,新添加的函数被立即执行
unique 相同的回调函数只能被添加一次
stopOnFalse 当有回调函数返回false时终止调用链的执行
CallbackS的控制方法:
callbacks.add() 添加一个或一串回调函数
callbacks.fire() 激发回调
callbacks.remove() 从调用链中移除指定的函数
callbacks.empty() 清空调用链
callbacks.disable() 关闭调用链的继续执行,新添加的函数也不会被执行
callbacks.lock() 锁定调用链,但是如果打开了memory的flag,新添加的函数仍然会执行
callbacks.has() 检查一个函数是否处于回调链之中
callbacks.fired() 检查回调链是否被激发
callbacks.locked() 检查回调链是否被锁定