트리 구현 - XML 데이터
트리뷰(TreeView)를 구현하기 위해 XML 데이터
를 사용할 수 있습니다.
XML 데이터
의 구조와 트리 구현 방법을 오른쪽 devbox에서 확인할 수 있습니다.
아래 코드는 트리를 구현하기 위한 XML형식의 데이터 입니다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
var data =
"<rows>"+
" <row icon='0' do='경기도'>"+
" <row icon='0' do='경기도' si='성남시'>"+
" <row icon='0' do='경기도' si='성남시' gu='분당구' />"+
" <row icon='0' do='경기도' si='성남시' gu='수정구'/>"+
" </row>"+
" <row icon='0' do='경기도' si='수원시'>"+
" <row icon='0' do='경기도' si='수원시' gu='팔달구' />"+
" <row icon='0' do='경기도' si='수원시' gu='영통구' />"+
" </row>"+
" <row icon='0' do='경기도' si='안양시' />"+
" <row icon='0' do='경기도' si='의정부시' />"+
" <row icon='0' do='경기도' si='김포시' />"+
" </row>"+
"</rows>";
(Only JS Support)
XML 데이터
로 트리를 구현하기 위해 아래 두 함수를 사용할 수 있습니다.
먼저 setXmlRows() 함수를 호출하여 트리를 구현해 보겠습니다.
1
2
3
// XML 데이터 입력하기
treeDataProvider.setXmlRows(data, "row", "", "icon");
treeView.expandAll();
같은 데이터를 fillXmlData() 함수를 사용해 트리를 구현해 보겠습니다.
1
2
3
4
5
6
// 데이터 지우기
treeDataProvider.clearRows();
// XML 데이터 입력하기
treeDataProvider.fillXmlData(data, {rows: "row", icon: "icon"});
treeView.expandAll();
두 함수의 실행 결과는 동일 합니다.
XML의 노드는 반드시 시작 태그(start-tag)와 끝 태그(end-tag)가 쌍을 이루어야 합니다.
1
2
3
4
5
6
7
<rows>
<row field=value> <!-- 부모 노드 -->
<row field=value /> <!-- 자식 노드 -->
...
<row field=value />
</row>
</rows>
부모 노드(위에서 rows tag)
의 시작 태그와 끝 태그 사이에 들어 있는 또 다른 노드는 자식 노드(위에서 row tag)
를 의미하게 됩니다.
이 데모의 데이터에서 주목할 부분은 row
라는 이름의 노드(node 또는 엘리먼트 element)
입니다.
이 노드는 트리의 계층구조를 표현하기 위한 엘리먼트(element)
입니다.
아래는 TreeDataProvider.setXmlRows()함수의 정의 입니다.
위 속성명인 'rows'
는 이 함수의 두 번째 인자인 rowsElement
의 값으로 넘겨 주어야
1
function setXmlRows(xml, rowElement, childrenField, iconField) {}
아래는 TreeDataProvider.fillXmlData()함수의 정의 입니다.
두 번째 인자인 options
즉 DataFillOptions의
rows
속성의 값으로 위 속성명인 'rows'
를 넘겨 주어야 합니다.
1
function fillXmlData(data, options) {}
RealGrid 튜토리얼에 계층 구조 표현을 위한 데이터 구조에 대해 좀더 자세히 다루고 있는 문서들이 있습니다. 아래 링크를 참조하세요.
트리뷰(TreeView)에는 각 노드에 아이콘을 표시할 수 있습니다.
아래 트리 구현 함수들에서는 함수의 마지막 인자인 iconField
에 트리컬럼에 표시할 아이콘의 index값이
들어 있는 필드명을 입력합니다. 이 필드에 들어있는 값이 트리노드의 기본 아이콘 인덱스(icon index)
가 됩니다.
또 다른 트리 구현 함수인 아래 함수들에서는 두 번째 인자인 options
즉, DataFillOptions의
rows
속성의 값으로 위 속성명인 'rows'
를 넘겨 주어야 합니다.
트리뷰에서 사용할 아이콘의 목록을 ImageList로 작성하고 만들어진 ImageList를 TreeView.registerImageList()함수로 TreeView에 등록하면 아이콘 필드에 입력된 index값에 해당 하는 아이콘에 트리노드에 표시됩니다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
// 이미지 리스트 만들기
var imgFiles = [
"kr.png",
"br.png",
"fr.png",
"mx.png",
"pt.png",
"es.png",
"gb.png",
"us.png",
"ve.png",
"icon_folder_col",
"icon_folder_exp"
];
var imageList = new RealGridJS.ImageList("images", "/resource/image/smallflag/");
imageList.addUrls(imgFiles);
// 트리뷰에 이미지 리스트 등록하기
treeView.registerImageList(imageList);
treeView.setTreeOptions({
iconImages: imageList.getName(),
iconWidth: 20
});
트리 노드의 아이콘 인덱스(icon index)
를 가져오고 지정하기 위해
함수를 사용합니다.
1
2
3
4
5
6
7
8
9
10
// 현재 노드의 아이콘을 9 또는 10으로 변경하기
var current = treeView.getCurrent();
if (current && current.dataRow) {
var iidx = treeDataProvider.getIconIndex(current.dataRow);
if (iidx == 9) {
treeDataProvider.setIconIndex(current.dataRow, 10);
} else {
treeDataProvider.setIconIndex(current.dataRow, 9);
}
}