要在 EasyUI 的資料表格裡客製每個儲存格的呈現方式,靠的就是 formatter 屬性。它是一個函數,接收兩個參數:
value:該欄位目前的儲存格值record:目前列的完整記錄資料$('#tt').datagrid({
title: 'Formatting Columns',
width: 550,
height: 250,
url: 'datagrid_data.json',
columns: [[
{ field: 'itemid', title: 'Item ID', width: 80 },
{ field: 'productid', title: 'Product ID', width: 80 },
{ field: 'listprice', title: 'List Price', width: 80, align: 'right',
formatter: function(val, rec){
if (val < 20){
return '<span style="color:red;">(' + val + ')</span>';
} else {
return val;
}
}
},
{ field: 'unitcost', title: 'Unit Cost', width: 80, align: 'right' },
{ field: 'attr1', title: 'Attribute', width: 100 },
{ field: 'status', title: 'Status', width: 60 }
]]
});
金額、比率這類欄位常需要固定小數位數,直接借重 JavaScript 原生的數字方法即可:
var num = 2.4445; var number = num.toFixed(2); // 格式化,保留兩位小數 alert(number); // 輸出 2.44
回傳的是 HTML 字串。formatter 的輸出會被當成 HTML 插入,因此若欄位內容來自使用者輸入,記得先做轉義,否則容易產生 XSS。
善用第二個參數。只靠 val 往往不夠,例如要根據狀態欄位決定日期要不要變色,就得從 rec 取其他欄位的值來判斷。
格式化與排序會打架。formatter 只影響顯示,排序仍以原始值進行。若想要「依格式化後的顯示值排序」,就必須改用自訂 sorter,否則使用者會看到 10 排在 9 前面的怪現象。