jQuery常用API

396 阅读6分钟

目标

  • 能够写出常用的jQuery选择器
  • 能够操作jQuery样式
  • 能够写出常用的jQuery动画
  • 能够操作jQuery属性
  • 能够操作jQuery元素
  • 能够操作jQuery元素尺寸、位置

目录

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

1. jQuery 选择器

1.1 jQuery 基础选择器

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

$('选择器') // 里面选择器直接写CSS选择器即可,但是要加引号
  • ID选择器: $('#id')
  • 全选选择器: $('*')
  • 类选择器: $('.class') // 获取同一类class的元素
  • 标签选择器: $('div') // 获取同一标签的所有元素
  • 并集选择器: $('div,p,li') // 选取多个元素
  • 交集选择器: $('li.current') // 交集元素

1.2 jQuery 层级选择器

  • 子代选择器:$('ul>li'); 使用>号,获取亲儿子层级的元素;注意,并不会获取孙子层级的元素

  • 后代选择器: $('ul li'); 使用空格,代表后代选择器,获取ul下的所有li元素,包括孙子等。

知识铺垫

jQuery设置样式

$('div').css('属性','值')

1.3 隐式迭代(重要)

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

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

1.4 jQuery 筛选选择器

  • :first: $("li:first") // 获取第一个li元素
  • :last:$('li:last') // 获取最后一个li元素
  • :eq(index): $('li:eq(2)') // 获取到的li元素中,选择索引号为2的元素,索引号index从0开始
  • :odd: $('li:odd') // 获取到的li元素中,选择索引号为奇数的元素
  • :even: $('li:even') // 获取到的li元素中,选择索引号为偶数的元素

1.5 jQuery 筛选方法(重点)

  • parent(): $("li").parent(); // 查找父级

  • children(selector): ("ul").children("li);//相当于("ul").children("li); // 相当于("ul>li"),最近一级(亲儿子)

  • find(selector): ("ul").find("li");//相当于("ul").find("li"); // 相当于("ul li"),后代选择器

  • siblings(selector): $(".first").siblings("li"); // 查找兄弟节点,不包括自己本身

  • nextAll([exprl]): $(".first").nextAll() // 查找当前元素之后所有的同辈元素

  • prevtAll([expr]): $(".first").nextAll() // 查找当前元素之后所有的同辈元素

  • hasClass(class): $('div').hasClass('protected') // 检查当前的元素是否含有某个特定的类,如果有,则返回true

  • eq(index): (li).eq(2);//相当于('li').eq(2); // 相当于("li:eq(2)"),index从0开始

重点记住:parent() children() find() siblings() eq()

1.6 jQuery 里面的排他思想

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

$(this).css();
$(this).siblings().css();

2. jQuery 样式操作

2.1 操作css方法

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

  1. 参数只写属性名,则是返回属性值
$(this).css("color");
  1. 参数是属性名,属性值,逗号分隔,是设置一组样式,属性必须加引号,值如果是数字可以不用跟单位和引号
$(this).css("color", "red");
  1. 参数可以是对象形式,方便设置多组样式。属性名和属性值用冒号隔开,属性可以不用加引号,属性值非数值类型的需要加引号
$(this).css({
	width:400,
    height:400,
    backgroundColor:"pink"
    // 如果是复合属性必须驼峰命名法
});

2.2 设置类样式方法

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

  1. 添加类 addClass()
$("div").addClass("current");

注意:在原生js的className属性中会覆盖原元素的类名,而addClass()是添加类名,不会有覆盖类名的操作。

  1. 删除类 removeClass()
$("div").removeClass("current");
  1. 切换类 toggleClass()
$("div").toggleClass("current");

3. jQurey 效果

jQuery给我们封装了很多动画效果,最为常见的如下:

显示隐藏

  • show()
  • hide()
  • toggle()

滑动

  • slideDown()
  • slideUp()
  • slideToggle()

淡入淡出

  • fadeIn()
  • fadeOut()
  • fadeToggle()
  • fadeTo()

自定义动画

  • animate()

3.1 显示隐藏效果

1. 显示语法规范

show([speed,[easing],[fn]])

2. 显示参数l

(1) 参数都可以省略,无动画直接显示

(2) speed:三种预定速度之一的字符串(“slow","nomal",or "fast")或表示动画时长的毫秒数(如:1000)。

(3) easing:(Optional)用来指定切换效果,默认是"swing"(慢-快-慢),可用参数"linear"。

(4)fn: 回调函数,在动画完成时执行的函数,每个元素执行一次。

3. 隐藏语法规范

hide([speed,[easing],[fn]])

4. 隐藏参数

与显示参数一致。

5. 切换语法规范

toggle([speed,[easing],[fn]])

3.2 滑动效果

1. 下滑效果语法规范

slideDwon([speed,[easing],[fn]])

2. 上滑效果语法规范

slideUp([speed,[easing],[fn]])

3. 滑动切换效果语法规范

slideToggle([speed,[easing],[fn]])

3.3 事件切换

hover([over],out)
  • over:鼠标移到元素上要触发的函数(相当于mouseenter)
  • out:鼠标移出元素要触发的函数(相当于mouseleave)

注意:如果只写一个函数,鼠标经过和离开都会触发。

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

1. 动画或效果队列

动画或者效果一旦触发就会执行,如果多次触发,就造成多个动画或者效果排队执行。

2. 停止排队

stopp()
  • stop()方法用于停止动画或效果。
  • 注意:stop()必须写到动画或者效果的前面,相当于停止结束上一次的动画。

3.5 淡入淡出效果

1. 淡入效果语法规范

fadeIn([speed,[easing],[fn]])

2. 淡出效果语法规范

fadeOut([speed,[easing],[fn]])

3. 淡入淡出切换效果语法规范

fadeToggle([speed,[easing],[fn]])

渐进方式调整到知道的不透明度

fadeTo([speed].opacity,[easing],[fn]])
效果参数
  • opacity 透明度必须写,取值0~1之间
  • speed:三种预定速度之一的字符串("slow","normal",or"fast")或表示动画时长的毫秒数。必须写
  • easing:(Optional)用来指定切换效果,默认是"swing",可用参数"linear"。

