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

      • PresentationEditor

      PresentationEditor uses a typed scene graph for slides and mounts TipTap only while a text box is being edited.

      Properties

      PropertyTypeRequiredDefaultDescription
      contentPresentationContentYes—Controlled presentation content.
      onChange(content: PresentationContent) => voidYes—Emits the complete next presentation.
      previewbooleanNofalseRead-only presentation surface.
      saveStatusstringNo'Saved automatically'Host-owned save status.
      fileActionsreadonly OfficeFileAction[]No[]Host file actions.
      kernelWasmUrlstringNopackaged kernelSnapping, alignment, and geometry-kernel URL.
      onAgentRequest(request: EditorAgentRequest) => void | Promise<void>No—Sends slide or object context to the host AI flow.
      onStartSlideshow() => voidNo—Notifies the host after built-in playback starts.
      theme'light' | 'dark' | 'system'No'system'Color mode.

      Content contract

      FieldTypeDescription
      type'presentation'Content discriminator.
      slidesWorkSlide[]Slides, elements, notes, comments, and transitions.
      width, heightnumberPresentation canvas dimensions.
      mastersWorkPresentationMaster[]Master backgrounds and elements.
      layoutsWorkPresentationLayout[]Master-linked layouts, placeholders, and inherited elements.

      Use fileActions, onAgentRequest, and onStartSlideshow for stable host integration. The internal scene-command runtime is not a public extension API.

      Built-in slideshow

      The slideshow keeps one shared navigation strip in audience and presenter modes. Arrow keys and Page Up/Page Down move between slides, Space advances, Home and End jump to the deck boundaries, and Escape exits playback. These commands remain active when a slideshow control has focus, while text inputs and editable content retain their normal keyboard behavior.

      Presenter mode shows the current slide, next-slide cue, speaker notes, and a pauseable timer. The timer belongs to the playback session, so switching between audience and presenter modes does not reset elapsed time. At phone widths, the current slide stays full-width, the next-slide preview compacts to its title cue, notes remain scrollable, and the same navigation strip remains available.