イメージリストは大概に同一の位置に存在する、互いに関わりのあるイメージ達の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'
}
},
...
]);