SYIDAX / DATA GRID

데이터 갱신

전체 데이터 교체와 ID 기반 트랜잭션을 지원합니다.

시작하기
데이터 갱신샘플 주문 데이터
120 rows
Grid를 불러오는 중입니다…
최근 결과

초기화 후 첫 주문 ORD-0001을 보세요. 수량은 10이고 합계는 1,200입니다.

코드 보기
현재 미리보기

사용 가이드

#

주문 수량이 바뀌었을 때 표 전체를 다시 만들 필요는 없습니다. 변경된 주문의 ID와 새 값을 전달하면 해당 행을 갱신할 수 있습니다.

직접 해보기

  1. 변경 전 값 확인

    초기화 후 첫 주문 ORD-0001을 보세요. 수량은 10이고 합계는 1,200입니다.

  2. 샘플 업데이트 누르기

    표 위의 샘플 업데이트를 누르면 첫 주문의 수량이 10만큼 늘어납니다. 한 번 누른 뒤 수량 20, 합계 2,400인지 확인하세요.

  3. 처리 결과 읽기

    표 아래 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[]기본값 undefinedRow 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>기본값 undefinedColumn 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>기본값 undefinedDefaults merged into every column def (right side wins).
이벤트2
이벤트detail 타입설명
GridRowDataChangedDetailFires after `applyTransaction` resolves its row diff.
GridCellValueChangedDetailFires 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.