萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 依 name 屬性快速取得勾選核取方塊值

需求場景

表單中有多組同名核取方塊(`name="chkbox_id"`),需快速取得**已勾選**項目的值,並以逗號串接。

核心代碼

function getValuesByName() {
  const values = [];

  // 屬性選擇器 + :checked 偽類
  $("[name='chkbox_id']:checked").each(function () {
    values.push($(this).val());
  });

  if (values.length === 0) {
    alert("請至少選擇一項!");
    return;
  }

  alert(values.join(",")); // 或回傳供後續使用
  return values.join(",");
}

選擇器解析

選擇器片段說明
[name='chkbox_id']屬性選擇器:匹配 name 完全等於 chkbox_id 的元素
:checked偽類:僅匹配勾選狀態的 checkbox/radio
.each()遍歷 jQuery 物件集合,this 指向原生 DOM 元素
.val()取得元素 value 屬性

進階變體

取得未勾選項目

$("[name='chkbox_id']:not(:checked)").each(...)

全選 / 取消全選

$("#chkAll").on("change", function () {
  $("[name='chkbox_id']").prop("checked", this.checked);
});

取得包含 value、text、data-* 的完整物件陣列

const items = $("[name='chkbox_id']:checked").map(function () {
  return {
    value: this.value,
    text: $(this).next("label").text(),
    id: $(this).data("id")
  };
}).get(); // .get() 轉為原生陣列

原生 JS 替代方案(無 jQuery 相依)

function getCheckedValues(name) {
  return Array.from(document.querySelectorAll(`[name="${name}"]:checked`))
    .map(el => el.value);
}
// 使用
const vals = getCheckedValues("chkbox_id");

常見坑點

  • .attr("checked") 只反映初始 HTML 屬性,**不可用於判斷當前勾選狀態**;必須用 .prop("checked") 或 `:checked 選擇器。
  • 未勾選的 checkbox **不會隨表單提交**,後端無法收到其值。
  • 大量 checkbox 時,考慮使用事件委派或虛擬清單優化效能。

總結

jQuery 屬性選擇器搭配 :checked,配合 .each() 或 .map(),即可高效取得同名核取方塊的勾選值。現代專案亦可改用原生 querySelectorAll + Array.from 達成零相依目標。

copyright © 萬盛學電腦網 all rights reserved