SYIDAX / DATA GRID
데이터 갱신
전체 데이터 교체와 ID 기반 트랜잭션을 지원합니다.
데이터 갱신샘플 주문 데이터
120 rowsGrid를 불러오는 중입니다…
최근 결과
초기화 후 첫 주문 ORD-0001을 보세요. 수량은 10이고 합계는 1,200입니다.
코드 보기
현재 미리보기
코드에 포함된 샘플 데이터 · 6행
사용 가이드
#주문 수량이 바뀌었을 때 표 전체를 다시 만들 필요는 없습니다. 변경된 주문의 ID와 새 값을 전달하면 해당 행을 갱신할 수 있습니다.
직접 해보기
- 변경 전 값 확인
초기화 후 첫 주문 ORD-0001을 보세요. 수량은 10이고 합계는 1,200입니다.
- 샘플 업데이트 누르기
표 위의 샘플 업데이트를 누르면 첫 주문의 수량이 10만큼 늘어납니다. 한 번 누른 뒤 수량 20, 합계 2,400인지 확인하세요.
- 처리 결과 읽기
표 아래 applyTransaction() 결과에서 갱신 결과를 확인하세요. 다시 누르면 10씩 더해지고 실행 취소로 변경을 되돌릴 수 있습니다.
확인할 결과
대상 주문의 수량과 계산된 합계가 함께 바뀝니다. 주문 번호는 그대로이므로 같은 주문을 계속 식별할 수 있습니다.
이 예제는 브라우저의 샘플 데이터를 갱신합니다. 실제 서버 저장은 앱에서 별도로 연결해야 합니다. 새 조회 결과 전체를 보여 줄 때는 rowData에 새 배열을 전달하세요.
알아두면 쉬운 용어
- applyTransaction
- 추가·수정·삭제할 행을 묶어 Grid에 전달하는 메서드입니다.
- getRowId
- 각 행의 고유 ID를 알려 주는 함수입니다. 정렬 후 위치가 바뀌어도 같은 행을 찾는 기준이 됩니다.
핵심 API 예시
등록된 Grid 요소를 grid로 참조하는 앱 코드입니다.
// getRowId가 같은 주문을 찾는 기준입니다.
const row = grid.rowData[0];
if (row) {
const result = await grid.applyTransaction({
update: [{ ...row, quantity: Number(row.quantity) + 10 }]
});
console.log(result);
}API reference
#주요 속성
| Attribute / Property | 타입 / 기본값 | 설명 |
|---|---|---|
| rowData | GridData[]기본값 undefined | Row data — each entry is a plain object keyed by `ColumnDef.field`. Mutable so managed row drag can reassign a reordered array; the host observes the new order via the `rowMoved` event. |
| columnDefs | Array<ColumnDef | GridColumnGroupDef>기본값 undefined | Column definitions in the standard shape. entries may also be nested groups (`{ headerName, children: [...] }`) — leaves drive every existing behaviour; groups add multi-level header rows. |
| defaultColDef | Partial<ColumnDef>기본값 undefined | Defaults merged into every column def (right side wins). |
이벤트2
| 이벤트 | detail 타입 | 설명 |
|---|---|---|
GridRowDataChangedDetail | Fires after `applyTransaction` resolves its row diff. | |
GridCellValueChangedDetail | Fires once per changed cell on every `applyTransaction` update (AG Grid parity). |
메서드1
| 메서드 / 인수 | 반환 타입 | 설명 |
|---|---|---|
| transaction: RowDataTransaction<GridRow>, label?: string, opts?: { source?: GridEditSource; origin?: unknown } | Promise<ApplyRowTransactionResult<GridRow>> | Apply a row-data transaction and emit its diff. |
ColumnDef3
| ColumnDef | 타입 / 필수 여부 | 설명 |
|---|---|---|
GridFieldPath<TData>필수 | Key on the row object — used to read the cell value when no `valueGetter`. | |
string선택 | Stable public id. Falls back to `field`. | |
string선택 | Header text. Falls back to `field` when omitted. |
EXPLORE CAPABILITIES
기능별로 자세히 살펴보기
기능별 사용 상황과 설정 방법을 살펴보세요. 직접 체험하는 예제와 앱에서 연결하는 기능을 각 가이드에 안내합니다.