萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

ASP.NET 使用 CheckBoxList 實現單選功能:JavaScript 控制互斥邏輯

動機與場景

ASP.NET 內建 RadioButtonList 即可實現單選,但 CheckBoxList 的核取方塊外觀在某些設計需求下更符合視覺規範。本文示範如何透過 JavaScript 在 CheckBoxList 上實現「單選」行為:使用者點選某項時,自動取消其他項目的勾選狀態。

前端標記:CheckBoxList 佈局與事件綁定

<asp:CheckBoxList ID="CheckBoxList1" BorderWidth="1" runat="server" RepeatLayout="Flow">
    <asp:ListItem onclick="CheckBoxList_Click(this)" Value="Item1">Item1</asp:ListItem>
    <asp:ListItem onclick="CheckBoxList_Click(this)" Value="Item2">Item2</asp:ListItem>
    <asp:ListItem onclick="CheckBoxList_Click(this)" Value="Item3">Item3</asp:ListItem>
    <asp:ListItem onclick="CheckBoxList_Click(this)" Value="Item4">Item4</asp:ListItem>
    <asp:ListItem onclick="CheckBoxList_Click(this)" Value="Item5">Item5</asp:ListItem>
</asp:CheckBoxList>

重點:

  • RepeatLayout="Flow":產生 <span> 包裹而非 <table>,便於 JS 遍歷。
  • 每個 ListItem 綁定 onclick="CheckBoxList_Click(this)" 傳遞自身 DOM 元素。

JavaScript 互斥邏輯

<script type="text/javascript">
function CheckBoxList_Click(sender) {
    // 取得包含所有 checkbox 的容器
    var container = sender.parentNode;
    
    // 若 RepeatLayout="Table" (預設),結構為 table > tbody > tr > td > input
    // 若 RepeatLayout="Flow",結構為 span > input
    if (container.tagName.toUpperCase() == "TD") {
        container = container.parentNode.parentNode; // 往上找到 table
    }
    
    // 取得容器內所有 input[type=checkbox]
    var chkList = container.getElementsByTagName("input");
    var senderState = sender.checked; // 記住點擊項目的目標狀態
    
    // 先全部取消勾選
    for (var i = 0; i < chkList.length; i++) {
        chkList[i].checked = false;
    }
    
    // 再將點擊的項目設為原狀態 (通常為 true)
    sender.checked = senderState;
}
</script>

運作原理解析

  1. 使用者點擊某 ListItem 的核取方塊 → 觸發 onclick → 呼叫 CheckBoxList_Click(this)。
  2. 函式透過 sender.parentNode 找到共同父容器 (視 RepeatLayout 調整層級)。
  3. getElementsByTagName("input") 取得該群組所有核取方塊。
  4. 迴圈將所有 checked = false。
  5. 最後將觸發事件的 sender.checked 還原為點擊前的狀態 (通常為 true),完成單選效果。

進階考量與替代方案

  • RepeatLayout="Table" 時:需如程式碼所示多往上兩層 (td → tr → table)。
  • 伺服器端同步:若需在 PostBack 時保持單選狀態,建議在 Page_Load 或 SelectedIndexChanged 中以伺服器端程式碼再次強制清除其他項目 Selected = false。
  • jQuery 簡化版 (若專案已引用 jQuery):
    $("#CheckBoxList1 input[type=checkbox]").click(function() {
        $("#CheckBoxList1 input[type=checkbox]").not(this).prop("checked", false);
    });
  • CSS 隱藏 RadioButtonList:另一種思路是使用 RadioButtonList 但以 CSS 將原生 Radio 隱藏,改以 Label 模擬 CheckBox 外觀,語意更正確且無需 JS。

總結

透過簡單的 JavaScript 遍歷同群組核取方塊並強制互斥,即可在 CheckBoxList 上實現單選行為。此技巧相容於舊版瀏覽器且不需額外套件,適合快速修改既有介面需求。長期專案建議評估語意正確性與無障礙存取,選擇最適合的控制項與實作方式。

copyright © 萬盛學電腦網 all rights reserved