jQuery——常用API

目录

• 🥇选择器
• • 🥈1.1 基础选择器
  • 🥈1.2 层级选择器
  • 🥈1.3 筛选选择器
  • 🥈1.4 筛选方法
• 🥇操作样式
• • 🥈2.1 CSS 方法修改样式
  • 🥈2.2 操作类样式
  • 🥈2.3 jQuery 类操作和 className 区别
• 🥇效果
• • 🥈3.1 显示隐藏
  • 🥈3.2 滑动
  • 🥈3.3 淡入淡出
  • 🥈3.4 自定义动画
  • 🥈3.5 事件切换
  • 🥈3.6 动画队列及其停止排队方法
• 🥇属性操作
• • 🥈4.1 操作元素固有属性值 prop()
  • 🥈4.2 操作元素自定义属性值 attr()
  • 🥈4.3 数据缓存 data()
• 🥇内容文本值
• • 🥈5.1 元素内容 html()
  • 🥈5.2 元素文本内容 text()
  • 🥈5.3 表单值 val()
• 🥇元素操作
• • 🥈6.1 遍历元素
  • 🥈6.2 创建元素
  • 🥈6.3 添加元素
  • 🥈6.4 删除元素
• 🥇尺寸操作
• 🥇位置操作
• • 🥈8.1 设置或获取元素偏移 offset()
  • 🥈8.2 获取元素偏移 position()
  • 🥈8.3 设置或获取元素被卷去的头部和左侧 scrollTop()/scrollLeft()

---

🥇选择器

🥈1.1 基础选择器

名称	用法	描述
ID 选择器	$("#id")	获取指定 ID 的元素
全选选择器	$('*')	匹配所有元素
类选择器	$(".class")	获取同一类 class 的元素
标签选择器	$(".div")	获取同一类标签的所有元素
并集选择器	$("div,p,li")	选取多个元素
交集选择器	$("li.current")	交集元素

🥈1.2 层级选择器

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

🥈1.3 筛选选择器

语法	用法	描述
: 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 元素中，选择索引号为偶数的元素
: checked	$(".checkall:checked")	获取被选中的表单元素的个数

🥈1.4 筛选方法

语法	用法	描述
🎯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”)index 从 0 开始

---

🥇操作样式

🥈2.1 CSS 方法修改样式

1. 只写属性名，则返回属性值
2. 属性名和属性值要用逗号隔开，属性必须加引号，属性值是数字的时候可以不加单位和引号
3. 参数为对象形式，属性名和属性值用冒号隔开。属性名可以不加引号；如果属性值不是数字，则需要加引号。如果是复合属性则必须采取驼峰命名法

$('div').css({
    "color":"red",
     width: 400,
    "height": 400,
    backgroundColor: "red"  
})

🥈2.2 操作类样式

注意操作类里面的参数不要加点。

1. 添加类 addClass()
2. 删除类 removeClass()
3. 切换类 toggleClass()

head>
    meta charset="UTF-8">
    meta name="viewport" content="width=device-width, initial-scale=1.0">
    meta http-equiv="X-UA-Compatible" content="ie=edge">
    title>Documenttitle>
    style>
        div {
            width: 150px;
            height: 150px;
            background-color: pink;
            margin: 100px auto;
            transition: all 0.5s;
        }
        
        .current {
            background-color: red;
            transform: rotate(360deg);   
        }
    style>
    script src="jquery.min.js">script>
head>

body>
    div class="current">div>
    script>
        $(function() {
            
            
            
            
            
            
            
            
            
            $("div").click(function() {
                $(this).toggleClass("current");
            });
        })
    script>
body>

🥈2.3 jQuery 类操作和 className 区别

1. 原生 JS 中的 className 会覆盖元素原先里面的类名
2. jQuery 里面类操作只是对指定类进行操作，不影响原先的类名

body>
    div class="one">div>
    script>
    
        var one = document.querySelector(".one");
        one.className = "two";      
    script>
body>

body>
    div class="one">div>
    script>
    
        $(".one").addClass("two");  
        
    script>
body>

body>
    div class="one two">div>
    script>
        
        $(".one").removeClass("two");
         
    script>
body>

---

🥇效果

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

🥈3.1 显示隐藏

语法规范：

show([speed,[easing],[fn]])       
$("div").show();

hide([speed,[easing],[fn]])
$("div").hide();

toggle([speed,[easing],[fn]])
$("div").toggle();

参数说明：平时一般不带参数，直接显示隐藏即可 show()、hide()、toggle()

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

🥈3.2 滑动

语法规范：

slideDown([speed,[easing],[fn]])       
$("div").slideDown();

slideUp([speed,[easing],[fn]])
$("div").slideUp();

slideToggle([speed,[easing],[fn]])
$("div").slideToggle();

参数说明：

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

🥈3.3 淡入淡出

(1) 淡入淡出和切换

语法规范：

fadeIn([speed,[easing],[fn]])
$("div").fadeIn();


fadeOut([speed,[easing],[fn]])
$("div").fadeOut();


fadeToggle([speed,[easing],[fn]])
$("div").fadeToggle();

参数说明：

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

(2) 渐进方式调整到指定的不透明度

语法规范：

fadeTo(speed,opacity,[easing],[fn])
$("div").fadeTo(1000, 0.5);

参数说明：

• opacity：透明度必须写，取值 0~1 之间
• speed：三种预定速度之一的字符串 (“slow”,“normal”, or“fast”) 或表示动画时长的毫秒数值 (如：1000)。 必须写
• 其他两个同上，可以省略

🥈3.4 自定义动画

语法规范：

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

参数说明：

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