3.6 自定义动画 animate

1. 语法

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

2. 参数

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

4. jQuery 属性操作

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

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

1. 获取属性语法

prop("属性")

2. 设置属性语法

prop("属性","属性值"

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

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

1. 获取属性语法

attr("属性") // 类似原生 getAttribute()

2. 获取属性语法

attr("属性", "属性值") // 类似原生 setAttribute()

改2方法也可以获取H5 自定义属性

4.3 数据缓存 data()

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

1. 附加数据语法

data("name","value") // 向被选元素附加数据

2. 获取数据语法

data("name") // 向被选元素获取数据

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

:checked 选择器
$("element:checked") 查找被选中的表单元素

5. jQuery 内容文本值

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

5.1 普通元素内容 html() (相当于原生innerHTML)

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

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

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

5.3 表单的值val() (相当于原生value)

 val()			// 获取元素的value
val("内容")		// 设置元素的value
查询祖先元素
$(this).parents("祖先元素类名");
保留n位小数方法
.toFixed(2)

6. jQuery 元素操作

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

6.1 遍历元素

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

语法1:

$("div").each(function(index, doEle) {xxx;})
  1. each() 方法遍历匹配的每一个元素。主要用DOM处理。each每一个
  2. 里面的回调函数有2个参数:index是每个元素的索引号;demEle是每个DOM元素对象,不是jquery对象 **3. 所以要想使用jQuery方法,想要给这个dom元素转换为jQuery对象$(domEle)

语法2:

$.each(function(index, element) {xxx;})
  1. $.each() 方法可用于遍历任何对象。主要用于数据处理,比如数组,对象
  2. 里面的回调函数有2个参数:index是每个元素的索引号、element 遍历内容

6.2 创建元素

语法:

$("<li></li>");

动态的创建了一个<li>

6.3 添加元素

1. 内部添加

element.append("内容")

把内容放入匹配元素内部最后面,类似原生appendChild

element.prepend("内容")

把内容放入匹配元素内部最前面。

2. 外部添加

element.after("内容") // 把内容放入目标元素后面
element.before("内容") // 把内容放入目标元素前面
1. 内部添加元素,生成之后是父子关系
2. 外部添加元素,生成之后是兄弟关系

6.4 删除元素

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

7. jQuery 尺寸、位置操作

7.1 jQuery 尺寸

语法:

  • width()/height() 取得匹配元素宽度和高度值 只算 width/height
  • innerWidth()/innerHeight() 取得匹配元素宽度和高度值 包含 padding
  • outerWidth()/outerHeight() 取得匹配元素宽度和高度值 包含 padding、border
  • outerWidth(true)/outerHeight(true) 取得匹配元素宽度和高度值 包含 padding、border、margin
	// 1. width() / height() 获取设置元素 widthheight大小
            console.log($("div").width()); // 不包括padding
            //  $("div").width(300); 

            // 2. innerWidth() / innerHeight() 获取设置元素 widthheight + padding 大小
           console.log($("div").innerWidth());// 不含边框

            // 3.  outerWidth()/outerHeight() 获取设置元素 widthheight + padding + border 大小
            console.log($("div").outerWidth()); // 不含margin

            // 4.  outerWidth(true)/outerHeight(true) 获取设置元素 widthheight + padding + border + margin大小
            console.log($("div").outerWidth(true));

  • 以上参数为空,会获取对应值,返回的是数字型
  • 如果参数为数字,会修改对应值
  • 参数不需要写单位

7.2 jQuery 位置

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

1. offset() 设置或获取元素偏移

  1. offset()方法设置或返回被选元素相对于文档的偏移坐标,跟父级没有关系。
  2. 该方法有2个属性left、top。offset().top 用于获取距离文档顶部的距离,offset().left用于获取距离文档左侧的距离。
  3. 可以设置元素的偏移:offset({top:10,left:30});

2. position() 获取元素偏移

  1. position() 方法用于返回被选元素相对于带有定位的父级偏移坐标,如果父级都没有定位,则以文档为准。
  2. position() 方法仅能用于获取,不能设置元素偏移。

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

  1. scrollTop() 方法设置或返回被选元素被卷去的头部
  2. scrollLeft() 方法设置或返回被选元素被卷去的左侧
案例:带有动画的返回顶部
  1. 核心原理:使用animate动画返回顶部
  2. animate动画函数里面有个scrollTop属性,可以设置位置
  3. 但是只有元素做动画,因此$("body,html").animate(scrollTop:0)
<div class="back">返回顶部</div>
    <div class="container"></div>
    <script>
        $(function() {
           $(window).scroll(function() {
            //   console.log( $(document).scrollTop());
            if( $(document).scrollTop() >= $(".container").offset().top) {
                $(".back").fadeIn();
            } else {
                $(".back").fadeOut();
            }
           });
           $(".back").on("click", function() {
            //    $(document).scrollTop(0);
               $("body, html").stop().animate({scrollTop:0});
           });
        });// 不能是文档,而是html和body做动画

    </script>