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()方法设置或返回被选元素被卷去的左侧。
