SYIDAX / DATA GRID

Excel 가져오기

워크북의 시트를 읽어 그리드 데이터로 변환합니다.

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

앱에 파일 선택 UI를 만들고 선택한 파일을 ArrayBuffer로 읽으세요. 여러 시트가 있으면 가져올 시트도 선택하게 합니다.

코드 보기
현재 미리보기

사용 가이드

#

Excel 파일의 특정 시트를 읽고, 앱에서 가져올 내용을 확인한 뒤 표에 반영할 때 사용합니다.

앱에서 연결하는 순서

  1. 파일과 시트 선택

    앱에 파일 선택 UI를 만들고 선택한 파일을 ArrayBuffer로 읽으세요. 여러 시트가 있으면 가져올 시트도 선택하게 합니다.

  2. 파일 해석하기

    importDataFromXlsx에 파일 바이트를 전달하세요. 반환 결과와 xlsxImported 이벤트에서 변환된 열·행 데이터를 확인합니다.

  3. 확인 후 표에 반영

    변환된 snapshot의 columnDefs와 rowData를 앱에서 Grid에 연결하세요. 열 이름과 날짜·숫자가 올바르게 해석되었는지 검토합니다.

확인할 결과

Excel 시트를 Grid가 읽을 수 있는 열과 행 데이터로 바꾸어 사용할 수 있습니다.

현재 페이지에는 Excel 가져오기 버튼이 없습니다. 상단 Excel 버튼은 내보내기입니다. 파일을 해석하는 호출과 앱의 표 데이터 갱신을 구분하세요.

알아두면 쉬운 용어

ArrayBuffer
선택한 파일의 원본 바이트를 담는 형식입니다.
snapshot
선택한 시트를 열 정의와 행 배열로 변환한 결과입니다.

API reference

#

이벤트1
이벤트detail 타입설명
GridXlsxImportedDetailFires after `importDataFromXlsx` completes — payload carries the parsed snapshot.
메서드1
메서드 / 인수반환 타입설명
source: ArrayBuffer | Uint8Array, options?: { sheetName?: string; snapshot?: SheetToRowDataOptions }
Promise<XlsxImportResult>Parse an XLSX byte stream into `{ columnDefs, rowData }` and emit the `xlsxImported` event so a host can mirror the snapshot into its bound `rowData` / `columnDefs` props. Returns the parsed `XlsxImportResult` so callers can also inspect every sheet / shared strings / styles directly.