資料表格最常被要求加的三個效果是:滑過整列高亮、點一下整列變色、以及點列時自動勾選該列的核取方塊。這支 Kin_Tables 函式把三件事包在一起,透過參數自訂樣式與要忽略的表頭表尾列數。
// 版本: 1.0 日期: 2007/08/01
// 備注: 需要 jQuery 庫
// 參考: Dodo(tableRowCheckboxToggle) 與 softcomplex(tigra_tables)
function Kin_Tables(
Kin_Table_GetTableMethod, // 取得 Table 的方法,功能同 $(),必填
Kin_Table_Header_Offset, // 從前面起忽略幾列(表頭),可選
Kin_Table_Footer_Offset, // 從後面起忽略幾列(表尾),可選
Kin_Table_Odd_Style, // 奇數列樣式,可選
Kin_Table_Even_Style, // 偶數列樣式,可選
Kin_Table_Hover_Style, // 滑鼠懸停樣式,可選
Kin_Table_Click_Style // 滑鼠點擊樣式,可選
){ ... }
把樣式名稱開成參數,而不是寫死在函式裡,這點設計得很好:同一個函式可以套用到配色完全不同的多張表格。
$(function(){
var Kin_Table_Config = [];
Kin_Table_Config.GetTableMethod = Kin_Table_GetTableMethod ? Kin_Table_GetTableMethod : ".Kin_Table";
Kin_Table_Config.Header_Offset = !isNaN(Kin_Table_Header_Offset) ? Kin_Table_Header_Offset : 0;
Kin_Table_Config.Footer_Offset = !isNaN(Kin_Table_Footer_Offset) ? Kin_Table_Footer_Offset : 0;
Kin_Table_Config.Odd_Style = Kin_Table_Odd_Style ? Kin_Table_Odd_Style : "odd";
Kin_Table_Config.Even_Style = Kin_Table_Even_Style ? Kin_Table_Even_Style : "even";
Kin_Table_Config.Hover_Style = Kin_Table_Hover_Style ? Kin_Table_Hover_Style : "over";
Kin_Table_Config.Click_Style = Kin_Table_Click_Style ? Kin_Table_Click_Style : "clicked";
var Kin_Table = $(Kin_Table_Config.GetTableMethod +
" tr:nth-child(n+" + eval(Kin_Table_Config.Header_Offset + 1) + ")");
這裡用 nth-child(n+N) 一次性跳過表頭,比在迴圈裡判斷索引來得乾淨。Header_Offset 為 1 時就從第二列開始選,正好避開標題列。
Kin_Table.each(function(i, row){
// 從尾端扣掉要忽略的表尾列
if (i >= Kin_Table.length - Kin_Table_Config.Footer_Offset) return false;
var Kin_Table_Row_Checkbox = $(row).find(":checkbox");
bChecked = false;
// 隔行變色
$(row).addClass(i % 2 == 0 ? Kin_Table_Config.Odd_Style : Kin_Table_Config.Even_Style);
// 懸停高亮
$(row).hover(
function(){ $(this).addClass(Kin_Table_Config.Hover_Style); },
function(){ $(this).removeClass(Kin_Table_Config.Hover_Style); }
);
// 點擊切換選取狀態,並同步該列的核取方塊
$(row).click(function(){
$(this).toggleClass(Kin_Table_Config.Click_Style);
Kin_Table_Row_Checkbox.each(function(){
this.checked = $(row).hasClass(Kin_Table_Config.Click_Style);
});
});
// 初始狀態還原:若該列核取方塊本來就是勾的,補上選取樣式
Kin_Table_Row_Checkbox.each(function(){
if(this.checked){ bChecked = true; return false; }
});
if (bChecked){
$(row).addClass(Kin_Table_Config.Click_Style);
Kin_Table_Row_Checkbox.each(function(){ this.checked = true; });
}else{
$(row).removeClass(Kin_Table_Config.Click_Style);
}
});
點擊用 toggleClass 而非直接 add。這樣同一列點第二次就會取消選取,切換邏輯不必自己維護狀態變數。
核取方塊狀態由 class 反推。點擊後先切換 class,再用 hasClass() 讀回結果寫進 checkbox。這確保了「視覺」與「資料」永遠一致,不會出現列變色了但沒勾選的情況。
初始還原很重要。表單回填(例如編輯頁從資料庫帶入已勾選的項目)後,核取方塊本來就是勾的,但列還沒有選取樣式。這段程式主動補上 class,讓畫面與資料對齊。
Kin_Tables(".data-table", 1, 1, "odd", "even", "over", "clicked");
搭配 CSS 定義這四個 class 的底色即可。若想讓整列可點擊時有手型游標,記得在 clicked 與 hover 樣式中加上 cursor: pointer。