开发文档Umo Editor Mobile自定义扩展基础介绍

基础介绍

Umo Editor Mobile 基于 Tiptap 构建,支持通过内置扩展、自定义扩展和禁用扩展机制来调整能力边界。

与 Umo Editor / Umo Editor Next 相比,移动端扩展体系依然保持一致的 Tiptap 思路,但最终开放的 UI 与交互入口更偏向触控场景。

当前支持的扩展方式

使用内置扩展

移动端内置了大量常用扩展,包括但不限于:

  • 列表、任务列表、缩进、对齐、行高、字间距
  • 图片、音频、视频、文件、链接
  • 表格、分页符、目录、脚注、文本框、标签、提及
  • Callout、列布局、代码块、网页嵌入、ECharts
  • SearchReplace、OfficePaste、Selection、NodeSelect 等工具型扩展

完整清单见内置扩展列表

禁用内置扩展

可以通过 disableExtensions 禁用内置扩展。

const options = {
  disableExtensions: ['toc', 'mention', 'tag'],
}

追加自定义扩展

可以通过 extensions 追加业务自定义扩展。

const options = {
  extensions: [myExtension],
}

更多方式见编写自定义扩展

与桌面端的主要差异

  • 扩展交互入口不同 移动端不同:即使底层扩展同名,移动端也可能通过底部工具栏、导航按钮或弹层来触发,而不是桌面端工具栏。
  • 并非所有桌面端扩展能力都完全暴露 部分不支持:部分桌面端生产力功能虽然在数据层可兼容,但移动端 UI 和文档入口可能未完全提供。
  • 移动端更依赖“可禁用 + 可追加”两套机制来裁剪功能边界。 移动端特有

UI 相关说明

  • 如果您只是接入扩展能力,优先关注 extensionsdisableExtensions
  • 如果需要更深度的能力接入,建议同时参考移动端源码中的 src/extensions 目录。