For AI agents: the complete documentation index is available at https://a3s-lab.github.io/Office/docs/0.1.0/llms.txt, the full documentation bundle is available at https://a3s-lab.github.io/Office/docs/0.1.0/llms-full.txt, and this page is available as Markdown at https://a3s-lab.github.io/Office/docs/0.1.0/components/presentation.md.

PresentationEditor

PresentationEditor 使用类型化场景图保存幻灯片,只在编辑文本框时挂载 TipTap。

属性

属性类型必填默认值说明
contentPresentationContent受控演示文稿内容。
onChange(content: PresentationContent) => void返回完整的新演示文稿。
previewbooleanfalse只读演示文稿。
saveStatusstring'Saved automatically'由宿主管理的保存状态。
fileActionsreadonly OfficeFileAction[][]宿主文件操作。
kernelWasmUrlstring内置内核吸附、对齐与几何计算内核地址。
onAgentRequest(request: EditorAgentRequest) => void | Promise<void>把幻灯片或对象上下文发送给宿主 AI 流程。
onStartSlideshow() => void内置放映开始后通知宿主。
theme'light' | 'dark' | 'system''system'配色模式。

内容结构

字段类型说明
type'presentation'内容类型标识。
slidesWorkSlide[]幻灯片、元素、备注、批注与切换效果。
width, heightnumber演示文稿画布尺寸。
mastersWorkPresentationMaster[]母版背景与元素。
layoutsWorkPresentationLayout[]关联母版的版式、占位符与继承元素。

稳定的宿主接入应使用 fileActionsonAgentRequestonStartSlideshow。内部场景命令运行时不是公共 Extension API。

内置放映

观众模式与演讲者模式共用同一组导航控件。方向键和 Page Up / Page Down 切换 幻灯片,空格前进,Home 与 End 跳到首尾,Escape 退出。焦点位于放映按钮时这些 快捷键仍然有效,输入框和可编辑内容则保留正常键盘行为。

演讲者模式显示当前页、下一页提示、演讲者备注和可暂停计时器。计时器属于同一次放映, 切换观众与演讲者模式不会归零。手机宽度下,当前幻灯片保持全宽,下一页缩为标题提示, 备注可以独立滚动,导航控件仍然可用。