jQuery 常用API

却是无人盼落雪
435 阅读5分钟

1. jQuery 选择器

1.1 jQuery 基础选择器

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

        $('选择器'）//里面选择器直接写CSS选择器即可，但是要加引号
名称用法描述
ID 选择器$('#id')获取指定 ID 的元素
全选选择器$('*')匹配所有元素
类选择器$('.class')获取同一类 class 的元素
标签选择器$('div')获取同一类标签的所有元素
并集选择器$('div,p,li')选取多个元素
交集选择器$('li.current')交集元素

1.2 jQuery 层级选择器

名称用法描述
子代选择器$('ul>li')使用 > 号，获取亲儿子层级的元素；注意，并不会获取孙子层级的元素
后代选择器$('ul li')使用空格，代表后代选择器，获取 ul 下的所有 li 元素，包括孙子等

1.3 隐式迭代（重要）

jQuery 设置样式：$('div).css('属性','值')

遍历内部 DOM 元素（伪数组形式存储）的过程就叫做 隐式迭代。 简单理解：给匹配到的所有元素进行循环遍历，执行相应的方法，而不用我们再进行循环，简化我们的操作，方便我们调用。

        <div>
            <div>1</div>
            <div>2</div>
            <div>3</div>
        </div>
        <script>
            $('div div').css('color', 'red');
        </script>

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>li')，最近一级(亲儿子)
find(selector)$('ul').find('li');相当于 $('ul li')，后代选择器
siblings(selector)$('.first').siblings('li');查找兄弟节点，不包括自己本身
nextAll([expr])$('.first').nextAll()查找当前元素之后所有的同辈元素
prevtAll([expr])$('.last').prevAll()查找当前元素之前所有的同辈元素
hasClass(class)$('div').hasClass('protected')检查当前的元素是否含有某个特定的类，如 果有，则返回 true
eq(index)$('li').eq(2);相当于 $('li:eq(2)' )，index从 0 开始
parents()$('div').parents('.one');获取元素所有父级，然后指定其中一个父级

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

1.6 jQuery 里面的排他思想

想要多选一的效果，排他思想：当前元素（$(this)）设置样式，其余的兄弟元素（$(this).siblings()）清除样式。

        $('button').mouseover(function () {
            // 设置自己的属性
            $(this).css('background-color', 'pink')
            // 消灭其他元素的属性
            $(this).siblings().css('background-color', '');
        })

1.7 jQuery 链式编程

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

$('button').mouseover(function () {
    // 先设置自己的属性，然后消灭其他兄弟的属性
    $(this).css('background-color', 'pink').siblings().css('background-color', '');
})

2. jQuery 样式操作

2.1 操作 CSS 方法

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

  1. 参数只写属性名，则是返回属性值（带有单位的字符串）。
        $(this).css("width"); // 200px
  1. 参数是 属性名，属性值，逗号分隔，是设置一组样式，属性必须加引号，值如果是数字可以不用跟单位和引号。
        $(this).css('color', 'red');
        $(this).css("width", "300px");
  1. 参数可以是对象形式，方便设置多组样式。属性名和属性值用冒号隔开，属性可以不用加引号，如果是符合属性则必须采取驼峰命名法。
        $("div").css({
            color:  "blue",
            fontSize: 20,
            width: 400,
            height: 400,
            });

2.2 设置类样式方法

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

  1. 添加类
        $("div").addClass("current");
  1. 移除类
        $("div").removeClass("current");
  1. 切换类
        $("div").toggleClass("current");

2.3 类操作与 className 区别

  • 原生 JS 中 className 会覆盖元素原先里面的类名。
  • jQuery 里面类操作 只是对指定类进行操作（追加 & 删除），不影响原先的类名。

2.4 tab 栏切换

3. jQuery 效果

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

3.1 显示/隐藏 效果

3.1.1 显示语法 show

显示语法规范

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

3.1.2 隐藏语法 hide

隐藏语法规范

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

3.1.3 切换语法 toggle

切换语法规范

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

3.1.4 参数说明

  • 参数都可以省略，无动画直接显示。
  • speed：三种预定速度之一的字符串（'slow', 'normal', or 'fast'）或表示动画时长的毫秒数值(如：1000)。
  • easing：(Optional) 用来指定切换效果，默认是 'swing'，可用参数 'linear'。
  • fn: 回调函数，在动画完成时执行的函数，每个元素执行一次。

建议：平时一般不带参数，直接显示隐藏即可。

3.2 滑动效果 slide

3.2.1 下滑效果语法

下滑效果语法规范

        slideDown([speed,[easing],[fn]]);

3.2.2 上滑效果语法

上滑效果语法规范

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

3.2.3 滑动切换效果语法

下滑效果语法规范

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

3.2.4 参数说明

  • 参数都可以省略，无动画直接显示。
  • speed：三种预定速度之一的字符串（'slow', 'normal', or 'fast'）或表示动画时长的毫秒数值(如：1000)。
  • easing：(Optional) 用来指定切换效果，默认是 'swing'，可用参数 'linear'。
  • fn: 回调函数，在动画完成时执行的函数，每个元素执行一次。

3.3 事件切换 hover

        hover([over,] out);
        // hover(function() {}, function() {})

3.3.1 参数说明

  • over：鼠标移到元素上要触发的函数（相当于 mouseenter）
  • out：鼠标移出元素要触发的函数（相当于 mouseleave）
  • 如果只写一个函数，则鼠标经过和离开都会触发它

举例：

        $(".nav>li").hover(function() {
            $(this).children("ul").slideDown(200);
        }, function() {
            $(this).children("ul").slideUp(200);
        });

        $('.nav>li').hover(function () {
            $(this).children('ul').slideToggle('fast');
        })

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

3.4.1 动画或效果队列

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

3.4.2 停止排队 stop()

// stop()

        $('.nav>li').hover(function () {
            $(this).children('ul').stop().slideToggle('fast');
        })
  • stop() 方法用于停止动画或效果。
  • 注意：stop() 写到动画或者效果的前面， 相当于停止结束上一次的动画。

3.5 淡入淡出效果

3.5.1 淡入效果 fade

淡入效果语法规范

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

3.5.2 淡出效果

淡出效果语法规范

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

3.5.3 淡入淡出切换效果

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

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

3.5.4 参数说明

  • 参数都可以省略。
  • speed：三种预定速度之一的字符串("slow","normal", or "fast")或表示动画时长的毫秒数值(如：1000)。
  • easing：（Optional）用来指定切换效果，默认是 "swing"，可用参数 "linear"。
  • fn: 回调函数，在动画完成时执行的函数，每个元素执行一次。

3.5.5 渐进方式调整到指定的不透明度

  1. 语法
        fadeTo([[speed],opacity,[easing],[fn]])
  1. 参数说明
  • opacity：透明度和速度 speed 必须写，透明度取值 0~1 之间。
  • speed：三种预定速度之一的字符串（"slow","normal", or "fast"）或表示动画时长的毫秒数值(如：1000)，必须。
  • easing：（Optional）用来指定切换效果，默认是 "swing"，可用参数 "linear"。
  • fn: 回调函数，在动画完成时执行的函数，每个元素执行一次。

3.6 自定义动画 animate

以对象的形式去写

3.6.1 语法

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

3.6.2 参数

  • params: 想要更改的样式属性，以对象形式传递，必须写。属性名可以不用带引号， 如果是复合属性则需要采取驼峰命名法 borderLeft。 其余参数都可以省略。
  • speed：三种预定速度之一的字符串（'slow','normal', or 'fast'）或表示动画时长的毫秒数值（如：1000）
  • easing：（Optional）用来指定切换效果，默认是 'swing'，可用参数 'linear'。
  • fn：回调函数，在动画完成时执行的函数，每个元素执行一次。

4. jQuery 属性操作

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

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

  1. 获取属性语法
prop('属性');
  1. 设置属性语法
prop('属性', '属性值');

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

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

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

改方法也可以获取 H5 自定义属性，console.log($("div").attr("data-index"));

4.3 数据缓存 data()

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

  1. 附加数据语法
        data('name','value') // 向被选元素附加数据
  1. 获取数据语法
        date('name') // 向被选元素获取数据

同时，这个方法获取data-index h5自定义属性 第一个 不用写data- 而且返回的是数字型 console.log($("div").data("index"));

5. jQuery 文本属性值

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

5.1 普通元素内容 html()

相当于原生 innerHTML。

        html() // 获取元素的内容

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

5.2 普通元素文本内容 text()

相当与原生 innerText。

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

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

5.3 表单的值 val()

相当于原生 value。

        val() // 获取表单的值

        val("内容") // 设置表单的值

6. jQuery 元素操作

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

6.1 遍历元素

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

1. $("div").each()

            $("div").each(function (index, domElem) {
                $(domElem);
            });
  • each() 方法遍历匹配的每一个元素。主要用 DOM 处理。 each 每一个。
  • 里面的回调函数有 2 个参数：index 是每个元素的索引号；demElem 是每个DOM元素对象，不是jquery对象
  • 所以要想使用 jquery 方法，需要给这个 dom 元素转换为 jquery 对象：$(domElem)

2. $.each()

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

其中，object 对象可以是 DOM 对象，数组，一般对象等。

（1）当 object 为 DOM 对象：

        $.each($('li'), function (i, domElem) {
            $(domElem); // 转换为 jQuery 对象
        })

（2）当 object 为数组：

        $.each(arr, function(inbdex, value) {
            // arr 为原数组
            // index 为当前索引
            // value 为当前数组值
        })

（3）当 object 为一般对象：

        $.each(obj, function(key, value) {
            console.log(key, value);
            // obj: 对象
            // key: 对象的键
            // value: 对象的值
        })

6.2 创建元素

动态的创建了一个 <li>。

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

6.3 添加元素

1. 内部添加

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

        element.append("内容");

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

        // element.prepend("内容");
        $("ul").prepend(li);

2. 外部添加

把内容放入目标元素后面

        // element.after('内容');
        $(".test").after(div);

把内容放入目标元素前面

        // element.before("内容");
        $(".test").before(div);
  • 内部添加元素，生成之后，它们是父子关系。
  • 外部添加元素，生成之后，他们是兄弟关系。

6.4 删除元素

删除匹配的元素（本身）自杀

        element.remove();

删除匹配的元素集合中所有的子节点 杀孩子

        element.empty();

清空匹配的元素内容（修改里面内容为空的字符串） 杀孩子

        element.html("div");
  • remove 删除元素本身。
  • empt() 和 html('') 作用等价，都可以删除元素里面的内容，只不过 html 还可以设置内容。

7. jQuery 尺寸、位置操作

7.1 jQuery 尺寸

语法用法
width() / height()取得匹配元素宽度和高度值只算 width / height
innerWidth() / innerHeight()取得匹配元素宽度和高度值包含 padding
outerWidth() / outerHeight()取得匹配元素宽度和高度值包含 padding、border
outerWidth(true) / outerHeight(true)取得匹配元素宽度和高度值包含 padding、borde、margin
  • 以上参数为空，则是获取相应值，返回的是数字型。
  • 如果参数为数字，则是修改相应值。
  • 参数可以不必写单位。

7.2 jQuery 位置

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

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

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

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

可以设置元素的偏移：

        offset({ top: 10, left: 30 });

7.2.2 position() 获取元素偏移

  • position() 方法用于返回被选元素相对于带有定位的父级偏移坐标，如果父级都没有定位，则以文档为准。
  • 该方法有2个属性 left、top。position().top 用于获取距离定位父级顶部的距离，position().left 用于获取距离定位父级左侧的距离。
  • 该方法只能获取不能设置偏移。

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

  • scrollTop() 方法设置或返回被选元素被卷去的头部。
  • 不跟参数是获取，参数为不带单位的数字则是设置被卷去的头部。

举例：带有动画的返回顶部

        $(".back").click(function () {
            $("body, html").stop().animate({
                scrollTop: 0
            });
        });

不能是文档或浏览器，而是 html 和 body 做动画。

avatar
文章
阅读
粉丝