Structure des données des diapositives

ISlideData

ISlideData est le snapshot persistant d’une présentation Univer Slides. Il stocke les métadonnées de la présentation, la collection ordonnée de diapositives, les couches optionnelles de masques et de dispositions, les transitions, les thèmes et les ressources.

Propriétés obligatoires

Propriété	Type	Description
`id`	`string`	ID unique de l’unité de présentation.
`name`	`string`	Nom affiché de la présentation.
`defaultPageSize`	`ISlidePageSize`	Largeur et hauteur par défaut lorsqu’une page ne définit pas sa propre taille.
`slideOrder`	`string[]`	IDs des diapositives dans l’ordre de la présentation.
`slides`	`Record<string, ISlidePage>`	Diapositives normales indexées par ID.

Propriétés optionnelles

Propriété	Type	Description
`rev?`	`number`	Révision du snapshot.
`appVersion?`	`string`	Version d’Univer ayant produit le snapshot.
`locale?`	`LocaleType`	Locale de la présentation.
`masterPageOrder?`	`string[]`	IDs des masques dans l’ordre stocké.
`masterPages?`	`Record<string, ISlideMasterPage>`	Masques indexés par ID.
`layoutPageOrder?`	`string[]`	IDs des dispositions dans l’ordre stocké.
`layoutPages?`	`Record<string, ISlideLayoutPage>`	Dispositions indexées par ID.
`handoutMasterPageOrder?`	`string[]`	IDs des masques de documents dans l’ordre stocké.
`handoutMasterPages?`	`Record<string, ISlideHandoutMasterPage>`	Masques de documents indexés par ID.
`notesMasterPageOrder?`	`string[]`	IDs des masques de notes dans l’ordre stocké.
`notesMasterPages?`	`Record<string, ISlideNotesMasterPage>`	Masques de notes indexés par ID.
`activeSlideId?`	`string`	ID de la diapositive active.
`transitionRecords?`	`Record<string, ISlideTransition>`	Transitions réutilisables indexées par ID.
`slideTransitionRefs?`	`Record<string, string>`	Association des IDs de diapositives aux IDs de transitions.
`theme?`	`ISlideThemeData`	Thème par défaut de la présentation.
`themes?`	`Record<string, ISlideThemeData>`	Thèmes supplémentaires indexés par ID.
`zoomRatio?`	`number`	Niveau de zoom persistant de la présentation.
`resources?`	`IResources`	Ressources fournies par Slides et ses plugins fonctionnels.
`custom?`	`SlideCustomData`	Métadonnées de présentation définies par l’application.

Enregistrements de pages ordonnés

Chaque ID de slideOrder doit correspondre à une entrée de slides. Les couches optionnelles de masques, de dispositions, de masques de documents et de masques de notes suivent le même modèle de liste d’ordre et d’enregistrement indexé par ID. activeSlideId, s’il est défini, doit correspondre à une entrée de slides.

TypeScript

import type { ISlideData } from '@univerjs-pro/slides'import { PageTypeEnum } from '@univerjs-pro/slides'const slideData: ISlideData = {  id: 'deck-1',  name: 'Feuille de route produit',  defaultPageSize: { width: 960, height: 540 },  slideOrder: ['slide-1'],  slides: {    'slide-1': {      id: 'slide-1',      name: 'Ouverture',      pageType: PageTypeEnum.Slide,      elementOrder: [],      elements: {},    },  },  activeSlideId: 'slide-1',}

Utilisation

Passez un snapshot à univerAPI.createPresentation(slideData) pour restaurer une présentation. Utilisez presentation.save() pour obtenir le snapshot ISlideData actuel afin de le persister, de l’exporter, de l’imprimer ou de le traiter côté serveur.

Attention

Un snapshot est une donnée de persistance, pas le SlideModel actif. Après le démarrage de la présentation, utilisez les méthodes Facade de Slides ou des commandes enregistrées au lieu de modifier l’objet snapshot.

Que pensez-vous de ce guide ?