ToggleButtonExtender 可以直接與單一 CheckBox 搭配,用圖片取代傳統的勾選方框,視覺效果清爽很多。
但問題來了:當畫面上是 CheckBoxList 時,你沒辦法把 TargetControlID 設成 CheckBoxList 的控制項 ID。這是因為 CheckBoxList 在執行期會產生多個 CheckBox,而 Extender 需要的是單一控制項的目標。
解法是繞過宣告式設定,改用 JavaScript 逐一為每個 checkbox 動態建立 behavior:
<script src="jquery-1.3.2.js" type="text/javascript"></script>
<script type="text/javascript">
$(function () {
var CheckedImageAlternateText = "Good";
var CheckedImageUrl = "images/ToggleButton_Checked.gif";
var ImageHeight = 20;
var ImageWidth = 20;
var UncheckedImageAlternateText = "Bad";
var UncheckedImageUrl = "images/ToggleButton_unChecked.gif";
var tid = "CheckBox1_ToggleButtonExtender";
$("#CheckBoxList1 :checkbox").each(function (index) {
$create(AjaxControlToolkit.ToggleButtonBehavior, {
"CheckedImageAlternateText": CheckedImageAlternateText,
"CheckedImageUrl": CheckedImageUrl,
"ImageHeight": ImageHeight,
"ImageWidth": ImageWidth,
"UncheckedImageAlternateText": UncheckedImageAlternateText,
"UncheckedImageUrl": UncheckedImageUrl,
"id": tid + index.toString()
}, null, null, $get(this.id));
});
});
</script>
關鍵是 AjaxControlToolkit 的 $create() 函數。它能以程式化方式建立擴充器 behavior,第四個參數就是目標控制項,這裡傳入 each 迴圈中當下的 checkbox,於是每個項目都各自綁上一份 ToggleButtonBehavior。
id 之所以要附加 index,是因為 AjaxControlToolkit 要求每個 behavior 都有唯一識別碼,多個實例共用同一個 id 會出問題。
另外提醒兩點:一是 img 的替代文字(AlternateText)不只是裝飾,它同時是無障礙閱讀器朗讀的依據,請填上有意義的描述,別拿無意義的字詞充數;二是這個寫法綁死了 jQuery 與 AjaxControlToolkit 的版本組合,升級前務必先確認 $create 的簽名是否變動。