아이템 모델

그리드 아이템(Item)은 DataProvider의 한 행이나, RowGrouping된 그룹의 헤더나 푸터 등이 그리드나 트리에서 한 라인으로 표시되는 표시 모델입니다.

아이템 모델

각 아이템은 표시되는 순서대로 index 값을 갖게 되는데, 리얼그리드 대부분의 함수들은 이 index 값을 전달하여 실행됩니다.
하지만, 표시되지 않는 아이템들 예를 들어, 감춰진 RowGroup의 아이템들이나 감춰진 Tree 아이템들은 이 index를 통해 접근할 수 없습니다.
이런 경우 등을 위해 그리드 내부의 아이템 모델 정보를 리턴하고 그 정보로 다른 모델 정보를 얻어올 수 있는 함수들을 제공합니다.

아이템 모델의 종류와 리턴

아이템 모델의 종류는 아래와 같습니다.

var ItemType = {
  ROW: "row", // 데이터 행
  GROUP: "group", // 그룹 (그룹 Header로 표시됩니다)
  FOOTER: "footer", // 그룹 Footer
  TREE: "tree" // 트리 노드 ("group" 이기도 합니다)
};

아이템 모델 정보는 아래와 같은 형태로 리턴 됩니다.

{
    type: "row",        // ItemType
    itemIndex: 0,       // 아이템 index
    dataRow: -1,        // 아이템에 연결된 데이터행. type이 "row"가 아니면 -1
    checked: false,     // 아이템 checked 여부
    id: 0,              // 내부 사용 아이디,
    parentId: 0,        // 내부 사용 아이디,
    footerId: 0,        // 내부 사용 아이디
};

모델관련 API호출시 extended를 true로 지정시 반환되는 확장 모델정보에 다음과 같은 정보가 추가됩니다.

level: 2,        // 계층 구조상 Level, 1부터 시작
childIndex: 0,   // 부모 모델내의 순서

아이템 모델 가져오기

getModel()함수는 아이템 index에 해당하는 아이템모델을 리턴 합니다.

var extended = $("#chkExtendedModel").is(":checked");
var itemIndex = gridView.getCurrent().itemIndex;
var item = gridView.getModel(itemIndex, extended);
alert(JSON.stringify(item));

getParentModel()함수는 아이템 모델의 부모 아이템 모델을 리턴 합니다.

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()함수는 아이템 모델의 최상위 조상 아이템 모델을 리턴 합니다.

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()함수는 아이템 모델의 바로 아래 자식 아이템 모델들을 리턴 합니다.

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()함수는 아이템 모델의 자식 아이템 모델을 리턴 합니다.

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()함수는 지정한 아이템 index들에 해당하는 아이템 모델들을 배열로 리턴 합니다.

var extended = $("#chkExtendedModel").is(":checked");
var items = gridView.getModels([0, 1, 2], extended);
var s = JSON.stringify(items);
alert(JSON.stringify(s));

getModelOfRow()함수는 지정한 데이터 행에 해당하는 아이템 모델을 리턴 합니다.

var extended = $("#chkExtendedModel").is(":checked");
var row = gridView.getCurrent().dataRow;
var item = gridView.getModelOfRow(row, extended);
alert(JSON.stringify(item));

getModelsOfRows()함수는 지정한 데이터 행들에 해당하는 아이템 모델들을 배열로 리턴 합니다.

var extended = $("#chkExtendedModel").is(":checked");
var items = gridView.getModelsOfRows([0, 1, 2], extended);
var s = JSON.stringify(items);
alert(JSON.stringify(s));

getGroupSummary 지정한 그룹아이템 모델의 합계 정보를 리턴 합니다.

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));
    }
  }
}

지정한 그룹아이템 모델을 expand 합니다.

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 지정한 그룹아이템 모델을 collapse 합니다.

var recursive = $("#chkCollapseRecursive").is(":checked");
var itemIndex = gridView.getCurrent().itemIndex;
var group = gridView.getModelAs(itemIndex, "group");
if (group) {
  gridView.collapseModel(group, recursive);
}

주의

• 대량의 아이템 모델을 리턴하는 함수는 메모리 사용이나 속도면에서 부담을 줄 수 있으므로, 아이템 index로 해결할 수 있는 경우라면 반드시 index 함수들을 사용해야 합니다.
  특히 확장모델정보는 저장된 값이 아니라 그때마다 계산하여 가져오는 방식이므로 더많은 부담을 줄 수 있습니다.
• 함수들에서 리턴된 모델을 다른 함수의 매개변수로 전달하게 되므로 속성 값을 수정해서는 안됩니다.
  특히, 내부 사용 아이디들은 의미있는 값으로 사용해서도 안됩니다.
• 데이터의 변경이나 혹은 Row Grouping이 새로 실행될 때, 혹은 다른 이유로 그리드나 트리의 아이템모델은 자주 갱신됩니다.
  대개의 경우 리턴된 아이템모델을 하나의 함수 밖에서 재사용하기 위해 저장하는 것은 의미가 없고 위험할 수 있습니다.