jQuery版本
- 1.x:兼容IE678,使用最为广泛,官网只做BUG维护,功能不再新增。因此一般项目来说,使用1.X版本就可以了,最终版本:1.12.4 (2016年5月20日)
- 2.x:不兼容ie678,很少有人使用,官方只做BUG维护,功能不再新增。如果不考虑兼容低版本的浏览器可以使用2.x,最终版本:2.2.4 (2016年5月20日)
- 3.x:不兼容ie678,只支持最新的浏览器。除非特殊要求,一般不会使用3.x版本的,很多老的jQuery插件不支持这个版本。目前该版本是官方主要更新维护的版本。最新版本:3.2.1(2017年3月20日)
jQuery的两种API
$.noConflict()
$.each()
$('ul').addClass()
$('p').text('hi')
jQuery对象和原生DOM对象
一、两者之间的区别
DOM对象是我们用传统的方法(javascript)获得的对象,jQuery对象就是用jQuery的类库选择器获得的对象。
jQuery选择器得到的jQuery对象和标准的js中的document.getElementById()
取得的dom对象是两种不同类型,两者不等价。jQuery无法使用DOM对象的任何方法,同理Dom对象也不能使用jQuery里的方法,否则会报错。
//错误写法
$('p').innerHTML;
document.querySelector('p').html();
//正确写法
$('p').html();
document.querySelector('p').innerHTML;
二、二者之间的相互转化
在进行jQuery开发的时候,经常会遇到的场景是jQuery对象转换为原生的DOM对象以及原生DOM对象转换为jQuery对象。
- 原生DOM对象转jQuery对象:
var box = document.getElementById('box');
var $box = $(box);
- jQuery对象转原生DOM对象:
var $box = $('#box');
var box1 = $box[0];
var box2 = $box.get(0);
jQuery常见选择器
.eq(index), .get([index])
对于一个特定结果集,我们想获取到指定index的jQuery对象,可以使用eq
方法
$('div').eq(3); // 获取结果集中的第四个jQuery对象
我们可以通过类数组下标的获取方式或者get方法获取指定index的DOM对象,也就是我们说的jQuery对象转DOM对象
$('div')[2];
$('div').eq(2);
get()
不写参数把所有对象转为DOM对象返回
.next([selector]), .prev([selector])
next
取得匹配的元素集合中每一个元素紧邻的后面同辈元素的元素集合。如果提供一个选择器,那么只有紧跟着的兄弟元素满足选择器时,才会返回此元素。prev
正好相反,获取元素之前的同辈元素
$('.test').next();
$('.test').prev('li');
.nextAll([selector]), .prevAll([selector])
nextAll
获得每个匹配元素集合中每个元素所有后面的同辈元素,选择性筛选的选择器,prevAll
与之相反,获取元素前面的同辈元素
.siblings([selectors])
获得匹配元素集合中每个元素的兄弟元素,可以提供一个可选的选择器
$('li.third-item').siblings()
.parent([selector]), .parents([selector])
.parent
取得匹配元素集合中,每个元素的父元素,可以提供一个可选的选择器;.parents
获得集合中每个匹配元素的祖先元素,可以提供一个可选的选择器作为参数
$('li.item-a').parent();
$('li.item-a').parents('div')
.children([selector]), .find([selector])
.children
获得匹配元素集合中每个元素的子元素,选择器选择性筛选;.find
查找符合选择器的后代元素
$('ul.level-2').children();
$('ul').find('li.current');
.filter(selector), .filter(function(index))
筛选当前结果集中符合条件的对象,参数可以是一个选择器或者一个函数
$('li').filter(':even')
$('li').filter(function(index) {
return index % 3 == 2;
})
.is(selector), is(function(index)), is(dom/jqObj)
判断当前匹配的元素集合中的元素,是否为一个选择器,DOM元素,或者jQuery对象,如果这些元素至少一个匹配给定的参数,那么返回true
if ( $target.is("li") ) {
$target.css("background-color", "red");
}
.has(selector), .has(dom)
筛选匹配元素集合中的那些有相匹配的选择器或DOM元素的后代元素
$('li').has('span')
jQuery常用方法
.append(content,[content]) / .append(function(index,html))
- 可以一次添加多个内容,内容可以是DOM对象、HTML string、 jQuery对象
- 如果参数是
function
,function可以返回DOM对象、HTML string、 jQuery对象,参数是集合中的元素位置与原来的html值
$( ".inner" ).append( "<p>Test</p>" );
$( "body" ).append( $newdiv1, [ newdiv2, existingdiv1 ] );
$( "p" ).append( "<strong>Hello</strong>" );
$( "p" ).append( $( "strong" ) );
$( "p" ).append( document.createTextNode( "Hello" ) );
.prepend(content[,content]) / .prepend(function(index,html))
向对象头部追加内容,用法和append类似,内容添加到最开始
$( ".inner" ).prepend( "<p>Test</p>" );
.appendTo(target)/.prependTo(target)
把对象插入到目标元素尾部/头部,目标元素可以是selector, DOM对象, HTML string, 元素集合, jQuery对象
$( "h2" ).appendTo( $( ".container" ) );
$( "<p>Test</p>" ).appendTo( ".inner" );
$( "<p>Test</p>" ).prependTo( ".inner" );
.before([content][,content]) / .before(function)
在对象前面(不是头部,而是外面,和对象并列同级)插入内容,参数和append类似
$( ".inner" ).before( "<p>Test</p>" );
$( ".container" ).before( $( "h2" ) );
$( "p" ).first().before( newdiv1, [ newdiv2, existingdiv1 ] );
$( "p" ).before( "<b>Hello</b>" );
$( "p" ).before( document.createTextNode( "Hello" ) );
.after([content][,content]) / .after(function(index))
和before相反,在对象后面(不是尾部,而是外面,和对象并列同级)插入内容,参数和append类似
$( ".inner" ).after( "<p>Test</p>" );
$( "p" ).after( document.createTextNode( "Hello" ) );
.remove([selector])
删除被选元素(及其子元素),也可以添加一个可选的选择器参数来过滤匹配的元素
$("#div1").remove();
$('div').remove('.test');
.empty()
清空被选择元素内所有子元素
$('body').empty();
html([string])
这是一个读写两用的方法,用于获取/修改元素的innerHTML
- 当没有传递参数的时候,返回元素的
innerHTML
- 当传递了一个string参数的时候,修改元素的innerHTML为参数值
text()
和html方法类似,操作的是DOM的innerText
值
.val([value])
这是一个读写双用的方法,用来处理input的value,当方法没有参数的时候返回input的value值,当传递了一个参数的时候,方法修改input的value值为参数值
$('input').val()
$('input').val('newValue');
.attr()
-
.attr(attributeName)
获取元素特定属性的值
var title = $( "em" ).attr( "title" );
-
.attr(attributeName,value) / .attr(attributesJson) / .attr( attributeName, function(index, attr) )
为元素属性赋值
$( "#greatphoto" ).attr( "alt", "Beijing Brush Seller" );
$( "#greatphoto" ).attr({
alt: "Beijing Brush Seller",
title: "photo by Kelly Clark"
});
$( "#greatphoto" ).attr( "title", function( i, val ) {
return val + " - photo by Kelly Clark";
});
.removeAttr()
为匹配的元素集合中的每个元素中移除一个属性(attribute)。.removeAttr() 方法使用原生的 JavaScript removeAttribute() 函数,但是它的优点是可以直接在一个 jQuery 对象上调用该方法,并且它解决了跨浏览器的属性名不同的问题。
$('div').removeAttr('id');
.prop()/.removeProp()
用来操作元素的property的,property和attibute是非常相似的概念
.css()
用来处理元素的css
-
.css(propertyName) / .css(propertyNames)
获取元素style特定property的值
var color = $( this ).css( "background-color" );
var styleProps = $( this ).css([
"width",
"height",
"color",
"background-color"
]);
-
.css(propertyName,value) / .css( propertyName, function(index, value) ) / .css( propertiesJson )
设置元素style特定property的值
$( "div.example" ).css( "width", function( index ) {
return index * 50;
});
$( this ).css( "width", "+=200" );
$( this ).css( "background-color", "yellow" );
$( this ).css({
"background-color": "yellow",
"font-weight": "bolder"
});
.addClass(className) / .removeClass(className)
-
.addClass(className) / .addClass(function(index,currentClass))
为元素添加class,不是覆盖原class,是追加,也不会检查重复
$( "p" ).addClass( "myClass yourClass" );
$( "ul li" ).addClass(function( index ) {
return "item-" + index;
});
-
.removeClass([className]) / .removeClass(function(index,class))
移除元素单个/多个/所有class
$( "p" ).removeClass( "myClass yourClass" );
$( "li:last" ).removeClass(function() {
return $( this ).prev().attr( "class" );
});
.hasClass(className)
检查元素是否包含某个class,返回true/false
$( "#mydiv" ).hasClass( "foo" )
.toggleClass(className)
toggle是切换的意思,方法用于切换,switch是个bool类型值
//第一次执行
$( "div.tumble" ).toggleClass( "bounce" )
<div class="tumble bounce">Some text.</div>
//第二次执行
$( "div.tumble" ).toggleClass( "bounce" )
<div class="tumble">Some text.</div>
.each( function(index, Element) )
遍历一个jQuery对象,为每个匹配元素执行一个函数
$( "li" ).each(function( index ) {
console.log( index + ":" + $(this).text() );
});
jQuery.each( collection, callback(indexInArray, valueOfElement) )
一个通用的迭代函数,它可以用来无缝迭代对象和数组。数组和类似数组的对象通过一个长度属性(如一个函数的参数对象)来迭代数字索引,从0到length - 1。其他对象通过其属性名进行迭代。
var obj = {
"flammable": "inflammable",
"duh": "no duh"
};
$.each( obj, function( key, value ) {
alert( key + ": " + value );
});
jQuery.extend([deep,] target [, object1 ] [, objectN ] )
- 当我们提供两个或多个对象给
$.extend()
,对象的所有属性都添加到目标对象(target参数)。 - 如果只有一个参数提供给
$.extend()
,这意味着目标参数被省略。在这种情况下,jQuery对象本身被默认为目标对象。这样,我们可以在jQuery的命名空间下添加新的功能。这对于插件开发者希望向 jQuery 中添加新函数时是很有用的
目标对象(第一个参数)将被修改,并且将通过$.extend()返回。然而,如果我们想保留原对象,我们可以通过传递一个空对象作为目标对象:
var object = $.extend({}, object1, object2);
如果第一个对象的属性本身是一个对象或数组,那么它将完全用第二个对象相同的key重写一个属性。这些值不会被合并。如果将 true作为该函数的第一个参数,那么会在对象上进行递归的合并。
var object1 = {
apple: 0,
banana: { weight: 52, price: 100 },
cherry: 97
};
var object2 = {
banana: { price: 200 },
durian: 100
};
// Merge object2 into object1
$.extend( object1, object2 );
.clone( [withDataAndEvents ] )
.clone()方法深度复制所有匹配的元素集合,包括所有匹配元素、匹配元素的下级元素、文字节点。
通常我们将页面上一个元素插入到DOM里另一个地方,它会被从老地方移走,类似剪切的效果,但是我们如果需要的是复制而不是剪切,我们可以像下面这样写代码:
$('.hello').clone().appendTo('.goodbye');
.index() / .index(selector)/ .index(element)
从给定集合中查找特定元素index
- 没参数返回第一个元素index
- 如果参数是DOM对象或者jQuery对象,则返回参数在集合中的index
- 如果参数是选择器,返回第一个匹配元素index,没有找到返回-1
var listItem = $( "#bar" );
alert( "Index: " + $( "li" ).index( listItem ) );
.ready( handler )
当DOM准备就绪时,指定一个函数来执行。
虽然JavaScript提供了load事件,当页面呈现时用来执行这个事件,直到所有的东西,如图像已被完全接收前,此事件不会被触发,并且在一个页面中只能调用一次。
在大多数情况下,只要DOM结构已完全加载时,脚本就可以运行。传递处理函数给.ready()
方法,能保证DOM准备好后就执行这个函数,且在一个页面中可以调用多次,因此,这里是进行所有其它事件绑定及运行其它 jQuery 代码的最佳地方。
DOMContentLoaded事件和 .ready
都比window.load事件先触发,支持在页面下载的早期添加事件处理程序,这也就意味着用户能够尽早地与页面进行交互。对于支持DOMComtentLoaded的浏览器.ready
触发事件是绑定在DOMContentLoaded事件上。
如果执行的代码需要在元素被加载之后才能使用时,(例如,取得图片的大小需要在图片被加载完后才能知道),就需要将这样的代码放到 load 事件中。
下面两种语法全部是等价的:
- $(document).ready(handler)
- $(handler)
我们经常这么使用:
$(function(){
console.log('ready');
});