HOWTO · jQuery
用 jQuery 检查复选框是否被选中
了解如何使用 jQuery 检查复选框当前是否选中,涵盖直接访问 DOM、`.prop()` 和 `.is(':checked')`,以及复选框组和表单中的实用处理方式。
本页内容
要使用 jQuery 检查复选框当前是否选中,请读取其 DOM checked 属性。可以用 .prop('checked') 直接获取状态,用 .is(':checked') 按选择器进行判断,也可以通过 .get(0).checked(或 [0].checked)访问选中的 DOM 节点。HTML checked 属性表示复选框的初始状态,不会跟踪之后的用户操作。(.get())
通过直接访问 DOM 检查复选框是否已选中
jQuery 选择结果是一个由匹配元素组成的集合。.get(0) 会返回底层 DOM 元素中的第一个元素,其 checked 属性是表示当前状态的布尔值。也可以用数组形式的 [0] 访问同一个元素。只有在选择结果中确实包含要检查的复选框时,才使用这两种方式。
运行以下示例:
本节中的代码以及显示的标签或输出仍为英文。
const checkbox = { checked: true };
console.log(checkbox.checked ? "Checked" : "Not checked");
Checked
在已加载 jQuery 的页面中,也可以用 $("#terms").get(0).checked 进行同样的检查。下面的浏览器源代码展示了包含复选框和按钮的写法;它是页面源代码,不是运行时输出。
<!doctype html>
<html lang="en">
<body>
<label><input id="terms" type="checkbox"> Accept the terms</label>
<button id="check" type="button">Check state</button>
<p id="result" aria-live="polite"></p>
<script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>
<script>
$("#check").on("click", function () {
const isChecked = $("#terms").get(0).checked;
$("#result").text(isChecked ? "The box is checked." : "The box is not checked.");
});
</script>
</body>
</html>
如果一个选择结果可能匹配多个元素,.get(0) 仍然只会返回第一个匹配项。如果没有匹配项,索引 0 处就没有可供读取的复选框。若要检查所有匹配项,可以遍历集合;若只需判断是否至少有一个匹配项已选中,则可以使用 .is(':checked')。
使用 .prop() 检查复选框是否已选中
使用 .prop('checked') 可以读取所选元素当前的选中状态:
$("#terms").prop("checked")
对于单个复选框,已选中时该 getter 返回 true,否则返回 false。jQuery 集合可能包含多个元素;getter 会读取第一个匹配元素的属性。如果结果必须表示某个特定控件的状态,请明确选择该复选框。
setter 会更改当前状态:$("#terms").prop("checked", true) 会选中复选框,传入 false 则会取消选中。要查询当前状态时使用 getter;要更改状态时使用 setter。相同的属性访问方式也适用于其他实时控件属性,例如按钮的 disabled。有关此属性访问方式,请参阅 jQuery .prop() 文档。
使用 .is() 和 :checked 检查复选框是否已选中
:checked 选择器会匹配已选中的复选框和单选按钮,详见 jQuery 选择器文档。.is(':checked') 会返回一个布尔值,表示所选 jQuery 集合中是否至少有一个元素匹配该选择器。另请参阅 .is() 文档:
$("#terms").is(":checked")
当问题是某个选中的复选框当前是否已勾选时,这种写法一目了然。例如,$("input[name='choice']").is(":checked") 会在该命名分组中至少有一个复选框已选中时返回 true。而选择器 $("input:checked") 会创建一个包含所有已选中输入项的 jQuery 集合;它本身不会返回布尔值。
按 ID 选择时,属性值中不要包含井号:使用 $("#terms") 或 $("input[id='terms']"),不要使用 $("input[id='#terms']")。# 属于 ID 选择器语法,不属于元素的 id 属性值。
使用 jQuery 处理复选框的常见场景
以下模式读取当前 checked 属性,可根据需要改用自己的 ID、类名和表单结构。
按 ID 或类名选择
检查一个已知复选框时,可以使用 ID:$("#terms").prop("checked")。如果一组复选框共用一个类名,可以遍历匹配项,逐个查看控件状态:
例如,$(".option").each(function () { console.log(this.id + ": " + (this.checked ? "checked" : "not checked")); }); 会遍历每个匹配项。在页面中,请确保复选框输入元素使用了该类名,并且代码在这些元素存在之后运行。在 .each() 内,this 是当前 DOM 元素,因此它的 checked 属性表示当前复选框的状态。
仅在复选框已选中时取消选中
setter 可以直接取消控件的选中状态。如果目标只是确保复选框未选中,就不必先检查状态:
$("#terms").prop("checked", false)
如果只有在复选框原先已选中时才需要执行其他操作,请先用 if ($("#terms").is(":checked")) { ... } 检查,再将其属性设为 false。
检查集合中的所有项或任意项是否已选中
对于一组复选框,.is(':checked') 可以判断是否有任意匹配项已选中。若要求所有项都已选中,可以比较已选中的匹配项数量与该组复选框总数:
例如,const $options = $("input.option[type='checkbox']"); const allChecked = $options.length > 0 && $options.filter(":checked").length === $options.length; const anyChecked = $options.is(":checked"); 会计算这两个结果。
length > 0 条件会让“全部已选中”在选择器没有匹配到任何复选框时返回 false。对于表单分组,这通常是更实用的解释。只有在应用明确需要其他空集合处理方式时,才选择不同的策略。
根据复选框状态启用提交按钮
应在复选框状态变化时更新按钮,而不是等用户点击可能处于禁用状态的按钮后再更新:
例如,定义 const update = () => $("#submit").prop("disabled", !$("#terms").is(":checked"));,用 $("#terms").on("change", update) 绑定事件,并在绑定后调用一次 update()。这样页面加载时会应用初始状态,用户切换复选框时按钮状态也会同步更新。请将 #submit 替换为表单中实际的提交控件选择器。
HTML checked 属性会在页面初始化时设置复选框的默认选中状态。实时 DOM checked 属性则反映用户操作或脚本更改后的当前状态。.attr('checked') 读取该属性;需要当前状态时,请使用 .prop('checked') 或 .is(':checked')。因此,对复选框而言,.attr() 和 .prop() 回答的是不同问题。