Customization
自定义部分允许自定义编辑器界面,使其看起来像其他产品(如果有),并更改其他按钮、链接、更改徽标和编辑器所有者详细信息的存在或不存在。
参数 | 描述 | 类型 | 样例 |
---|---|---|---|
autosave | 定义是启用还是禁用“自动保存”菜单选项。如果设置为false,则只能选择严格的协同编辑模式,因为如果没有自动保存,Fast将无法工作。请注意,如果您在菜单中更改此选项,它将保存到您的浏览器本地存储。默认值为true。 | boolean | true |
chat | 定义是显示还是隐藏聊天菜单按钮;请注意,如果隐藏聊天按钮,相应的聊天功能也将被禁用。默认值为true。 | boolean | true |
commentAuthorOnly | 定义用户是否只能编辑和删除其注释。默认值为false。 | boolean | true |
comments | 定义是显示还是隐藏“注释”菜单按钮;请注意,如果隐藏“注释”按钮,则相应的注释功能将仅用于查看,注释的添加和编辑将不可用。默认值为true。 | boolean | true |
compactHeader | 定义附加操作按钮是显示在徽标旁边的编辑器窗口标题的上部(false)还是显示在工具栏(true)中,以使标题更紧凑。默认值为false。 | boolean | false |
compactToolbar | 定义显示的顶部工具栏类型是full(false)还是compact true。默认值为false。 | boolean | false |
compatibleFeatures | 定义仅与OOXML格式兼容的功能的使用。例如,不要对整个文档使用注释。默认值为false。 | boolean | false |
customer* | 包含将在编辑器中显示的关于节的信息,并对所有编辑器用户可见。对象具有以下参数: | object | |
feedback | 定义“反馈和支持”菜单按钮的设置。可以是布尔值(仅显示或隐藏“反馈和支持”菜单按钮)或对象。对于对象类型,可以使用以下参数: | boolean or object | true |
forcesave | 在文档编辑服务中保存文档时,将强制文件保存请求添加到回调处理程序(例如,单击“保存”按钮等)。默认值为false。 | boolean | false |
goback | 定义“打开文件位置”菜单按钮和右上角按钮的设置。对象具有以下参数: | boolean or object | true |
help | 定义“帮助”菜单按钮是显示还是隐藏。默认值为true。 | boolean | true |
hideRightMenu | 定义第一次加载时是否显示或隐藏了右菜单。默认值为false。 | boolean | false |
logo* | 更改编辑器标题左上角的图像文件。建议的图像高度为20像素。对象具有以下参数: | object | |
macros | 定义是否运行文档宏以及可用宏设置。默认值为true。 | boolean | true |
macrosMode | 定义是否运行文档宏。可以采用以下值:disable enable warn | boolean | true |
mentionShare | 定义在注释中提及之后描述事件的提示。如果为true,则提示表示用户将收到通知并访问文档。如果为false,则提示表示用户将只收到提及的通知。默认值为true。 | boolean | true |
plugins | 定义插件是否启动和可用。默认值为true。 | boolean | true |
reviewDisplay | 定义打开文档进行查看时将使用的审阅编辑模式。仅当mode参数设置为view时,它才可用于文档编辑器。可以采用以下值:final-显示文档并应用所有建议的更改;markup-显示文档并突出显示建议的更改;original—显示原始文档而不显示建议的更改。 | string | original |
showReviewChanges | 定义在加载编辑器时是自动显示还是隐藏“审阅更改”面板。默认值为false。 | boolean | false |
spellcheck | 定义在加载编辑器时是否自动打开或关闭拼写检查器。拼写检查器仅适用于文档编辑器和演示文稿编辑器。默认值为true。 | boolean | true |
toolbarHideFileName | 定义文档标题在顶部工具栏上是可见的(设置为false时)还是隐藏的(设置为true时)。默认值为false。 | boolean | false |
toolbarNoTabs | 定义顶部工具栏选项卡是清晰显示(设置为false时)还是仅高亮显示以查看所选的选项卡(设置为true时)。默认值为false。 | boolean | false |
trackChanges | 定义在加载编辑器时是自动打开(true)还是关闭(false)审阅编辑模式。如果参数未定义,则使用当前打开模式(存储在浏览器本地存储中)。 | boolean | true |
unit | 定义标尺和对话框中使用的测量单位。可以采用以下值:cm-厘米,pt-像素点,inch-英寸 | string | cm |
zoom | 定义以百分比度量的文档显示缩放值。可以采用大于0的值。对于文本文档和演示文稿,可以将此参数设置为-1(使文档适合页面选项)或-2(使文档页面宽度适合编辑器页面)。默认值为100。 | integer | 100 |
样例
var docEditor = new KlinDocsAPI.DocEditor("placeholder", {
"editorConfig": {
"customization": {
"chat": true,
"commentAuthorOnly": false,
"comments": true,
"compactHeader": false,
"compactToolbar": false,
"compatibleFeatures": false,
"customer": {
"address": "My City, 123a-45",
"info": "Some additional information",
"logo": "https://example.com/logo-big.png",
"mail": "john@example.com",
"name": "John Smith and Co.",
"www": "example.com"
},
"feedback": {
"url": "https://example.com",
"visible": true
},
"forcesave": false,
"goback": {
"blank": true,
"requestClose": false,
"text": "Open file location",
"url": "https://example.com"
},
"help": true,
"hideRightMenu": false,
"logo": {
"image": "https://example.com/logo.png",
"imageEmbedded": "https://example.com/logo_em.png",
"url": "https://www.onlyoffice.com"
},
"macros": true,
"macrosMode": "warn",
"mentionShare": true,
"plugins": true,
"reviewDisplay": "original",
"showReviewChanges": false,
"spellcheck": true,
"toolbarHideFileName": false,
"toolbarNoTabs": false,
"trackChanges": false,
"unit": "cm",
"zoom": 100
},
...
},
...
});