head>
    meta charset="UTF-8">
    meta name="viewport" content="width=device-width, initial-scale=1.0">
    meta http-equiv="X-UA-Compatible" content="ie=edge">
    title>Documenttitle>
    script src="jquery.min.js">script>
    style>
        div {
            position: absolute;
            width: 200px;
            height: 200px;
            background-color: pink;
        }
    style>
head>
body>
    button>动起来button>
    div>div>
    script>
        $(function() {
            $("button").click(function() {
                $("div").animate({
                    left: 500,
                    top: 300,
                    opacity: .4,
                    width: 500
                }, 500);
            })
        })
    script>
body>

🥈3.5 事件切换

语法规范：

hover([over,]out)
$("div").hover(function(){},function(){});

参数说明：

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

            
            
            
            
            


$("div").hover(function(){
    $(this).slideToggle();
})

🥈3.6 动画队列及其停止排队方法

（1）动画或效果队列

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

（2）停止排队

语法规范：

stop()

注意说明：

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

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

---

🥇属性操作

🥈4.1 操作元素固有属性值 prop()

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

（1）获取

prop("属性")


$("a").prop("href");

（2）设置

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


$("a").prop("title","我们都挺好~");

🥈4.2 操作元素自定义属性值 attr()

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

（1）获取

attr("属性")    


$("div").attr("index");

（2）设置

attr("属性","属性值")  


$("div").attr("index",4);

🥈4.3 数据缓存 data()

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

（1）附加数据

$("span").data("uname", "andy");

（2）获取数据

$("span").data("uname")

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

div index="1" data-index="2">我是 div/div>

console.log($("div").data("index"));		

🥇内容文本值

🥈5.1 元素内容 html()

	div>
        span>我是内容/span>
    /div>

$("div").html()   

	div>
        span>我是内容/span>
    /div>

$("div").html("123")   

🥈5.2 元素文本内容 text()

	div>
        span>我是内容/span>
    /div>

$("div").text()   

	div>
        span>我是内容/span>
    /div>

$("div").text("123")   

🥈5.3 表单值 val()

input type="text" value="请输入内容">

$("input").val()   

input type="text" value="请输入内容">

$("input").val("123")   

🥇元素操作

🥈6.1 遍历元素

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

①语法一（遍历 DOM 对象）

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

— —说明：

• each()方法遍历匹配的每一个元素。主要用 DOM 处理。each 每一个
• 里面的回调函数有 2 个参数: index 是每个元素的索引号,demEle 是 每个 DOM 元素，不是 jQuery 对象
• 所以想要使用 jQuery 方法，需要给这个 dom 元素转换为 jquery 对象 $(domEle)

body>
    div>1div>
    div>2div>
    div>3div>
    script>
        $(function() {
            
            
            var arr = ["red", "green", "blue"];
            $("div").each(function(i, domEle) {
                
                console.log(i);
                
                $(domEle).css("color", arr[i]);
            })
        })
    script>
body>

②语法二（遍历数组、对象）

$.each(Object,function(index,element){xxx;})

— —说明：

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

body>
    div>1div>
    div>2div>
    div>3div>
    script>
        $(function() {
            var arr = ["red", "green", "blue"];
            
             $.each($("div"), function(i, ele) {
                 console.log(i);
                 console.log(ele);
             })
             
            $.each(arr, function(i, ele) {
                 console.log(i);
                 console.log(ele);
             })
             
            $.each({
                name: "andy",
                age: 18
            }, function(i, ele) {
                console.log(i); 
                console.log(ele); 
            })
        })
    script>
body>

🥈6.2 创建元素

$("
");

var li = $("
我是后来创建的 li
");
var div =$("
我是后来的 div
")

🥈6.3 添加元素

①内部添加

把内容放入匹配元素内部最后面：element.append("内容")
把内容放入匹配元素内部最前面：element.prepend("内容")

$("ul").append(li);


$("ul").prepend(li);

②外部添加

外部添加把内容放到目标元素后面：element.after("内容")
外部添加把内容放到目标元素前面：element.before("内容")

var div = $("
我是后妈生的
");
$(".test").after(div);


$(".test").before(div);

• 内部添加元素，生成之后，它们是 父子关系
• 外部添加元素，生成之后，它们是 兄弟关系

🥈6.4 删除元素

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

$("ul").remove();       

$("ul").empty();       

$("ul").html("")      

• remove 删除元素本身
• empt() 和 html(“”) 作用等价，都可以删除元素黎曼的内容，只不过 html 还可以设置内容。

🥇尺寸操作

语法	用法
width() / height()	取得匹配元素宽度和高度值，只算 width / height
innerWidth() / innerHeight()	取得匹配元素宽度和高度值，包含 padding
outerWidth() / outerHeight()	取得匹配元素宽度和高度值，包含 padding、border
outerWidth(true) / outerHeight(true)	取得匹配元素宽度和高度值，包含 padding、border、margin

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

🥇位置操作

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

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

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

console.log($(".son").offset());
console.log($(".son").offset().top);


$(".son").offset({
    top: 200,
    left: 200
});

该方法有两个属性 left、top.
   · offset().top 用于获取距离文档顶部的距离，· offset().left 用于获取距离文档左侧的距离
    
可以设置元素的偏移：offset({top: 10, left: 30});

🥈8.2 获取元素偏移 position()

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

$(".son").position();

这个方法 只能获取偏移，不能设置偏移

该方法有 2 个属性 left、top。position().top 用于获取距离定位父级顶部的距离，position().left 用于获取距离定位父级左侧的距离。

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

可用于在制作“返回顶部”的按钮时，计算何时出现按钮
scrollTop() 方法设置或返回被选元素被卷去的头部。
不跟参数是获取，参数为不带单位的数字则是设置被卷去的头部

$(window).scroll(function() {      
                console.log($(document).scrollTop());
            });

 
 $(document).scrollTop(100);