ExtJS GridPanel 的 renderer 函數提供豐富參數,可實現單元格內容動態格式化、嵌入 HTML、綁定事件等高階功能。以下完整範例示範兩種渲染器寫法。
<html>
<head>
<title>Ext Grid 單元格渲染示例</title>
<link rel="stylesheet" type="text/css" href="../../resources/css/ext-all.css">
<script src="../../adapter/ext/ext-base.js"></script>
<script src="../../ext-all.js"></script>
<script>
Ext.onReady(function() {
// 渲染器 1:僅使用 value 參數
function renderSex(value) {
if (value === 'male') {
return "<span style='color:red;font-weight:bold;'>紅男</span><img src='user_male.png' />";
} else {
return "<span style='color:green;font-weight:bold;'>綠女</span><img src='user_female.png' />";
}
}
// 渲染器 2:使用所有參數(value, cellmeta, record, rowIndex, colIndex, store)
function renderDescn(value, cellmeta, record, rowIndex, colIndex, store) {
var str = "<input type='button' value='查看詳細信息' onclick='alert(\"" +
"這個單元格的值是:" + value + "\\n" +
"這個單元格的配置是:{cellId:" + cellmeta.cellId + ",id:" + cellmeta.id + ",css:" + cellmeta.css + "}\\n" +
"這個單元格對應行的record是:" + record + ",一行的數據都在裡邊\\n" +
"這是第" + rowIndex + "行\\n" +
"這是第" + colIndex + "列\\n" +
"這個表格對應的Ext.data.Store在這裡:" + store + ",隨便用吧。" +
"\")'>";
return str;
}
var cm = new Ext.grid.ColumnModel([
{header: '編號', dataIndex: 'id'},
{header: '性別', dataIndex: 'sex', renderer: renderSex},
{header: '名稱', dataIndex: 'name'},
{header: '描述', dataIndex: 'descn', width: 200, renderer: renderDescn}
]);
var data = [
['1','male','name1','descn1'],
['2','female','name2','descn2'],
['3','male','name3','descn3'],
['4','female','name4','descn4'],
['5','male','name5','descn5']
];
var store = new Ext.data.Store({
proxy: new Ext.data.MemoryProxy(data),
reader: new Ext.data.ArrayReader({}, [
{name: 'id'}, {name: 'sex'}, {name: 'name'}, {name: 'descn'}
])
});
store.load();
new Ext.grid.GridPanel({
autoHeight: true,
renderTo: 'grid',
store: store,
cm: cm
});
});
</script>
</head>
<body>
<div id="grid"></div>
</body>
</html>
| 參數 | 說明 |
|---|---|
value | 單元格原始資料值 |
cellmeta | 元資料物件,可設定 css (TD class)、attr (HTML 屬性字串) |
record | 該行完整的 Ext.data.Record 物件,可存取同行其他欄位 |
rowIndex | 行索引 (0-based) |
colIndex | 列索引 (0-based) |
store | 對應的 Ext.data.Store 實例 |
cellmeta.css = 'my-custom-class';editor 配置實現雙擊編輯。tpl 或 XTemplate。