DIV CSS 佈局教程網

jQuery EasyUI datagrid 的 formatter 格式化函數用法
編輯:JQuery特效代碼     

要在 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 }
    ]]
});

數值格式化:toFixed 的使用

金額、比率這類欄位常需要固定小數位數,直接借重 JavaScript 原生的數字方法即可:

var num = 2.4445;
var number = num.toFixed(2);   // 格式化,保留兩位小數
alert(number);                 // 輸出 2.44

實務上的幾個要點

回傳的是 HTML 字串。formatter 的輸出會被當成 HTML 插入,因此若欄位內容來自使用者輸入,記得先做轉義,否則容易產生 XSS。

善用第二個參數。只靠 val 往往不夠,例如要根據狀態欄位決定日期要不要變色,就得從 rec 取其他欄位的值來判斷。

格式化與排序會打架。formatter 只影響顯示,排序仍以原始值進行。若想要「依格式化後的顯示值排序」,就必須改用自訂 sorter,否則使用者會看到 10 排在 9 前面的怪現象。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved