基本概念

安装 Univer Slides 之前,请先了解构成 Slides 集成基础的四个概念:

  • 插件 Plugin
  • 快照与数据模型 Snapshot and Data Model
  • 命令 Command
  • Facade API

基本概念

插件

Univer Slides 由插件组合而成。UniverSlidesPlugin 注册 UNIVER_SLIDE 演示文稿模型及其核心命令,UniverSlidesUIPlugin 则提供浏览器编辑器界面。打印、表格、图表、导入导出等可选包只需按产品需求添加。

Slides UI 在内部使用 Docs、Drawing 和 Shape 服务来编辑文本与图形。它们是 Slides 插件栈的技术依赖,不要求你使用过其他 Univer 品类。

快照与数据模型

一份演示文稿以 ISlideData 快照持久化。namedefaultPageSize 描述演示文稿,slideOrder 规定 slides 中条目的顺序,可选的复用层则存储在 masterPageslayoutPages 中。

使用 presentation.save() 获取当前快照。快照是持久化数据,不是运行时模型;演示文稿启动后直接修改快照对象不会更新编辑器。

命令

运行时的数据变更通过命令执行,使模型校验、视图更新、撤销与重做进入同一条变更链路。Slides Facade 方法会为你准备参数并执行对应命令。

注意

不要直接修改运行中演示文稿的快照。请使用 Slides Facade 方法或已注册的命令。

Facade API

在核心 Facade 入口之后导入 @univerjs-pro/slides/facade,即可把 Slides API 扩展到 FUniver。该入口提供 createPresentation()getActivePresentation()getPresentation() 等方法。

完整配置与示例请参阅 使用 Slides Facade API

接下来阅读安装和基本使用

你觉得这篇文档如何?

© 2026 DreamNum Co., Ltd.