开发文档Umo Editor Mobile核心特性

核心特性

Umo Editor Mobile 是一套面向触控场景独立设计的文档编辑器,而不是桌面端 UI 的简单裁剪版本。

它围绕“预览、编辑、保存、返回”这一条移动端主链路组织能力,并在配置语义、方法命名和扩展体系上尽量与 Umo Editor / Umo Editor Next 对齐。

核心能力

文档预览与编辑一体

  • 支持同源文档在移动端稳定预览。
  • 支持只读态、编辑态与二者之间的切换。
  • 支持 web / page 两种布局模式。
  • 支持目录、查找、更多面板、底部工具区等移动端入口。

触控交互优先

  • 导航栏、TabBar、Toolbar 和弹层面板都针对移动端操作习惯设计。 移动端特有
  • 支持分页视图下的缩放、适应宽度与手势交互。 移动端特有
  • 处理了软键盘弹出后的底部留白与输入区域遮挡问题。 移动端特有

保存状态机完整

  • 支持手动保存、自动保存、未保存检测。
  • 支持离开页面时的未保存确认与补救动作。
  • 支持保存并发合并,减少自动保存与手动保存竞态。
  • 支持保存失败后的重试、复制内容、稍后重试等恢复路径。 移动端特有

配置、事件、方法可对齐桌面端

  • 顶层配置结构尽量与桌面端统一。
  • 关键实例方法命名尽量与桌面端保持一致。
  • 关键事件覆盖了内容更新、页面设置、语言主题、阅读态/编辑态切换等高频场景。

扩展能力完整

  • 支持启用内置扩展。
  • 支持通过 disableExtensions 禁用内置扩展。
  • 支持通过 extensions 追加自定义扩展。
  • 支持通过 translations 覆盖默认文案。

适用场景

  • 移动端独立编辑器
  • H5 / WebView 文档编辑页
  • 审批、巡检、会议纪要、现场记录
  • 移动端文档预览与轻编辑
  • 与桌面端共享文档模型的多端协同系统

与桌面端的主要差异

  • 交互结构不同 移动端不同:移动端以导航栏、底部 TabBar、底部 Toolbar、面板弹层为主,而非桌面端顶部工具栏和复杂侧边区。
  • 能力重心不同 移动端不同:移动端优先保障阅读、轻量编辑、保存与返回链路;桌面端更偏复杂生产力。
  • 能力边界不同 部分不支持:打印、全屏、AI Chat、部分工具面板、部分桌面端事件/方法当前未开放,后续会逐渐补齐,更多信息见开发计划
  • 页面视图优先级不同 移动端不同:默认优先 web 布局,而不是分页布局。
  • 目录、搜索、更多等入口更偏应用化,由组件内部状态统一管理。移动端特有

阅读建议