Univer Slides API

La Facade de Slides añade objetos de presentación y diapositiva a FUniver. Importe su entrada con efecto secundario antes de crear el objeto API:

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

Crear y buscar presentaciones

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

createPresentation() acepta una instantánea parcial ISlideData. Para restaurar una presentación, pase una instantánea devuelta por save().

Trabajar con la unidad de presentación

FPresentation expone identidad, nombre, tamaño de página, diapositivas, diapositiva activa, transiciones, permisos e instantánea independiente:

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

No modifique snapshot para actualizar una presentación activa. Use métodos Facade o comandos para mantener sincronizados el renderizado y el historial.

Entrar en una diapositiva

FSlide da acceso al fondo, las notas del presentador, la transición y los elementos de una diapositiva:

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

Consulte Diapositivas y diseños, Formas y texto e Imágenes y grupos para operaciones específicas.

Resolver destinos de comandos

Los parámetros de un evento de comando pueden incluir identificadores de presentación y diapositiva. Resuélvalos sin depender de la selección actual:

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

Libere el listener cuando se retire su componente anfitrión.

Descargar una presentación

Descargue una unidad de Slides por su ID cuando deje de necesitarla. Destruya la instancia raíz univer solo cuando se cierre toda la aplicación.

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