jQuery常用的API

从下面7个方面介绍jQuery常用的API：

• jQuery选择器
• jQuery样式操作
• jQuery效果
• jQuery属性操作
• jQuery文本属性值
• jQuery元素操作
• jQuery尺寸、位置操作

1. jQuery选择器

① jQuery基础选择器

原生JS获取元素方式很多，很杂，而且兼容性情况不一致，因此jQuery给我们做了封装，使获取元素统一标准。

$(‘选择器‘)  // 里面选择器直接写CSS选择器即可，但是要加引号

② jQuery层级选择器

③ 隐式迭代（重要）

遍历内部DOM元素（伪数组形式存储）的过程就叫做隐式迭代。

简单理解：给匹配到的所有元素进行循环遍历，执行相应的方法，而不用我们再进行循环，简化我们的操作，方便我们调用。

④ jQuery筛选选择器

⑤ jQuery筛选方法（重点）

重点记住：parent()、children()、find()、siblings()、eq()

⑥ jQuery里面的排他思想

想要多选一的效果，排他思想：当前元素设置样式，其余的兄弟元素清除样式。

<script>
    $(function() {
        // 1. 隐式迭代，给所有的按钮都绑定了点击事件
        $(‘button‘).click(function() {
            // 2. 当前的元素变化背景颜色
            $(this).css("background", "pink");
            // 3. 其余的兄弟去掉背景颜色（也是隐式迭代）
            $(this).siblings("button").css("background", "");
        });
    })
</script>

⑦ 链式编程

链式编程是为了节省代码量，看起来更优雅。

$(this).css(‘color‘, ‘red‘).siblings().css(‘color‘, ‘‘);

2. jQuery样式操作

① 操作css方法

jQuery可以使用css方法来修改简单元素样式；也可以操作类，修改多个样式。

• (1) 参数只写属性名，则是返回属性值

$(this).css("color");

• (2) 参数是属性名，属性值，并且使用逗号分隔，是设置一组样式，属性必须加引号，值如果是数字可以不用跟单位和引号。

注意，如果是复合属性则必须采取驼峰命名法。

$(this).css("color", "red");

• (3) 参数可以是对象形式，方便设置多组样式。属性名和属性值用冒号隔开，属性可以不用加引号。

$(this).css({"color": "white", "font-size": "20px"});

② 设置类样式方法

作用等同于classList，可以操作类样式，注意操作类里面的参数不要加点。

(1) 添加类

$("div").addClass("current");

(2) 移除类

$("div").removeClass("current");

(3) 切换类

$("div").toggleClass("current");

③ 类操作与className区别

原生JS中 element.className 会覆盖元素原先里面的类名。

jQuery里面类操作只是对指定类进行操作，不影响类名。

H5中新增的classList方法也不会覆盖原先的类名。

3. jQuery效果

jQuery封装了很多动画效果，最为常见的如下：

① 显示隐藏效果

• 显示语法规范：show([speed, [easing], [fn]])
• 隐藏语法规范：hide([speed, [easing], [fn]])
• 切换语法规范：toggle([speed, [easing], [fn]])

（1）参数都可以省略，无动画直接显示

（2）speed：三种预定速度之一的字符串（“slow”、“normal”或者“fast”）或表示动画时长的毫秒数值（如：1000）

（3）easing：（Optional）用来指定切换效果，默认是“swing”，可用参数“linear”

（4）fn：回调函数，在动画完成时执行的函数，每个元素执行一次

② 滑动效果

• 下滑语法规范：slideDown([speed, [easing], [fn]])
• 上滑语法规范：slideUp([speed, [easing], [fn]])
• 滑动切换语法规范：slideToggle([speed, [easing], [fn]])

（1）参数都可以省略，无动画直接显示

（2）speed：三种预定速度之一的字符串（“slow”、“normal”或者“fast”）或表示动画时长的毫秒数值（如：1000）

（3）easing：（Optional）用来指定切换效果，默认是“swing”，可用参数“linear”

（4）fn：回调函数，在动画完成时执行的函数，每个元素执行一次

③ 事件切换

hover([over,] out)

• over：鼠标移到元素上要触发的函数（相当于mouseenter）
• out：鼠标移出元素要触发的函数（相当于mouseleave）
• 事件切换hover就是鼠标经过和离开的复合写法

注意，事件切换hover如果只写一个函数，那么鼠标经过和鼠标离开都会触发这个函数。

④ 动画队列及其停止排队方法

jQuery中如果触发动画，则一定会把这个动画执行完。如果短时间内多次触发该动画，则会出现动画排队的效果。

• 动画或效果队列：动画或者效果一旦触发就会执行，如果多次触发，就造成多个动画或者效果排队执行
• 停止排队：使用stop()方法停止动画或者效果。注意，stop()要写到动画或者效果的前面，相当于停止结束上一次的动画。

⑤ 淡入淡出效果

• 淡入语法规范：fadeIn([speed, [easing], [fn]])
• 淡出语法规范：fadeOut([speed, [easing], [fn]])
• 淡入淡出切换语法规范：fadeToggle([speed, [easing], [fn]])
• 渐进方式调整到指定的不透明度：fadeTo([[speed], opacity, [easing], [fn]])

（1）opacity透明度必须写，取值0~1之间

（2）speed：三种预定速度之一的字符串（“slow”、“normal”或者“fast”）或表示动画时长的毫秒数值（如：1000）。必须写

（3）easing：（Optional）用来指定切换效果，默认是“swing”，可用参数“linear”

（4）fn：回调函数，在动画完成时执行的函数，每个元素执行一次

