ASP.NET 內建 RadioButtonList 即可實現單選,但 CheckBoxList 的核取方塊外觀在某些設計需求下更符合視覺規範。本文示範如何透過 JavaScript 在 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 元素。<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>
ListItem 的核取方塊 → 觸發 onclick → 呼叫 CheckBoxList_Click(this)。sender.parentNode 找到共同父容器 (視 RepeatLayout 調整層級)。getElementsByTagName("input") 取得該群組所有核取方塊。checked = false。sender.checked 還原為點擊前的狀態 (通常為 true),完成單選效果。RepeatLayout="Table" 時:需如程式碼所示多往上兩層 (td → tr → table)。Page_Load 或 SelectedIndexChanged 中以伺服器端程式碼再次強制清除其他項目 Selected = false。$("#CheckBoxList1 input[type=checkbox]").click(function() {
$("#CheckBoxList1 input[type=checkbox]").not(this).prop("checked", false);
});
RadioButtonList 但以 CSS 將原生 Radio 隱藏,改以 Label 模擬 CheckBox 外觀,語意更正確且無需 JS。透過簡單的 JavaScript 遍歷同群組核取方塊並強制互斥,即可在 CheckBoxList 上實現單選行為。此技巧相容於舊版瀏覽器且不需額外套件,適合快速修改既有介面需求。長期專案建議評估語意正確性與無障礙存取,選擇最適合的控制項與實作方式。