SYIDAX / DATA GRID
그룹과 집계 PRO
같은 값을 가진 행을 묶고 숫자 열을 집계합니다.
그룹과 집계샘플 주문 데이터
120 rowsGrid를 불러오는 중입니다…
옵션
아래 항목을 바꾸면 Grid와 코드에 바로 반영됩니다.
최근 결과
이 메뉴는 담당 팀별 그룹이 적용된 상태로 시작합니다. Platform·Design 등의 그룹과 숫자 열의 집계를 살펴보세요.
코드 보기
현재 미리보기
코드에 포함된 샘플 데이터 · 6행
사용 가이드
#주문을 담당 팀별로 묶고 각 팀의 수량 합계를 보고 싶을 때 사용합니다. 요약과 원본 주문을 같은 표에서 오갈 수 있습니다.
직접 해보기
- 팀별 요약 확인
이 메뉴는 담당 팀별 그룹이 적용된 상태로 시작합니다. Platform·Design 등의 그룹과 숫자 열의 집계를 살펴보세요.
- 그룹 펼치기
그룹의 펼침 버튼을 눌러 그 팀에 속한 주문을 확인하세요. 다시 누르면 상세 주문이 접힙니다.
- 원본과 비교
표 아래 데이터 분석을 원본 데이터로 바꾸면 일반 주문 목록으로 돌아갑니다. 담당 팀별 그룹을 선택하면 다시 묶입니다.
확인할 결과
팀별 합계로 전체 규모를 파악하고 필요할 때 개별 주문까지 확인할 수 있습니다.
이 샘플은 브라우저에 있는 주문을 묶습니다. 서버 그룹 조회와는 별도입니다. 피벗과 일반 그룹화를 동시에 켜지 않습니다.
알아두면 쉬운 용어
- groupBy
- 어떤 열의 같은 값을 기준으로 행을 묶을지 정합니다.
- aggFunc: sum
- 그룹에 속한 숫자를 모두 더하는 집계 방식입니다.
제품에 이 기능을 적용하려면 Pro 런타임과 유효한 라이선스가 필요합니다.
API reference
#주요 속성
| Attribute / Property | 타입 / 기본값 | 설명 |
|---|---|---|
PRO groupBy | string | string[]기본값 undefined | group rows by this column. Rows fold into expandable groups rendered as group rows with a member count; the group stage runs after filter/sort and before pagination (pages count display rows, group rows included). Unknown fields are ignored with a warning. |
나머지 속성1
| Attribute / Property | 타입 / 기본값 | 설명 |
|---|---|---|
PRO groupPanel | boolean기본값 false | show the row-group panel: a drop zone above the header. Drag a column header into it to group by that column (sets `groupBy`); the panel shows a chip for the grouped column, whose × clears the grouping. |
이벤트2
| 이벤트 | detail 타입 | 설명 |
|---|---|---|
PRO | { key: string | null; expanded: boolean } | fires when a row group expands or collapses (`key: null` = blank bucket). |
PRO | { groupBy: string | null } | fires when the row-group column changes (via the group panel). |
메서드8
| 메서드 / 인수 | 반환 타입 | 설명 |
|---|---|---|
PRO name: string, fn: (values: unknown[], rows: readonly unknown[]) => unknown | Promise<void> | register a named custom aggregation for `ColumnDef.aggFunc`. Registered names SHADOW built-ins (AG parity); re-registering a name replaces it. Invalid input warns and no-ops. |
PRO name: string | Promise<void> | remove a registered aggregation (built-ins are unaffected). |
PRO | Promise<string[]> | registered custom aggregation names (registration order). |
PRO key: string | null, expanded: boolean | Promise<void> | expand/collapse one row group. No-ops when the state already matches, grouping is inactive, or the key names no current group (arc review 222-226: unknown keys used to plant phantom collapse state + emit toggles for non-groups). Single-level: `key: null` = the blank bucket. Multi-level : `key` is a node's framed compound key (a `string`), validated against every node's key. |
PRO | Promise<void> | expand every row group. Emits one `rowGroupToggled` per group that actually changes (AG fires rowGroupOpened per node on expand/collapse-all too — arc review 222-226). Multi-level keys are framed strings; single-level blank folds back to `null` in the event. |
PRO | Promise<void> | collapse every row group (computed from the current data). |
PRO index: number | Promise<SyGridDisplayRowInfo | null> | the display-row taxonomy for ONE live display row. |
PRO options?: SyGridGroupCheckStatesOptions | Promise<SyGridGroupCheckStatesReport> | the group checkbox tri-state over the live hierarchy and the live selection. |
ColumnDef1
| ColumnDef | 타입 / 필수 여부 | 설명 |
|---|---|---|
PRO | 'sum' | 'avg' | 'min' | 'max' | 'count' | string선택 | aggregate this column over each row group (`group-by` active): the value renders in the group footer row. Built-ins: `'sum' | 'avg' | 'min' | 'max' | 'count'`; any other name resolves through `registerAggFunc` (registered names may shadow built-ins — AG `aggFuncs` parity), unknown names warn once and skip the column. Names only (no inline functions) — the declarative surface stays serialisable; functions live in the instance registry. |
EXPLORE CAPABILITIES
기능별로 자세히 살펴보기
기능별 사용 상황과 설정 방법을 살펴보세요. 직접 체험하는 예제와 앱에서 연결하는 기능을 각 가이드에 안내합니다.