Skip to main content

如何启用文档极简模式

问题描述​

需要限制用户操作范围，只允许对文档内容进行基础编辑，不显示工具栏、菜单栏等复杂界面元素。

解决方案​

使用 极简模式（Compact Mode），通过 URL 参数 mode=compact 启用。

极简模式特性​

极简模式会隐藏以下界面元素，仅保留文档编辑区：

  • ❌ 右键菜单
  • ❌ 导航栏
  • ❌ 工具栏
  • ❌ 状态栏
  • ✅ 仅支持基础内容编辑

使用方式​

在挂载文档时，在 URL 中添加 mode=compact 参数：

// 原文档 URL
const baseUrl = 'http://example.com/docs/app/local/xxx/edit/content';

// 添加极简模式参数
const compactUrl = baseUrl + '?mode=compact';

// 挂载文档
const application = await ZOfficeSDK.mount(
  compactUrl,
  '#doc1',
  true
);

代码示例​

async function mountCompactMode() {
  // 文档地址
  const docUrl = 'http://xxx/docs/app/local/752740ad/edit/content';
  
  // 启用极简模式
  const compactUrl = docUrl + '?mode=compact';
  
  // 挂载文档
  const app = await ZOfficeSDK.mount(
    compactUrl,
    '#doc-container',
    true
  );
  
  await app.ready();
  console.log('极简模式文档已加载');
}

注意事项​

  • 极简模式仅影响界面显示，不影响 JSSDK API 的调用
  • 用户仍可通过 JSSDK API 进行各种文档操作（如修改内容、插入图片等）
  • 如果 URL 中已有其他参数，使用 &mode=compact 追加参数
  • 该模式适用于表单填写、内容审阅等需要简化界面的场景

模式对比​

特性编辑模式（默认）极简模式
工具栏✅ 显示❌ 隐藏
右键菜单✅ 显示❌ 隐藏
导航栏✅ 显示❌ 隐藏
状态栏✅ 显示❌ 隐藏
内容编辑✅ 支持✅ 支持
JSSDK API✅ 支持✅ 支持
Last updated on