jTable 是個很方便的 jQuery 表格外掛,內建的編輯、新增、刪除按鈕已經很好用。但實務上難免要在某個欄位塞進自己的操作入口——本例要放一顆圖示,點下去展開子表格顯示該客戶的詳細資訊。
關鍵在欄位定義裡的 display 函式。它會拿到該列的資料物件 customerData,你要做的只是「建立一個 jQuery 元素、掛上事件、然後 return 出去」。
Information: {
title: 'Info',
width: '5%',
sorting: false,
edit: true,
create: true,
type: 'textarea',
display: function (customerData) {
var $img = $('<img src="content/images/document_properties.png"
title="View and edit information" />');
$img.click(function () {
$('#CustomersTableContainer').jtable('openChildTable',
$img.closest('tr'),
{
title: customerData.record.Name + ' - Information',
actions: {
listAction: 'ajax/customer_info_actions.php?action=list&searchterm='
+ customerData.record.CustomerNumber,
},
fields: {
CustomerNumber: {
title: 'Number', key: true,
create: false, edit: false, list: false
},
Information: {
title: 'information',
create: false, edit: true, list: true, type: 'textarea'
}
}
},
function (data) { // opened handler
data.childTable.jtable('load');
});
});
return $img;
}
}
$img.closest('tr') 是這段程式的樞紐。jTable 需要知道要把子表格插在哪一列底下,而 display 回呼本身不給你這資訊,所以得從被點擊的元素沿著 DOM 往上找到所屬的 tr。用 closest 而非 parent,是因為按鈕日後可能被包在 span 或 div 裡,closest 才不受層數影響。
openChildTable 的最後一個參數是 opened handler,在子表格建立完成後觸發。這裡呼叫 data.childTable.jtable('load') 是必要的,因為子表格預設不會自動載入資料,得明確告訴它去抓。
另外別忘了 return $img。少了這行,欄位會是空的——這是最容易漏掉的一步。
若你的欄位需要放多顆按鈕,做法是把它們包進一個容器再回傳,例如 var $wrap = $('<span></span>'); $wrap.append(btn1).append(btn2); return $wrap;。另外建議替每顆自訂按鈕加上 title 屬性,無障礙與可讀性都會更好。