Guides

顶部工具栏

ToolbarConfig 控制文档界面工具栏的显示/隐藏、按钮排布以及 More 菜单项的配置。

工具栏显隐控制

可独立控制各模式工具栏的可见性：

{
  "toolbarConfig": {
    "mainToolbarVisible": true,
    "annotationToolbarVisible": true,
    "contentEditorToolbarVisible": true,
    "formToolbarVisible": true,
    "signatureToolbarVisible": true
  }
}

字段	说明
mainToolbarVisible	顶部主工具栏
annotationToolbarVisible	注释模式底部工具栏
contentEditorToolbarVisible	内容编辑模式底部工具栏
formToolbarVisible	表单模式底部工具栏
signatureToolbarVisible	签名模式底部工具栏

工具栏按钮配置

左侧与右侧按钮

toolbarLeftItems 和 toolbarRightItems 分别控制顶部工具栏的左右两侧按钮：

{
  "toolbarConfig": {
    "toolbarLeftItems": [],
    "toolbarRightItems": [
      "thumbnail",
      "search",
      "bota",
      "menu"
    ]
  }
}

可用的按钮值：

值	说明
back	返回按钮
thumbnail	缩略图
search	搜索
bota	BOTA 面板（大纲/书签/注释列表）
menu	More 菜单

More 菜单项

availableMenus 控制点击 More 按钮后显示的菜单列表：

{
  "toolbarConfig": {
    "availableMenus": [
      "viewSettings",
      "documentEditor",
      "documentInfo",
      "save",
      "watermark",
      "security",
      "flattened",
      "share",
      "openDocument",
      "snip"
    ]
  }
}

值	说明
viewSettings	阅读设置
documentEditor	页面编辑
documentInfo	文档信息
save	保存
watermark	水印
security	安全/加密
flattened	扁平化
share	分享
openDocument	打开文档
snip	截图

通过调整数组中的项和顺序，可隐藏不需要的菜单项或调整显示顺序。

画笔切换按钮

{
  "toolbarConfig": {
    "showInkToggleButton": true
  }
}

字段	说明
showInkToggleButton	注释模式下是否显示画笔/橡皮擦切换按钮

完整示例

只保留缩略图和搜索按钮，菜单中仅显示保存和分享：

{
  "toolbarConfig": {
    "mainToolbarVisible": true,
    "annotationToolbarVisible": true,
    "contentEditorToolbarVisible": false,
    "formToolbarVisible": false,
    "signatureToolbarVisible": false,
    "toolbarLeftItems": ["back"],
    "toolbarRightItems": ["thumbnail", "search", "menu"],
    "availableMenus": ["save", "share"]
  }
}

如需添加自定义按钮（修改图标/文本或添加全新功能按钮），请参考 自定义菜单按钮。