슬라이드 페이지와 요소

ISlidePage

ISlidePage는 Univer Slides의 단일 페이지형 객체를 나타냅니다. 일반 슬라이드, 마스터, 레이아웃, 유인물 마스터, 노트 마스터는 모두 이 구조를 사용하며 pageType과 선택적 속성 블록으로 구분됩니다.

페이지 속성

속성타입설명
idstring고유한 페이지 ID입니다.
pageTypePageTypeSLIDE, MASTER, LAYOUT과 같은 페이지 종류입니다.
zIndexnumber페이지의 렌더링 순서입니다.
titlestring페이지 제목입니다.
descriptionstring페이지 설명입니다.
pageBackgroundFillIColorStyle페이지 배경 채우기입니다.
colorScheme?ThemeColorType페이지에서 사용하는 테마 색 구성표입니다.
pageElements{ [elementId: string]: IPageElement }요소 ID를 키로 사용하는 이 페이지의 요소입니다.
slideProperties?ISlideProperties일반 슬라이드 페이지의 속성입니다.
layoutProperties?ILayoutProperties레이아웃 페이지의 속성입니다.
masterProperties?IMasterProperties마스터 페이지의 속성입니다.

IPageElement

IPageElement는 페이지에 모든 성분을 위한 공유한 콘테이너입니다. 각 성분에는 변환 분야 (left, top, width, height, angle, scaleX, scaleY, flipX, flipY)의 세트가 있고 type에 의해 선정된 정확하게 1개의 내용 탑재량 있습니다.

요소 타입페이로드설명
PageElementType.SHAPEshape텍스트 및 속성을 포함한 사전 설정 또는 사용자 정의 모양.
PageElementType.IMAGEimage이미지 특성, 더하기 선택적인 placeholder 및 연결 metadata.
PageElementType.TEXTrichText리치 텍스트 요소입니다. rich 필드에 IDocumentData를 저장할 수 있습니다.
PageElementType.SPREADSHEETspreadsheet더 이상 사용되지 않는 내장 워크시트 페이로드입니다.
PageElementType.DOCUMENTdocument더 이상 사용되지 않는 내장 문서 페이로드입니다.
PageElementType.SLIDEslide더 이상 사용되지 않는 내장 슬라이드 페이로드입니다.

예제

TypeScript
const page: ISlidePage = {  id: 'slide-1',  pageType: PageType.SLIDE,  zIndex: 10,  title: 'Agenda',  description: '',  pageBackgroundFill: { rgb: 'rgb(255,255,255)' },  pageElements: {    title: {      id: 'title',      zIndex: 1,      left: 72,      top: 64,      width: 600,      height: 80,      title: 'Title',      description: '',      type: PageElementType.TEXT,      richText: {        text: 'Quarterly Review',      },    },  },}

참고

  • pageOrder는 활주가 눈에 보이는 무슨 순서에서 통제합니다; zIndex 통제 그림 순서.
  • 텍스트 요소는 일반 text 또는 richText.rich를 통한 더 풍부한 문서 데이터를 저장할 수 있습니다.
  • 대신 플러그인 소유 요소 탑재에 customBlock를 사용하여 deprecated 임베디드 페이로드를로드합니다.

이 가이드는 어떠셨나요?

© 2026 DreamNum Co., Ltd.