new SpanGroupingCollection()
데이터를 특정 필드에 의거해 그룹해서 계층형(트리형)으로 저장하는 콜렉션으로 셀의 병합등을 포함하는 셀 속성 정보를 표현할 수 있는 컴포넌트입니다.
(SpanGroupingCollection를 사용할 경우 그리드에서 에디팅은 지원되지 않습니다)
Example
레이아웃은 다음과 같은 형식으로 작성됩니다.
<dataProvider>
<SpanGroupingCollection source="{$gridData}">
<grouping>
<Grouping>
<SpanGroupingField name="Year" rowSpanable="false" treeCellAttribute="{treeCellAttr}"/>
<SpanGroupingField name="Quarter" colNum="1">
<summaries>
<SpanGroupingSummaryRow cellAttribute="{headCellAttr}" label="분기합계" labelDataField="Year" rowAttribute="{sumRowAttr}">
<fields>
<SpanGroupingSummaryField dataField="Seoul" cellAttribute="{sumCellAttr}" colNum="3"/>
<SpanGroupingSummaryField dataField="Busan" cellAttribute="{sumCellAttr}" colNum="4"/>
<SpanGroupingSummaryField dataField="Incheon" cellAttribute="{sumCellAttr}" colNum="5"/>
</fields>
</SpanGroupingSummaryRow>
</summaries>
</SpanGroupingField>
</Grouping>
</grouping>
<summaries>
<SpanGroupingSummaryRow cellAttribute="{headCellAttr}" label="전체합계" labelDataField="Year" rowAttribute="{sumRowAttr}">
<fields>
<SpanGroupingSummaryField dataField="Seoul"/>
<SpanGroupingSummaryField dataField="Busan"/>
<SpanGroupingSummaryField dataField="Incheon"/>
</fields>
</SpanGroupingSummaryRow>
</summaries>
</SpanGroupingCollection>
</dataProvider>
Members
-
asyncboolean
-
refresh함수의 비동기 실행여부.
- Default Value:
- false
-
beforeSortingboolean
-
그룹핑 계산시 먼저 그룹핑 필드에 의해 소팅을 수행할 지 여부.
- Default Value:
- true
-
childrenFieldstring
-
하위 필드명 설정.
자료가 XML로 되어 있으면 하위 노드를 자동으로 감지하나, XML이 아닐 경우 하위 노드의 정보를 가지고 있는 필드를 지정할 필요가 있습니다.
이때 이 속성이 설정되어 있는 경우 속성값으로 필드를 찾아 하위 노드를 찾아 갑니다.- Default Value:
- "children"
-
groupingobject
-
데이터의 그룹핑에 사용되는 정보를 명시하는 Grouping 객체입니다.
- See:
-
sourceobject
-
SpanGroupingCollection 의 원천 데이터값입니다.
배열이나, XML이 될 수 있습니다.
그룹핑처리된 후에 source로 넣어진 값은 데이터 형식에 따라, 배열이면 ArrayCollection, XML이면 XMLListCollection이 됩니다.- See:
-
- 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getSource(), setSource(value)
-
summariesArray
-
전체 데이터에 대한 합산을 정의한 SpanSummaryRow 인스턴스의 배열입니다.
한개 또는 2개이상의 SpanSummaryRow를 정의할 수 있습니다.
Methods
-
addEventListener(type, listener)
-
type에 선언된 이벤트가 발생할 경우 이벤트를 받을 수 있는 listener 함수를 등록합니다.
Name Type Description type
string 이벤트 종류를 표현하는 문자열
listener
function 이벤트 발생시 불려질 함수
-
cancelRefresh()
-
refresh명령 해제.
refresh명령이 async에 의해 비동기로 실행될 경우 refresh명령을 해제합니다. -
refresh()
-
그룹핑의 재계산을 수행합니다.
데이터가 변경된 경우 반드시 실행해야만 재계산이 일어납니다. -
removeEventListener(type, listener)
-
type에 선언된 이벤트에 연결된 listener 함수를 제거합니다.
Name Type Description type
string 이벤트 종류를 표현하는 문자열
listener
function 이벤트 발생시 불려질 함수