图像列表一般用列表管理同一位置的相关图像URL。 它可以具有rootUrl值,并且在请求个别图像时,可以请求除列表上的位置或rootUrl的相对URL。
可以在多处使用一个图像列表,并且因为各个使用位置不使用绝对图像路径,同时图像列表可以访问索引,所以可以更具体系地管理图像路径。
先注册registerImageList后,再使用图像列表。
grid.registerImageList({
name: 'images01',
rootUrl: '/images/',
items: [
'fr.png',
'br.png',
...
]
});
我们可以在GridHeader.imageList或DataColumn.imageList等指定图像列表名称, 并且可以分别从ColumnHeader.imageIndex和GridStyles.iconIndex等获取和渲染个别图像。
grid.header().setImageList('image01');
grid.setColumns([
{
header: {
// image01的第二个图像。
imageIndex: 1,
...
}
},
...
]);
grid.setColumns([
{
imageList: 'images02',
renderer: {
type: 'icon',
// image02的第二个图像。
iconIndex: 1
}
},
{
imageList: 'images03',
renderer: {
type: 'icon',
// 在image03中,注册为'jp.png'的图像。
iconIndex: 'jp.png'
}
},
...
]);