例如下面这个小例子：鼠标移动到某个小图片上，它就高亮显示（实际上是其他图片透明度降下去了）

<script>
    $(function() {
        // 鼠标进入的时候，其他的li标签透明度：0.5
        $(".wrap li").hover(function() {
            $(this).siblings().stop().fadeTo(400, 0.5);
        }, function() {
            // 鼠标离开，其他li透明度改为1
            $(this).siblings().stop().fadeTo(400, 1);
        });
    });
</script>

⑥ 自定义动画animate

animate(params, [speed], [easing], [fn])

（1）params：想要更改的样式属性，以对象形式传递，必须写。属性名可以不用带引号，如果是复合属性则需要采取驼峰命名法borderLeft。其余参数都可以省略。

（2）speed：三种预定速度之一的字符串（“slow”、“normal”或者“fast”）或表示动画时长的毫秒数值（如：1000）

（3）easing：（Optional）用来指定切换效果，默认是“swing”，可用参数“linear”

（4）fn：回调函数，在动画完成时执行的函数，每个元素执行一次

4. jQuery属性操作

① 设置或获取元素固有属性值prop()

所谓元素固有属性就是元素本身自带的属性，比如<a>元素里面的href，比如<input>元素里面的type。

• 获取属性语法：prop("属性")
• 设置属性语法：prop("属性", "属性值")

② 设置或获取元素自定义属性值attr()

用户自己给元素添加的属性，我们称为自定义属性。比如给div添加index = "1"。

• 获取属性语法：attr("属性")  类似原生getAttribute()
• 设置属性语法：attr("属性", "属性值")  类似原生setAttribute()

该方法也可以获取H5自定义属性。

③ 数据缓存data()

data()方法可以在指定的元素上存取数据，并不会修改DOM元素结构。一旦页面刷新，之前存放的数据都将呗移除。

• 附加数据语法：data("name", "value")  向被选元素附加数据
• 获取数据语法：data("name", "value")  向被选元素获取数据

同时，还可以读取HTML5自定义属性data-index，得到的是数字型。

// 数据缓存data()里面的数据是存放在元素的内存里面，不会显示在页面中
$("span").data("uname", "andy");
console.log($("span").data("uname"));
// 这个方法获取H5自定义属性的data-index，不需要写data-，并且返回的是数字型
console.log($("div").data("index"));

5. jQuery文本属性值

主要针对元素的内容还有表单的值操作。

① 普通元素内容html()（相当于原生innerHTML）

html()  // 获取元素的内容
html("内容")  // 设置元素的内容

② 普通元素文本内容text()（相当于原生innerText）

text()  // 获取元素的文本内容
text("文本内容")  // 设置元素的文本内容

③ 表单的值val()（相当于原生value）

$("input").val()  //获取表单的值
$("input").val("表单的值")  //设置表单的值

6. jQuery元素操作

主要是遍历、创建、添加、删除元素操作。

① 遍历元素

jQuery隐式迭代是对同一类元素做了同样的操作。如果想要给同一类元素做不同操作，就需要用到遍历。

• 语法1：

$("div").each(function (index, domEle) {...})

（1）each()方法遍历匹配的每一个元素。主要用DOM处理。

（2）里面的回调函数有2个参数：index是每个元素的索引号；domEle是每个DOM元素对象，不是jQuery对象。

（3）所以想要使用jQuery方法，需要给这个dom元素转换为jQuery对象$(domEle)

• 语法2：

$.each(object, function (index, element) {...})

（1）$.each()方法可用于遍历任何对象。主要用于数据处理，比如数组、对象。

（2）里面的函数有2个参数：index是每个元素的索引号；element是遍历的内容。

（3）如果想要遍历DOM对象，则可以使用语法1；如果想要遍历的是数据（数组、对象），则用语法2.

② 创建元素

语法：

// 动态创建了一个<li>
$("<li></li>");

③ 添加元素

• 内部添加：

// 把内容放入匹配元素内部的最后面，类似原生的appendChild方法
element.append("内容");

// 把内容放入到匹配元素内部的最前面，类似原生的insertBefore方法
element.prepend("内容");

• 外部添加：

element.after("内容")    // 把内容放入目标元素后面
element.before("内容")    // 把内容放入目标元素前面

内部添加元素，生成之后，它们是父子关系。

外部添加元素，生成之后，它们是兄弟关系。

④ 删除元素

element.remove()  // 删除匹配的元素（本身）
element.empty()  // 删除匹配的元素集合中所有的子节点
element.html("")  // 清空匹配的元素内容

7. jQuery尺寸、位置操作

① jQuery尺寸

• 以上参数为空，则是获取相应值，返回的是数字型。
• 如果参数为数字，则是修改相应值。
• 参数可以不必写单位。

② jQuery位置

位置主要有三个：offset()、position()、scrollTop()/scrollLeft()

• offset()设置或获取元素偏移值：

（1）offset()方法设置或返回被选元素相对于文档的偏移坐标，跟父级没有关系。

（2）该方法有2个属性left、top。offset().top用于获取距离文档顶部的距离，offset().left用于获取距离文档左侧的距离。

（3）可以设置元素的偏移：offset({top: 10, left: 30});

• position()获取元素偏移：

（1）position()方法用于返回被选元素相对于带有定位的父级偏移坐标，如果父级都没有定位，则以文档为准。

（2）position()方法只能获取，不能设置偏移。

• scrollTop()/scrollLeft()设置或获取元素被卷去的头部和左侧：

（1）scrollTop()方法设置或返回被选元素被卷去的头部。

（2）scrollLeft()方法设置或返回被选元素被卷去的左侧。