jquery 返回值

jQuery 返回值的基本概念

jQuery 方法通常返回 jQuery 对象（也称为 jQuery 集合），这种设计允许链式调用。例如，$('div').addClass('test').hide() 中，addClass() 和 hide() 都返回 jQuery 对象。

常见返回值类型

jQuery 对象
大多数 jQuery 方法返回 jQuery 对象，例如：

• $('selector')：返回匹配 DOM 元素的 jQuery 对象。
• .css()、.attr()：设置属性时返回 jQuery 对象，获取属性时返回字符串或数值。

原始值
部分方法返回非 jQuery 对象：

• .val()：获取表单元素值时返回字符串、数组或数值。
• .text()：获取文本内容时返回字符串。
• .data()：获取数据时返回存储的值（可能是任意类型）。

特殊返回值

• .ajax()：返回 jqXHR 对象（类似 Promise 的异步处理对象）。
• .each()：返回原始 jQuery 对象，但回调函数中可通过 return false 中断循环。

链式调用与返回值

由于多数方法返回 jQuery 对象，支持链式操作：

$('div')
  .css('color', 'red')
  .animate({ opacity: 0.5 })
  .addClass('highlight');

中断链式调用的方法

某些方法会返回非 jQuery 对象，导致链式调用中断：

var text = $('div').text(); // 返回字符串，无法继续链式调用

检查返回值类型

可通过 instanceof 或查看对象属性判断返回值类型：

if (ret instanceof jQuery) {
  // 是 jQuery 对象
}

注意事项

• 获取与设置操作的返回值可能不同。例如 .css('property') 返回字符串，而 .css('property', 'value') 返回 jQuery 对象。
• 部分插件可能扩展 jQuery 方法，返回值类型需参考插件文档。

通过理解 jQuery 方法的返回值特性，可以更高效地编写链式代码或处理非链式返回值。