SYIDAX / DATA GRID
Excel 가져오기
워크북의 시트를 읽어 그리드 데이터로 변환합니다.
Excel 가져오기샘플 주문 데이터
120 rowsGrid를 불러오는 중입니다…
최근 결과
앱에 파일 선택 UI를 만들고 선택한 파일을 ArrayBuffer로 읽으세요. 여러 시트가 있으면 가져올 시트도 선택하게 합니다.
코드 보기
현재 미리보기
코드에 포함된 샘플 데이터 · 6행
사용 가이드
#Excel 파일의 특정 시트를 읽고, 앱에서 가져올 내용을 확인한 뒤 표에 반영할 때 사용합니다.
앱에서 연결하는 순서
- 파일과 시트 선택
앱에 파일 선택 UI를 만들고 선택한 파일을 ArrayBuffer로 읽으세요. 여러 시트가 있으면 가져올 시트도 선택하게 합니다.
- 파일 해석하기
importDataFromXlsx에 파일 바이트를 전달하세요. 반환 결과와 xlsxImported 이벤트에서 변환된 열·행 데이터를 확인합니다.
- 확인 후 표에 반영
변환된 snapshot의 columnDefs와 rowData를 앱에서 Grid에 연결하세요. 열 이름과 날짜·숫자가 올바르게 해석되었는지 검토합니다.
확인할 결과
Excel 시트를 Grid가 읽을 수 있는 열과 행 데이터로 바꾸어 사용할 수 있습니다.
현재 페이지에는 Excel 가져오기 버튼이 없습니다. 상단 Excel 버튼은 내보내기입니다. 파일을 해석하는 호출과 앱의 표 데이터 갱신을 구분하세요.
알아두면 쉬운 용어
- ArrayBuffer
- 선택한 파일의 원본 바이트를 담는 형식입니다.
- snapshot
- 선택한 시트를 열 정의와 행 배열로 변환한 결과입니다.
API reference
#이벤트1
| 이벤트 | detail 타입 | 설명 |
|---|---|---|
GridXlsxImportedDetail | Fires 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. |
EXPLORE CAPABILITIES
기능별로 자세히 살펴보기
기능별 사용 상황과 설정 방법을 살펴보세요. 직접 체험하는 예제와 앱에서 연결하는 기능을 각 가이드에 안내합니다.