슬라이드 데이터 구조

ISlideData

ISlideData는 Univer 슬라이드가 하나의 프리젠 테이션에 대해 이야기하는 스냅 샷입니다. 그것은 프리젠 테이션 메타 데이터, 주문 슬라이드 컬렉션, 옵션 마스터 및 레이아웃 레이어, 전환, 테마 및 리소스를 저장합니다.

필수 속성

속성타입설명
idstring프레젠테이션 유닛의 고유 ID입니다.
namestring프레젠테이션 표시 이름입니다.
defaultPageSizeISlidePageSize페이지가 자체를 설정하지 않을 때 사용하는 폭과 높이.
slideOrderstring[]프레젠테이션 순서로 나열한 슬라이드 ID입니다.
slidesRecord<string, ISlidePage>슬라이드 ID를 키로 사용하는 일반 슬라이드입니다.

선택 속성

속성타입설명
rev?number스냅샷 리비전입니다.
appVersion?string스냅샷을 생성한 Univer 버전입니다.
locale?LocaleType프레젠테이션 로케일입니다.
masterPageOrder?string[]저장 순서로 나열한 마스터 페이지 ID입니다.
masterPages?Record<string, ISlideMasterPage>ID를 키로 사용하는 마스터 페이지입니다.
layoutPageOrder?string[]저장 순서로 나열한 레이아웃 페이지 ID입니다.
layoutPages?Record<string, ISlideLayoutPage>ID를 키로 사용하는 레이아웃 페이지입니다.
handoutMasterPageOrder?string[]저장 순서로 나열한 유인물 마스터 ID입니다.
handoutMasterPages?Record<string, ISlideHandoutMasterPage>ID를 키로 사용하는 유인물 마스터입니다.
notesMasterPageOrder?string[]저장 순서로 나열한 노트 마스터 ID입니다.
notesMasterPages?Record<string, ISlideNotesMasterPage>ID를 키로 사용하는 노트 마스터입니다.
activeSlideId?string활성 슬라이드 ID입니다.
transitionRecords?Record<string, ISlideTransition>전환 ID를 키로 사용하는 재사용 가능한 전환입니다.
slideTransitionRefs?Record<string, string>슬라이드 ID와 전환 ID의 매핑입니다.
theme?ISlideThemeData프레젠테이션 기본 테마입니다.
themes?Record<string, ISlideThemeData>테마 ID를 키로 사용하는 추가 테마입니다.
zoomRatio?number영속화되는 프레젠테이션 확대 비율입니다.
resources?IResourcesSlides 및 기능 플러그인이 제공하는 리소스입니다.
custom?SlideCustomData애플리케이션 정의 프레젠테이션 메타데이터입니다.

순서가 있는 페이지 레코드

slideOrder의 모든 ID는 slides에서 일치하는 항목이 있어야합니다. 옵션 마스터, 레이아웃, 핸드 아웃 마스터 및 노트 마스터 레이어는 동일한 패턴을 따릅니다 : 주문 배열 플러스 ID에 의해 키 입력 된 레코드. activeSlideId가 설정되면 slides에 항목으로 해결해야합니다.

TypeScript
import type { ISlideData } from '@univerjs-pro/slides'import { PageTypeEnum } from '@univerjs-pro/slides'const slideData: ISlideData = {  id: 'deck-1',  name: '제품 로드맵',  defaultPageSize: { width: 960, height: 540 },  slideOrder: ['slide-1'],  slides: {    'slide-1': {      id: 'slide-1',      name: '시작',      pageType: PageTypeEnum.Slide,      elementOrder: [],      elements: {},    },  },  activeSlideId: 'slide-1',}

사용 방법

univerAPI.createPresentation(slideData)에 스냅 샷을 전달하여 프레젠테이션을 복원하십시오. presentation.save()를 호출하여 지속, 수출, 인쇄 또는 서버 측 처리를위한 ISlideData 스냅 샷을 받으십시오.

주의

스냅샷은 영속화 데이터이며 실행 중인 SlideModel이 아닙니다. 프레젠테이션이 시작된 뒤에는 스냅샷 객체를 직접 변경하지 말고 Slides Facade 메서드나 등록된 명령을 사용하세요.

이 가이드는 어떠셨나요?

© 2026 DreamNum Co., Ltd.