easyui datagrid 表格組件列屬性formatter和styler使用方法

明確單元格DOM結構

要想弄清楚formatter和styler屬性是怎么工作的，首先要弄清楚datagrid組件內容單元格的DOM接口，注意，這里指的是內容單元格，不包括標題單元格，標題單元格的結構有所區別。我們所有內容單元格的默認DOM結構如下：

<td field="code">
    <div style="text-align:left" class="datagrid-cell datagrid-cell-c1-code">
       	 文字
    </div>
</td>

很簡單，其實只是兩層結構，td標簽的field屬性便是字段的編碼，而單元格內容統一用一個div包裹起來，在我舉的這個例子中，div標簽有個 text-align樣式，這個樣式其實是由列屬性align決定的，同時div標簽的class屬性值並不是一個定值，需要注意一下。

 

理解formatter是什么

顧名思義，formatter是格式化的意思，也就是以何種形式呈現的意思，對於一個純文本，我可以將它呈現為checkbox，也可以呈現為 input輸入框，甚至下拉框等等，或者是在文本外層包裹更多的DOM(當然包裹這樣做並沒有多大意義)，這就是formatter的真正意義。

定義示例:

formatter: function(value, row, index){
    if (value == "007") {
        return '<font color="red">' + value + '</font>';
    }
    else {
        return value;
    }
}

使用formatter需要注意以下幾點：

• 無論formatter出何種形式，格式化出的DOM一定都是被包含在默認的div標簽內
• 在寫formatter函數時要保證有值返回，否則單元格沒有內容可展示，所以if的時候別忘了else
• formatter函數不會作用在列屬性checkbox為true的單元格上，checkbox列是組件預留的。

理解styler是什么

顧名思義，styler是樣式的意思，聽起來跟formatter容易混淆，其實它只是利用jQuery的css函數修改默認td標簽的樣式，所以styler屬於低能兒，只能定義單元格的背景色等，而且往往被默認的div標簽樣式覆蓋。

定義示例：

styler: function(value, row, index){
    if (value == "007") {
        return 'background-color:blue;';
    }
}