HaveChild (row)

상위 레벨만 먼저 조회한 후, 자식이 있을 것으로 예상되는 행에 HaveChild:true를 설정하면 MainCol 트리 컬럼에 접힌 트리 아이콘(+)이 표시됩니다.
트리 데이터가 많아 한 번에 조회하기 어려운 경우 사용합니다.
+ 아이콘을 클릭하는 시점에 loadSearchData 또는 doSearch의 parent 인자로 부모 행을 지정해 자식을 조회하여 표시합니다.

Type

boolean

Options

Example

자식이 있을 것으로 예상되는 행에 HaveChild:true를 설정하면 트리 아이콘만 표시되고, 사용자가 펼치는 시점에 자식을 동적으로 조회해 추가합니다.

// 데이터 객체에 직접 표기
sheet.loadSearchData([
    {Dept:"본부장", HaveChild: true},  // 자식 있음 → 트리 아이콘만 노출
    {Dept:"사원X"}                      // 자식 없음
]);

// 또는 동적 설정
sheet.setAttribute(row, null, 'HaveChild', true);

패턴 1 — Items 중첩 데이터

서버 응답이 이미 트리 구조(Items로 자식 중첩)인 경우, 그대로 loadSearchData에 전달합니다.

options.Cfg = { MainCol: "Dept" };

options.Events = {
    onRenderFirstFinish: function(evt) {
        // 초기 0~1레벨 데이터 — 1레벨 중 자식이 있는 행은 HaveChild:true
        evt.sheet.loadSearchData([
            {Dept:"본부장", Items:[
                {Dept:"팀장A", HaveChild: true},
                {Dept:"팀장B"}
            ]},
            {Dept:"임원A", Items:[
                {Dept:"팀장X", HaveChild: true}
            ]},
            {Dept:"사원X"}
        ]);
    },
    onBeforeExpand: function(evt) {
        var row = evt.row;
        // 캐시: 이미 자식이 로드된 경우 재조회 안 함
        if (row.childNodes && row.childNodes.length > 0) return;
        // 자식 동적 조회 (서버 호출 또는 미리 준비된 데이터)
        var children = fetchChildren(row);  // 사용자 구현
        evt.sheet.loadSearchData({data: children, parent: row});
    }
};

패턴 2 — 평탄 Level 데이터 + convertTreeData

서버 응답이 Level 컬럼을 가진 평탄 데이터인 경우, ibsheet-common.js가 제공하는 IBSheet.v7.convertTreeData()로 Items 구조로 변환 후 로드합니다 (트리 응답 규격 참고).

options.Cfg = { MainCol: "Dept" };

options.Events = {
    onRenderFirstFinish: function(evt) {
        // 초기 평탄 데이터 (Level:0=본부장/임원A/사원X, Level:1=팀장)
        var initialFlat = {
            Data: [
                {Level:0, Dept:"본부장"},
                {Level:1, Dept:"팀장A", HaveChild: true},
                {Level:1, Dept:"팀장B"},
                {Level:0, Dept:"임원A"},
                {Level:1, Dept:"팀장X", HaveChild: true},
                {Level:0, Dept:"사원X"}
            ]
        };
        evt.sheet.loadSearchData(IBSheet.v7.convertTreeData(initialFlat));
    },
    onBeforeExpand: function(evt) {
        var row = evt.row;
        if (row.childNodes && row.childNodes.length > 0) return;
        // 자식도 평탄 Level 데이터로 받아 변환 (자식의 Level은 0부터 시작)
        var childFlat = fetchChildren(row);                  // {Data:[{Level:0, ...}]} 형태
        var childTree = IBSheet.v7.convertTreeData(childFlat);
        evt.sheet.loadSearchData({data: childTree, parent: row});
    }
};

Read More

• MainCol cfg
• 트리 응답 규격
• loadSearchData method
• doSearch method
• onBeforeExpand event
• setAttribute method

Since