《Ext详解与实践》节选:自定义单元格的显示格式

有时候，需要在Grid中显示一个链接，或根据数字的大小显示不同的颜色，又或者使用固定格式显示记录编号等，这就需要自定义单元格的显示格式。在Ext的Grid可以很容易的实现自定义单元格的显示格式。在定义Grid的ColumnModel的时候，在需要自定义显示格式的列中加入参数renderer，该参数指向一个函数，在显示时会以函数返回的数据作为显示数据，例如最简单的就是定义日期的显示格式：

{header: "创建时间", width: 85, sortable: true, renderer: Ext.util.Format.dateRenderer('Y-m-d'), dataIndex: 'createtime'}

参数renderer指向的是一个函数，在函数中传入该单元格的值，函数执行后返回要显示的数据。

下面通过例子来演示一下常用的自定义格式：

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">

<head>

<title>自定义单元格的显示格式</title>

<style>

</style>

</head>

<body>

<h1 style="margin:20px 0px 0px 20px;">第4章自定义单元格的显示格式</h1>

<br />

<p>

</p>

<br />

</div>

var app={};

Ext.onReady(function(){

Ext.state.Manager.setProvider(new Ext.state.CookieProvider());

Ext.QuickTips.init();

Ext.Msg.minWidth=300;

var myData = [

[1,{text:'Ext',url:'http://extjs.com'},-10.00,'2008-01-01 12:01:01','br.gif','Atlantic Spadefish.jpg',{text:'一',tips:'提示1'}],

[2,{text:'Google',url:'http://www.google.cn'},1.00,'2008-02-16 12:01:02','fr.gif','Bat Ray.jpg',{text:'二',tips:'提示2'}],

[3,{text:'新浪',url:'http://www.sina.com.cn'},0,'2008-03-15 12:01:03','cu.gif','Blue Angelfish.jpg',{text:'三',tips:'提示3'}],

[4,{text:'雅虎',url:'http://www.yahoo.com.cn'},10.01,'2008-04-14 12:01:04','es.gif','Bluehead Wrasse.jpg',{text:'四',tips:'提示4'}],

[5,{text:'CSDN',url:'http://www.csdn.net'},200.90,'2008-05-13 12:01:05','cn.gif','Cabezon.jpg',{text:'五',tips:'提示5'}],

[6,{text:'微软',url:'http://www.microsoft.com'},-200.01,'2008-06-12 12:01:06','us.gif','California Moray.jpg',{text:'六',tips:'提示6'}]

];

var store = new Ext.data.SimpleStore({

fields: [

{name: 'id',type:'int'},

{name: 'linker'},

{name: 'number', type: 'float'},

{name: 'datetime', type: 'date', dateFormat: 'Y-m-d H:i:s'},

{name: 'icon'},

{name: 'qtips'},

{name: 'tips'}

]

});

store.loadData(myData);

function leftPad(val){

return String.leftPad(val,5,"0");

}

function linker(val){

if(typeof val=='object'){

return '<a style="display:table;width:100%;" title="'+val.url+'" target="_blank" href="'+val.url+'">'+val.text+'</a>'

}

return val;

}

function num(val){

if(val > 0){

return '<span style="color:green;">' + val + '</span>';

}else if(val < 0){

return '<span style="color:red;">' + val + '</span>';

}

return val;

}

function icon(val){

return '<img src="./images/gif/'+val+'">'

}

function qtips(val){

return '<span style="display:table;width:100%;" qtip=/'<img src="images/'+val+'">/'>'+val+'</span>'

}

function tips(val){

if(typeof val=='object'){

return '<span style="display:table;width:100%;" title="'+val.tips+'">'+val.text+'</span>'

}

return val

}

var grid = new Ext.grid.GridPanel({

height:350,

width:800,

store: store,

title:'自定义单元格的显示格式',

frame:true,

columns: [

{header:'编号',width:80, sortable: true,renderer:leftPad, dataIndex:'id'},

{header: "链接", width:75, sortable: true, renderer: linker, dataIndex: 'linker'},

{header: "数字", width:75, sortable: true,renderer: num, dataIndex: 'number'},

{header: "时间", width:85, sortable: true, renderer: Ext.util.Format.dateRenderer('Y-m-d'), dataIndex: 'datetime'},

{header: "图标", width:75, sortable: true,renderer: icon, dataIndex: 'icon'},

{header: "图片提示", width:75, sortable: true,renderer: qtips, dataIndex: 'qtips'},

{header: "文字提示", width:75, sortable: true,renderer: tips, dataIndex: 'tips'}

stripeRows: true,

autoExpandColumn: 5,

listeners:{

rowclick:function(trid,rowIndex,e){

Ext.get('op').dom.value+='------------------------/n'+

Ext.encode(store.getAt(rowIndex).data)+'/n';

}

});

grid.render('panel1');

Ext.get('op').dom.value="";

})

</script>

</body>

</html>

例子的运行结果如下图。

例子中，第1列演示了以固定长度为5位，不足5位以0补齐的格式的数字：

function leftPad(val){

return String.leftPad(val,5,"0");

}

该函数使用Ext字符串leftPad方法补0，然后将转换后的值返回。

第2列演示了如何在单元格中显示链接：

function linker(val){

if(typeof val=='object'){

return '<a style="display:table;width:100%;" title="'+val.url+'" target="_blank" href="'+val.url+'">'+val.text+'</a>'

}

return val;

}

第2列的数据使用了JSON格式的数据，如“{text:'Ext',url:'http://extjs.com'}”，标签text内的值是单元格显示的数据，而标签url的值是链接地址。在函数中先判断原始值是否为对象，如果是则使用text和url组合一个HTML标记并返回。在HTML标记中定义了两个样式，其目的是让HTML标记显示时能填满单元格，这样当鼠标移动到该单元格空白处时，也能显示提示信息。提示信息由HTML标记的title属性实现。