jQuery prop() 方法（保姆级教程）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

前言

在现代 Web 开发中，jQuery 作为简化 DOM 操作的利器，其提供的 prop() 方法是开发者必须掌握的核心技能之一。无论是处理表单元素的禁用状态，还是动态修改元素的 checked 属性，prop() 方法都能提供高效且直观的解决方案。本文将从基础概念到实战案例，系统性地解析 prop() 方法的使用场景、与 attr() 的区别，以及如何通过代码示例加深理解。

一、属性与属性的区别：理解 prop() 的核心逻辑

1.1 属性（Properties）与属性（Attributes）的差异

在 HTML 中，元素的 checked、disabled、value 等特性看似简单，但实际操作时需区分「属性」和「属性」两个概念：

• 属性（Properties）：反映元素当前的实时状态，由浏览器 DOM 直接管理。例如，复选框被点击后的 checked 状态会实时更新到属性中。
• 属性（Attributes）：定义元素初始设置的静态值，存储在 HTML 标签中。例如，<input type="checkbox" checked> 中的 checked 是属性。

形象比喻：
可以将属性比作「实时体温计」，而属性是「出生时记录的身高」。即使你长大后身高变化，出生证明上的记录不会改变，但实时测量的体温会动态波动。

1.2 prop() 方法的作用

prop() 方法专门用于操作元素的 属性（Properties），例如：

// 设置按钮的 disabled 状态为 true  
$("button").prop("disabled", true);  

此操作直接修改了按钮的当前状态，使其无法被点击。

二、prop() 方法的语法与基本用法

2.1 基础语法

// 获取属性值  
$(selector).prop(property);  

// 设置属性值  
$(selector).prop(property, value);  

// 使用函数动态设置值  
$(selector).prop(property, function(index, oldValue) {  
  return newValue;  
});  

2.2 常见属性操作案例

案例 1：禁用表单元素

<button id="submit-btn">提交</button>  

// 点击按钮时禁用自身  
$("#submit-btn").click(function() {  
  $(this).prop("disabled", true);  
});  

效果：按钮在首次点击后立即失效，避免重复提交。

案例 2：切换复选框状态

<input type="checkbox" id="remember-me">  

// 反转复选框的选中状态  
$("#remember-me").prop("checked", function() {  
  return !$(this).prop("checked");  
});  

三、prop() 与 attr() 的区别：关键对比

3.1 核心差异总结

3.2 具体示例对比

<input type="checkbox" checked>  

// 使用 prop() 获取实时状态  
console.log($("input").prop("checked")); // true（如果未被用户修改）  

// 使用 attr() 获取初始值  
console.log($("input").attr("checked")); // "checked"（字符串形式）  

关键提示：

• 当需要获取或修改元素的动态状态（如表单元素值、禁用状态）时，必须使用 prop()。
• 若需操作静态属性（如 id、class 或自定义 data-* 属性），则使用 attr()。

四、进阶用法：复杂场景与最佳实践

4.1 动态处理多个属性

// 为所有链接添加 target="_blank" 并禁用  
$("a").prop({  
  target: "_blank",  
  disabled: true // 注意：链接无 disabled 属性，此操作无效  
});  

注意：并非所有 HTML 元素都支持所有属性，需查阅文档确认兼容性。

4.2 结合选择器与条件判断

// 仅对选中的复选框执行操作  
$("input:checked").prop("value", "新值");  

五、实战案例：表单验证与动态交互

5.1 场景描述

假设需要实现一个表单，要求用户必须勾选「同意协议」才能提交：

<form>  
  <input type="checkbox" id="agree"> 同意协议  
  <button type="submit">提交</button>  
</form>  

5.2 jQuery 实现

$("form").submit(function(e) {  
  e.preventDefault(); // 阻止默认提交  
  const isChecked = $("#agree").prop("checked");  
  if (!isChecked) {  
    alert("请先同意协议");  
  } else {  
    // 提交逻辑  
    console.log("表单提交成功");  
  }  
});  

六、性能优化与常见误区

6.1 性能注意事项

• 避免频繁操作 DOM：将多个 prop() 调用合并为对象形式，例如：

  $(element).prop({ checked: true, disabled: false });  
  

• 使用原生 API 时的兼容性：在某些情况下，直接使用 element.checked 可能比 prop() 更高效。

6.2 常见错误分析

• 混淆 prop() 与 attr()：例如尝试通过 attr("checked") 设置复选框状态，会导致值始终为字符串 "checked"，而非布尔值。
• 忽略元素类型限制：并非所有元素都支持 disabled 属性，如 <div> 无法被禁用。

结论

通过本文的系统性讲解，开发者应能掌握 jQuery prop() 方法的核心逻辑、使用场景及常见问题解决方案。无论是基础的表单操作，还是复杂的动态交互，prop() 都是简化代码、提升开发效率的必备工具。建议读者通过实际项目练习，逐步熟悉其与 attr() 的配合使用，并结合性能优化策略实现更高效的前端交互。

关键词布局提示（仅作参考，实际文章中无需出现）：

• "jQuery prop() 方法" 作为核心关键词，在标题、前言、章节标题及代码示例中自然出现。
• 相关变体如 "prop() 方法"、"属性操作" 在段落中合理分布，确保 SEO 友好性。