Univer Slides API

La Facade Slides ajoute des objets de présentation et de diapositive à FUniver. Importez son entrée à effet de bord avant de créer l’objet API :

import { FUniver } from '@univerjs/core/facade'import '@univerjs-pro/slides/facade'const univerAPI = FUniver.newAPI(univer)

Créer et rechercher des présentations

const presentation = univerAPI.createPresentation({  id: 'quarterly-review',  name: 'Quarterly review',})const activePresentation = univerAPI.getActivePresentation()const samePresentation = univerAPI.getPresentation(presentation.getId())

createPresentation() accepte un instantané ISlideData partiel. Pour restaurer une présentation, fournissez un instantané renvoyé par save().

Manipuler l’unité de présentation

FPresentation expose l’identité, le nom, la taille de page, les diapositives, la diapositive active, les transitions, les autorisations et un instantané détaché :

presentation.setName('FY 2027 review')const opening = presentation.getSlideByIndex(0) ?? presentation.appendSlide({  name: 'Opening',})presentation.setActiveSlide(opening)const snapshot = presentation.save()

Ne modifiez pas snapshot pour mettre à jour une présentation active. Utilisez les méthodes Facade ou les commandes afin de synchroniser le rendu et l’historique.

Accéder à une diapositive

FSlide donne accès à l’arrière-plan, aux notes du présentateur, à la transition et aux éléments d’une diapositive :

const slide = presentation.getActiveSlide()if (slide) {  const elements = slide.getElements()  const notes = slide.getSpeakerNotes()}

Consultez Diapositives et mises en page, Formes et texte et Images et groupes pour les opérations détaillées.

Résoudre les cibles de commandes

Les paramètres d’un événement de commande peuvent contenir les identifiants de présentation et de diapositive. Résolvez-les sans dépendre de la sélection active :

const listener = univerAPI.addEvent(  univerAPI.Event.CommandExecuted,  ({ params }) => {    const target = univerAPI.getSlideCommandTarget(params)    console.log(target?.presentation.getId(), target?.slide.getId())  })

Libérez l’écouteur lorsque son composant hôte est supprimé.

Décharger une présentation

Déchargez une unité Slides par son identifiant lorsqu’elle n’est plus nécessaire. Détruisez l’instance racine univer uniquement lorsque toute l’application est fermée.

const presentation = univerAPI.getActivePresentation()if (presentation) {  univerAPI.disposeUnit(presentation.getId())}