介绍配置项的设置方法,如组件状态等。

自定义功能选项

初始化时JS-SDK时,通过分别配置不同文档对应的功能选项,可以开启和关闭文档中的特定功能和控制文档打开时的状态。

注意 所有功能选项只能通过初始化配置控制,不支持热切换。
如下是文字文档的示例。
aliyun.config({
    //通用选项,所有类型文档均适用。
    commonOptions: {
      isShowTopArea: false, //隐藏顶部区域(头部和工具栏)。
    },
    //文字文档相关配置。
    wordOptions: {
      isShowDocMap: false,
      isBestScale: true
    },
    //PDF文档相关配置。
    pdfOptions: {
      isShowComment: true,
      isInSafeMode: false
    }
})
参数说明如下所示。
说明 目前暂无表格文档和演示文档的配置选项。
参数 说明
commonOptions 通用配置项,isShowTopArea表示是否显示顶部区域(头部和工具栏),配置项的值类型为Boolean,值可选true和false,请根据实际需要设置。
  • 当设置为false时,隐藏顶部区域(头部和工具栏)。
  • 当设置为true时,显示顶部区域(头部和工具栏)。
wordOptions 文字文档配置项,包括isShowDocMap和isBestScale配置项,配置项的值类型为Boolean,值可选true和false,请根据实际需要设置 。
  • isShowDocMap表示是否显示目录,默认不显示。
  • isBestScale表示打开文档时,默认以最佳比例显示。
pdfOptions PDF文档配置项,包括isShowComment和isInSafeMode配置项,配置项的值类型为Boolean,值可选true和false,请根据实际需要设置。
  • isShowComment表示是否显示注解,默认显示。
  • isInSafeMode表示是否处于安全模式,默认不是安全模式。

    当PDF文档处于安全模式下时,不能划选文字,不能复制以及不能通过链接跳转。

组件状态设置

通过设置commandBars选项, 可以隐藏或禁用页面的组件。
aliyun.config({
  commandBars: [
    //可以配置多个组件。
    {
      cmbId: "组件ID",
      attributes: [
         {name: 'visible', value: false}, //隐藏组件。
         {name: 'enable', value: false} //禁用组件,组件显示但不响应点击事件。
      ]
    }
  ]
})
commandBars选项的参数说明如下所示。
参数 说明
cmbId 目前支持如下组件ID,请根据实际需要设置。
  • 当组件类型为演示文档时,使用WPPMobileMarkButton组件ID,表示移动端浮动备注按钮。
  • 当组件类型为PDF文档时,使用PDFMobilePageBar组件ID,表示移动端页码。
attributes 包括visible和enable属性,属性值类型为Boolean,值可选true和false,请根据实际需要设置。
  • visible用于组件显示切换。
    • 当设置为false时,隐藏组件。
    • 当设置为true时,显示组件。
  • enable用于组件状态切换,禁用或开启。
    • 当设置为false时,禁用组件,组件显示但不响应点击事件。
    • 当设置为true时,开启组件,能正常响应点击事件。
以上组件状态设置只是初始化时生效,通过JS-SDK可以动态更新组件状态接口。
demo.setCommandBars([...]) //配置和初始化配置相同。