아이템 모델
그리드 아이템(Item)은 DataProvider의 한 행이나, RowGrouping된 그룹의 헤더나 푸터 등이 그리드나 트리에서 한 라인으로 표시되는 표시 모델입니다.
각 아이템은 표시되는 순서대로 index 값을 갖게 되는데, 리얼그리드 대부분의 함수들은 이 index 값을 전달하여 실행됩니다.
하지만, 표시되지 않는 아이템들 예를 들어 ,감춰진 RowGroup의 아이템들이나 감춰진 Tree 아이템들은 이 index를 통해 접근할 수 없습니다.
이런 경우 등을 위해 Flash 그리드 내부의 아이템 모델 정보를 리턴하고 그 정보로 다른 모델 정보를 얻어올 수 있는 함수들을 제공합니다.
아이템 모델의 종류는 아래와 같습니다.
1
2
3
4
5
6
var ItemType = {
ROW: "row", // 데이터 행
GROUP: "group", // 그룹 (그룹 Header로 표시됩니다)
FOOTER: "footer", // 그룹 Footer
TREE: "tree" // 트리 노드 ("group" 이기도 합니다)
};
아이템 모델 정보는 아래와 같은 형태로 리턴 됩니다.
1
2
3
4
5
6
7
8
9
{
type: "row", // ItemType
itemIndex: 0, // 아이템 index
dataRow: -1, // 아이템에 연결된 데이터행. type이 "row"가 아니면 -1
checked: false, // 아이템 checked 여부
id: 0, // 내부 사용 아이디,
parentId: 0, // 내부 사용 아이디,
footerId: 0, // 내부 사용 아이디
};
모델관련 API호출시 extended를 true로 지정시 반환되는 확장 모델정보에 다음과 같은 정보가 추가됩니다.
1
2
level: 2, // 계층 구조상 Level, 1부터 시작
childIndex: 0, // 부모 모델내의 순서
extended(확장정보 포함 여부)
getModel
getModel()함수는 아이템 index에 해당하는 아이템모델을 리턴 합니다.
1
2
3
4
var extended = $("#chkExtendedModel").is(":checked");
var itemIndex = gridView.getCurrent().itemIndex;
var item = gridView.getModel(itemIndex, extended);
alert(JSON.stringify(item));
getParentModel
getParentModel()함수는 아이템 모델의 부모 아이템 모델을 리턴 합니다.
1
2
3
4
5
6
7
8
9
var extended = $("#chkExtendedModel").is(":checked");
var idx = gridView.getCurrent();
var item = gridView.getModel(idx.itemIndex);
var parent = gridView.getParentModel(item,extended);
alert(JSON.stringify(item));
if (parent) {
idx.itemIndex = parent.itemIndex;
gridView.setCurrent(idx);
}
getRootModel
getRootModel()함수는 아이템 모델의 최상위 조상 아이템 모델을 리턴 합니다.
1
2
3
4
5
6
7
8
9
10
var extended = $("#chkExtendedModel").is(":checked");
var idx = gridView.getCurrent();
var item = gridView.getModel(idx.itemIndex);
var root = gridView.getRootModel(item, extended);
console.log(JSON.stringify(root));
alert(JSON.stringify(root));
if (root) {
idx.itemIndex = root.itemIndex;
gridView.setCurrent(idx);
}
getChildModels
getChildModels()함수는 아이템 모델의 바로 아래 자식 아이템 모델들을 리턴 합니다.
1
2
3
4
5
6
7
var extended = $("#chkExtendedModel").is(":checked");
var itemIndex = gridView.getCurrent().itemIndex;
var item = gridView.getModel(itemIndex);
if (item) {
var children = gridView.getChildModels(item,extended);
alert(JSON.stringify(children));
}
getChildModel
getChildModel()함수는 아이템 모델의 자식 아이템 모델을 리턴 합니다.
1
2
3
4
5
6
7
var extended = $("#chkExtendedModel").is(":checked");
var itemIndex = gridView.getCurrent().itemIndex;
var group = gridView.getModelAs(itemIndex, "group");
if (group && group.count > 0) {
var item = gridView.getChildModel(group, 0, extended);
alert(JSON.stringify(item));
}
getModels
getModels()함수는 지정한 아이템 index들에 해당하는 아이템 모델들을 배열로 리턴 합니다.
1
2
3
4
var extended = $("#chkExtendedModel").is(":checked");
var items = gridView.getModels([0, 1, 2], extended);
var s = JSON.stringify(items);
alert(JSON.stringify(s));
getModelOfRow
getModelOfRow()함수는 지정한 데이터 행에 해당하는 아이템 모델을 리턴 합니다.
1
2
3
4
var extended = $("#chkExtendedModel").is(":checked");
var row = gridView.getCurrent().dataRow;
var item = gridView.getModelOfRow(row,extended);
alert(JSON.stringify(item));
getModelsOfRows
getModelsOfRows()함수는 지정한 데이터 행들에 해당하는 아이템 모델들을 배열로 리턴 합니다.
1
2
3
4
var extended = $("#chkExtendedModel").is(":checked");
var items = gridView.getModelsOfRows([0, 1, 2],extended);
var s = JSON.stringify(items);
alert(JSON.stringify(s));
getGroupSummary
getGroupSummary 지정한 그룹아이템 모델의 합계 정보를 리턴 합니다.
1
2
3
4
5
6
7
8
9
10
11
12
13
var idx = gridView.getCurrent();
var item = gridView.getModelAs(idx.itemIndex, "row");
if (item) {
var group = gridView.getParentModel(item);
if (group && idx.fieldIndex >= 0) {
var summary = gridView.getGroupSummary(group, idx.fieldIndex);
if (summary) {
alert(JSON.stringify(summary));
}
}
}
expandModel
지정한 그룹아이템 모델을 expand 합니다.
1
2
3
4
5
6
7
var recursive = $("#chkExpandRecursive").is(":checked");
var force = $("#chkExpandForce").is(":checked");
var itemIndex = gridView.getCurrent().itemIndex;
var group = gridView.getModelAs(itemIndex, "group");
if (group) {
gridView.expandModel(group, recursive, force);
}
collapseModel
collapseModel 지정한 그룹아이템 모델을 collapse 합니다.
1
2
3
4
5
6
var recursive = $("#chkCollapseRecursive").is(":checked");
var itemIndex = gridView.getCurrent().itemIndex;
var group = gridView.getModelAs(itemIndex, "group");
if (group) {
gridView.collapseModel(group, recursive);
}
주의
반드시 index 함수들을 사용
해야 합니다.