DIV CSS 佈局教程網

jQuery 中 checkbox 的 checked 取值問題:換個屬性就解決了
編輯:JQuery特效代碼     

用 jQuery 操作 checkbox 的 checked 屬性,在不同版本、不同操作時機下行為並不一致:切換狀態沒反應、取值永遠是 true、動態設定的值讀不出來……這些問題很多人遇到過。這個範例採取的策略很直接:既然 checked 難搞,那就自己加一個屬性來記狀態。

完整程式

<!DOCTYPE html>
<html><head>
<meta charset="UTF-8">
<title>修復 checkbox 的狀態切換和動態取值問題</title>
<script type="text/javascript" src="jquery.js"></script>
<style>
* { margin:0; padding:0; }
ul li { float:left; list-style:none; margin-left:20px; }
</style>
</head>
<body>
<form name="journal" id="journal" action="#" method="post">
<input name="cate_ids" value="" type="hidden">
<ul>
  <li><input checked="checked" isCheck="true" class="ckbox" value="1" name="cate_id" type="checkbox">美食1</li>
  <li><input class="ckbox" value="2" name="cate_id" type="checkbox">美食2</li>
  <li><input class="ckbox" value="3" name="cate_id" type="checkbox">美食3</li>
  <li><input checked="checked" isCheck="true" class="ckbox" value="4" name="cate_id" type="checkbox">美食4</li>
  <li><input class="ckbox" value="5" name="cate_id" type="checkbox">美食5</li>
</ul>
<div class="btn">
  <input value="確認" name="sbtn" onclick="getValues()" type="button">
</div>
</form>

<script>
// 為 checkbox 新增 isCheck 屬性,取代相容性不佳的 checked
$(".ckbox").click(function(){
  if ($(this).attr("isCheck") == "true") {
    $(this).removeAttr("isCheck");
  } else {
    $(this).attr("isCheck", "true");
  }
});

function getValues() {
  var list = "";
  $(".ckbox").each(function(){
    if ($(this).attr("isCheck") == "true") {
      list += $(this).val() + ",";
    }
  });
  alert(list);
}
</script>
</body>
</html>

它在解決什麼

關鍵是 isCheck 這個自訂屬性。每次點擊時,我們不去碰 checked,而是把 isCheck 當成一個自己維護的布林旗標:有就移除,沒有就設上。取值時也只讀 isCheck,於是「狀態切換」與「取值」這兩件事都回到完全可控的地面上。

問題的根源在哪裡

這類困擾主要來自 jQuery 版本差異。在 jQuery 1.6 之前,attr('checked') 同時承担了「HTML 初始屬性」與「當前 DOM 狀態」兩種意義;1.6 引入 prop() 之後,兩者被拆開:attr('checked') 只反映 HTML 上是否寫了 checked(且回傳字串 "checked" 而非布林值),prop('checked') 才是使用者目前是否勾選。因此同一行程式碼在 1.5 與 1.6 上跑出不同結果,並不罕見。

換句話說,這個範例用自訂屬性繞過問題,在當時確實有效;但今日更推薦的正確寫法是:

// 切換
$(".ckbox").click(function(){
  $(this).prop("checked", !$(this).prop("checked"));
});

// 取值
var list = [];
$(".ckbox").each(function(){
  if ($(this).prop("checked")) {
    list.push($(this).val());
  }
});
alert(list.join(","));

改用陣列收集再 join,也順手解決了原本字串串接會多留一個逗號的小毛病。

還有一個提醒:在自訂的 HTML 屬性上放狀態,並非不可行,但若只是要記「是否勾選」,prop('checked') 就是標準答案。自訂屬性會讓後端拿不到狀態(除非另外同步到 hidden 欄位,如範例中的 cate_ids),也容易讓接手的同事困惑。另外若要使用自訂屬性,依 HTML5 規範應加上 data- 前綴(data-is-check),以 $(this).data('isCheck') 讀取。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved