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

自定义功能选项

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

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

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

组件状态设置

通过设置commandBars选项,可以隐藏或禁用页面的组件。

不同版本使用的数据结构如下所示。
  • V1.1.2及以上版本
    //从V1.1.2版本开始使用新的数据结构。
    aliyun.config({
      commandBars: [
        //可以配置多个组件。
        {
          cmbId: "组件ID",
          attributes: {
            visible: false, //隐藏组件。
            enable: false, //禁用组件,组件显示但不响应点击事件。
          }
        }
      ]
    })
  • V1.1.1版本
    //V1.1.1版本使用的数据结构。
    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([...]) //配置和初始化配置相同。