显示模式
通过初始化配置选项类,开启不同的显示模式:
var demo = COSDocPreviewSDK.config({
mode: 'normal',
})
配置选项说明如下:
mode 选项值 | 说明 | 是否默认选项 |
---|---|---|
normal | 普通模式,展示所有功能界面 | 是 |
simple | 极简模式,不显示头部和工具栏 | 否 |
自定义配置选项
初始化 JS-SDK 时,通过分别配置不同文档对应的配置选项,可以开启或关闭文档中的特定配置以及控制文档打开时的状态。
COSDocPreviewSDK.config({
//通用选项,适用于所有类型的文档。
commonOptions: {
isShowTopArea: false, //隐藏顶部区域(头部和工具栏)。
isShowHeader: false //隐藏头部区域。
},
//WORD文档相关配置。
wordOptions: {
isShowDocMap: false,
isBestScale: true
},
//PDF文档相关配置。
pdfOptions: {
isShowComment: true,
isInSafeMode: false
},
//演示文档相关配置。
pptOptions: {
isShowBottomStatusBar: true
}
})
- 通用配置项:commonOptions
配置项 说明 默认值 isShowTopArea 是否显示顶部区域(头部和工具栏) false isShowHeader 是否显示头部区域 false isBrowserViewFullscreen 是否在浏览器区域全屏 false isIframeViewFullscreen 是否在 iframe 区域内全屏 false - 文字文件配置项:wordOptions
配置项 说明 默认值 isShowDocMap 是否开启目录功能,默认开启 true isBestScale 打开文档时,默认以最佳比例显示(适用于 PC) true isShowBottomStatusBar 是否展示底部状态栏(适用于 PC) false - PDF 配置项:pdfOptions
配置项 说明 默认值 isShowComment 是否显示注解,默认显示 true isInSafeMode 是否处于安全模式(安全模式下不能划选文字,不能复制以及不能通过链接跳转),默认不是安全模式 false isShowBottomStatusBar 是否展示底部状态栏(适用于 PC) false - 演示文件配置项:pptOptions
配置项 说明 默认值 isShowBottomStatusBar 是否展示底部状态栏(适用于 PC) false
组件状态设置
可以通过 commandBars 选项来隐藏或禁用页面的组件。
COSDocPreviewSDK.config({
//通用选项,适用于所有类型的文档。
commandBars: [
{
cmbId: 'Print', // 组件ID
attributes: {
visible: false, // 组件是否显示,默认为true。false:隐藏组件;true:显示组件
enable: false, // 禁用或者开启组件,默认为true
},
},
]
})
目前可用的组件列表如下:
组件ID | 说明 | 适用范围 |
---|---|---|
打印功能,和 ctrl+P 打印快捷键 | 所有文档 | |
MobileHeader | 客户端的顶部工具栏 | 所有文档 |
WriterHoverToolbars | 客户端的底部工具栏 | 文字文件 |
DownloadImg | 双击图片下载按钮图标 | 演示文件 |
PlayComponentToolbar | 全屏播放时右上角工具栏 | 演示文件 |
PlayContextCheckImage | 播放时右键 - 查看原图 | 演示文件 |
FloatMenuCheckImage | 选中图片时浮动菜单栏 - 查看原图 | 演示文件 |
WPPMobileCommentButton | 客户端底部工具栏的评论按钮 | 演示文件 |
PDFMobilePageBar | 客户端的页码 | PDF文件 |