문서 데이터 구조
IDocumentData
IDocumentData는 Univer Docs에서 사용하는 스냅샷 형식입니다.
텍스트 본문, 문서 수준 스타일, 머리글과 바닥글, 그리기 객체, 목록, 표, 플러그인 리소스를 포함하는 완전한 문서 단위를 나타냅니다.
속성
| 속성 | 타입 | 설명 |
|---|---|---|
| id | string | 고유한 문서 단위 ID입니다. |
| rev? | number | 공동 편집에 사용되는 문서 리비전입니다. |
| locale? | LocaleType | 문서의 로캘입니다. |
| title? | string | 문서 제목입니다. |
| body? | IDocumentBody | 기본 리치 텍스트 본문입니다. 자세히 |
| documentStyle | IDocumentStyle | 문서 수준의 페이지, 레이아웃, 머리글/바닥글 및 기본 텍스트 스타일 설정입니다. |
| settings? | IDocumentSettings | zoomRatio와 같은 런타임 설정입니다. |
| resources? | IResources | 플러그인 리소스입니다. |
| disabled? | boolean | 문서가 비활성화되었는지 여부입니다. |
| headers? | IHeaders | 머리글 ID를 키로 사용하는 머리글 본문입니다. |
| footers? | IFooters | 바닥글 ID를 키로 사용하는 바닥글 본문입니다. |
| lists? | ILists | 단락 글머리 기호에서 사용하는 목록 정의입니다. |
| drawings? | IDrawings | 이미지와 같은 그리기 객체입니다. |
| drawingsOrder? | string[] | 그리기 객체의 렌더링 순서입니다. |
| tableSource? | ITables | 문서 본문에서 참조하는 표 정의입니다. |
예제
TypeScript
const documentData: IDocumentData = { id: 'doc-1', title: 'Demo Document', locale: LocaleType.EN_US, body: { dataStream: 'Hello Univer\r\n', textRuns: [ { st: 0, ed: 12, ts: { fs: 14 }, }, ], paragraphs: [ { startIndex: 12, paragraphId: 'paragraph-1', }, ], }, documentStyle: { pageSize: { width: 595, height: 842 }, marginTop: 72, marginBottom: 72, marginLeft: 72, marginRight: 72, },}용도
IDocumentData는 주로 다음 용도로 사용됩니다.
- Univer Docs 문서 만들기
- Univer Docs 스냅샷 저장하기
.docx파일 가져오기 또는 내보내기ICellData.p를 통해 Sheets 셀 안에 리치 텍스트 저장하기
스냅샷은 영구 저장되는 데이터 구조입니다. 문서가 실행 중일 때 직접 변경하지 마세요. 문서 콘텐츠를 수정하려면 Facade API 또는 명령을 사용하세요.
이 가이드는 어떠셨나요?