跳到主要内容

Customization - Standard branding

自定义部分允许自定义编辑器界面,使其看起来像您的其他产品(如果有),并更改是否出现附加按钮、链接、更改徽标和编辑器所有者详细信息。

在此页面上,您将找到 ONLYOFFICE 文档开发者版的 standard branding 可用的自定义参数。如果您拥有扩展的白标许可证,请访问 White label page 以了解可用的其他自定义选项。

请注意,只有以下参数可用于移动编辑器:close, feedback, goback, help, logo, 宏模式, mobile.

匿名

添加对匿名名称的请求:

类型: object

示例:

const anonymous = {
request: true,
label: "Guest",
}

anonymous.request

定义是否发送请求。默认值为 true

类型: boolean

示例: true

anonymous.label

添加到用户名的后缀。默认值为 Guest

类型: string

示例: "Guest"

匿名

自动保存

定义自动保存菜单选项是启用还是禁用。如果设置为 false,则只能选择 Strict 共同编辑模式,因为 Fast 在没有自动保存的情况下不起作用。默认值为 true

类型: boolean

示例: true

请注意,如果在编辑器界面中更改此设置,它将存储在浏览器本地存储中,并将覆盖作为 editorConfig.customization.autosave 参数发送的任何值。

聊天

定义聊天菜单按钮是显示还是隐藏。请注意,如果您隐藏聊天按钮,相应的聊天功能也将被禁用。默认值为 true。自 7.1 版起已弃用,请改用 document.permissions.chat 参数。

类型: boolean

示例: true

Chat

关闭

定义用于关闭编辑器的关闭按钮的设置:

类型: object

示例:

const close = {
visible: true,
text: "Close file",
}

close.visible

定义用于关闭编辑器的关闭按钮是显示还是隐藏。默认值为 true

类型: boolean

示例: true

close.text

定义编辑器标题中按钮的工具提示文本或移动编辑器中的菜单项文本以及 Web 编辑器的 File 菜单中的按钮的工具提示文本。

类型: string

示例: "关闭文件"

请注意,仅当设置了 onRequestClose 事件时,该参数才可用。如果未声明该事件且未指定 close 参数,则不会显示关闭按钮。

请注意,此参数也适用于移动编辑器。

标题中的十字按钮

commentAuthorOnly

定义用户是否只能编辑和删除他的评论。默认值为 false。自 6.3 版起已弃用,请改用 document.permissions.editCommentAuthorOnlydocument.permissions.deleteCommentAuthorOnly 字段。

类型: boolean

示例: true

评论

定义注释菜单按钮是显示还是隐藏。请注意,如果您隐藏评论按钮,则相应的评论功能将仅供查看,无法添加和编辑评论。默认值为true

类型: boolean

示例: true

批注

compactHeader

定义附加操作按钮是显示在编辑器窗口标题的上部靠近徽标 (false) 还是显示在工具栏 (true) 中,使标题更紧凑。默认值为 false

类型: boolean

示例: false

紧凑标题

compactToolbar

定义显示的顶部工具栏类型是完整的 (false) 还是紧凑的 (true)。默认值为 false。从 8.3 版开始,此设置也适用于查看器。查看模式的默认值为 true

类型: boolean

示例: false

请注意,如果在编辑器界面中更改此设置,它将存储在浏览器本地存储中,并将覆盖作为 editorConfig.customization.compactToolbar 参数发送的任何值。

紧凑工具栏

compatibleFeatures

定义仅与 OOXML 格式兼容的功能的使用。例如,不要对整个文档使用注释。默认值为 false

类型: boolean

示例: false

客户

包含将在编辑器 关于 部分中显示的信息,并对所有编辑器用户可见。

此参数仅适用于 ONLYOFFICE 文档开发者版的编辑。

类型: object

示例:

const customer = {
address: "My City, 123a-45",
info: "Some additional information",
logo: "https://example.com/logo-big.png",
logoDark: "https://example.com/dark-logo-big.png",
mail: "john@example.com",
name: "John Smith and Co.",
phone: "123456789",
www: "example.com",
}

customer.address

授予编辑者或编辑者作者访问权限的公司或个人的邮政地址。

类型: string

示例: "My City, 123a-45"

customer.info

关于您希望其他人知道的公司或个人的一些附加信息。

类型: string

示例: "Some additional information"

图片 logo 的路径(这个文件没有特别推荐,但是如果是透明背景的 .png 格式会更好)。图片必须具有以下尺寸:432x70.

类型: string

示例: https://example.com/logo-big.png

customer.logoDark

深色主题图像徽标的路径(此文件没有特别建议,但如果是透明背景的 .png 格式会更好)。图片必须具有以下尺寸:432x70.

类型: string

示例: https://example.com/dark-logo-big.png

customer.mail

授予编辑者或编辑者作者访问权限的公司或个人的电子邮件地址。

类型: string

示例: john@example.com

customer.name

授予编辑者或编辑者作者访问权限的公司或个人的名称。

类型: string

示例: "John Smith and Co."

customer.phone

授予编辑器或编辑器作者访问权限的公司或个人的电话。

类型: string

示例: "123456789"

customer.www

上述公司或个人的主页地址。

类型: string

示例: "example.com"

客户

功能

如果可能,定义用户可以禁用或自定义的参数:

类型: object

示例:

const features = {
roles: true,
spellcheck: {
mode: true,
},
tabBackground: {
mode: "header",
change: true,
},
tabStyle: {
mode: "fill",
change: true,
},
}

features.roles

定义是否在 pdf 表单中禁用角色设置。如果该参数等于 false,则隐藏角色管理器,并禁用代表特定角色查看表单。在这种情况下,表单选项卡上的管理角色查看表单按钮以及右侧面板中用于设置字段角色的下拉列表将不会显示。默认值为 true

此参数仅适用于 ONLYOFFICE 文档开发者版的编辑。

类型: boolean

示例: true

features.spellcheck

定义在加载编辑器时拼写检查器是自动打开还是关闭。如果此参数为布尔值,则将其设置为初始拼写检查值,并且不会隐藏拼写检查设置。默认值为 true

类型: object or boolean

示例: true

features.spellcheck.mode

定义在加载编辑器时拼写检查器是自动打开还是关闭。此参数仅适用于文档编辑器和演示文稿编辑器。

类型: boolean

示例: true

请注意,如果在编辑器界面中更改拼写检查设置,它将存储在浏览器本地存储中,并将覆盖作为 editorConfig.customization.features.spellcheck 参数发送的任何值。

features.tabBackground

定义顶部工具栏选项卡的背景。如果此参数是字符串值(headertoolbar),则将其设置为初始选项卡背景值,并且不会隐藏选项卡背景设置。默认值为 header

类型: object or string

示例: "header"

features.tabBackground.mode

定义顶部工具栏选项卡的背景是否与标题背景(header)或工具栏背景(toolbar*)匹配。默认值为 header。首次打开编辑器时使用此值。

类型: string

示例: "header"

features.tabBackground.change

定义选项卡背景设置是否显示在 文件 -> 高级设置 中。此设置在所有编辑器类型中都可用。

类型: boolean

示例: true

选项卡背景

features.tabStyle

定义顶部工具栏选项卡的样式。如果此参数是字符串值(fillline),则将其设置为初始选项卡样式值,并且选项卡样式设置不会被隐藏。默认值为 fill

类型: object or string

示例: "fill"

features.tabStyle.mode

定义顶部工具栏选项卡是否清晰显示(fill)或仅突出显示以查看选择了哪个选项卡(line)。默认值为 fill。此值在编辑器首次打开时使用。

类型: string

示例: "fill"

features.tabStyle.change

定义选项卡样式设置是否显示在 文件 -> 高级设置 中。此设置在所有编辑器类型中都可用。

类型: boolean

示例: true

选项卡样式

feedback

定义反馈和支持菜单按钮的设置。可以是布尔值(仅显示或隐藏反馈和支持菜单按钮)或对象。

默认值为 false

类型: boolean or object

示例: true

请注意,此参数也适用于移动编辑器。

反馈

feedback.url

单击反馈和支持菜单按钮时将打开的网站绝对URL。

类型: string

示例: https://example.com

feedback.visible

显示或隐藏反馈和支持菜单按钮。

类型: boolean

示例: true

forcesave

文档编辑服务中保存文档时(例如单击保存按钮等),将文件强制保存请求添加到 callback handler。默认值为 false

类型: boolean

示例: false

请注意,如果在编辑器界面中更改此设置,它将存储在浏览器本地存储中,并将覆盖作为 editorConfig.customization.forcesave 参数发送的任何值。

goback

定义打开文件位置菜单按钮和右上角按钮的设置。

类型: object

示例:

const goback = {
blank: true,
text: "Open file location",
url: "https://example.com",
}

请注意,此参数也适用于移动编辑器。

回去

goback.blank

单击打开文件位置按钮时,在新浏览器选项卡/窗口(如果值设置为 true)或当前选项卡(如果值设置为 false )中打开网站。默认值为 true

类型: boolean

示例: true

goback.requestClose

定义如果单击打开文件位置按钮,将调用 events.onRequestClose 事件而不是打开浏览器选项卡或窗口。自 8.1 版起已弃用。请使用 close 参数代替。

类型: boolean

示例: false

goback.text

打开文件位置菜单按钮和右上角按钮显示的文本(也就是说,不是转到文档)。

类型: string

示例: "打开文件位置"

goback.url

单击打开文件位置菜单按钮时将打开的网站绝对 URL。

类型: string

示例: https://example.com

帮助

定义帮助菜单按钮是显示还是隐藏。默认值为 true

类型: boolean

示例: true

请注意,此参数也适用于移动编辑器。

帮助

hideNotes

定义注释面板在首次加载时是显示还是隐藏。默认值为 false。此参数仅适用于演示文稿编辑器。

类型: boolean

示例: false

请注意,如果在编辑器界面中更改此设置,它将存储在浏览器本地存储中,并将覆盖作为 editorConfig.customization.hideNotes 参数发送的任何值。

隐藏备注

hideRightMenu

定义第一次加载时是否显示或隐藏右侧菜单。默认值为 true

类型: boolean

示例: true

请注意,如果在编辑器界面中更改此设置,它将存储在浏览器本地存储中,并将覆盖作为 editorConfig.customization.hideRightMenu 参数发送的任何值。

hideRulers

定义编辑器标尺是显示还是隐藏。此参数可用于文档和演示文稿编辑器。文档编辑器的默认值为 false,演示文稿的默认值为 true

类型: boolean

示例: false

隐藏标尺

integrationMode

定义将编辑器嵌入网页的模式。embed 值禁止在加载编辑器框架时滚动到编辑器框架,因为焦点未被捕获。

类型: string

示例: "embed"

更改编辑器标题左上角的图像文件。推荐的图像高度为 20 像素。

此参数仅适用于 ONLYOFFICE 文档开发者版的编辑。

类型: object

示例:

const logo = {
image: "https://example.com/logo.png",
imageDark: "https://example.com/dark-logo.png",
imageLight: "https://example.com/light-logo.png",
url: "https://example.com",
visible: true,
}

请注意,此参数也适用于移动编辑器。

标志

logo.image

用于在通用工作模式(即所有编辑器的查看和编辑模式)或嵌入模式(请参阅 配置 部分以了解如何定义嵌入文档类型)中显示的图像文件的路径。图片必须具有以下尺寸:172x40.

类型: string

示例: https://example.com/logo.png

logo.imageDark

用于深色标题的图像文件的路径(例如,在深色主题中或带有彩色标题的主题中)。图像必须具有以下尺寸:172x40。

类型: string

示例: https://example.com/dark-logo.png

logo.imageLight

用于浅色标题的图像文件的路径(例如,在灰色主题中)。图像必须具有以下尺寸:172x40。

类型: string

示例: https://example.com/light-logo.png

logo.imageEmbedded

用于以嵌入模式显示的图像文件的路径(请参阅 配置 部分以了解如何定义嵌入文档类型)。图片必须具有以下尺寸:248x40。自 7.0 版起已弃用,请改用图像字段。

类型: string

示例: https://example.com/logo_em.png

logo.url

当有人单击徽标图像时将使用的绝对 URL(可用于访问您的网站等)。保留为空字符串或 null 以使徽标不可点击。

类型: string

示例: https://example.com

logo.visible

显示或隐藏徽标。默认值为 true

类型: boolean

示例: true

macros

定义当编辑器打开时是否自动运行文档宏。默认值为 truefalse值对用户隐藏 宏设置

类型: boolean

示例: true

macrosMode

定义启用自动开始时的宏运行模式。可以取以下值:

  • disable - 不自动运行所有宏;
  • enable - 自动运行所有宏;
  • warn - 对运行宏发出警告并请求运行它们的权限。

默认值为 warn

类型: string

示例: "warn"

请注意,如果在编辑器界面中更改此设置,它将存储在浏览器本地存储中,并将覆盖作为 editorConfig.customization.macrosMode 参数发送的任何值。

请注意,此参数也适用于移动编辑器。

mentionShare

定义在评论中提及后描述事件的提示。如果为 true,则提示表示用户将收到通知并访问文档。如果为 false,则提示表示用户将仅收到提及通知。默认值为 true

类型: boolean

示例: true

请注意,如果设置了 onRequestSendNotify 事件 ,它将仅可用于评论。

Mention share

mobile

定义移动文档编辑器设置。

类型: object

示例:

const mobile = {
forceView: true,
info: false,
standardView: false,
}

请注意,此参数仅适用于移动编辑器。

mobile.forceView

定义在移动文档编辑器中启动时是否启用查看模式。

类型: boolean

示例: true

mobile.info

定义在移动文档编辑器中是否显示或隐藏文档信息按钮。

类型: boolean

示例: false

mobile.standardView

定义编辑器是否在标准视图而不是移动视图中打开。

类型: boolean

示例: false

mobileForceView

定义移动文档编辑器在启动时是否以查看/编辑模式打开。默认值为 true

类型: boolean

示例: true

请注意,此参数仅适用于移动编辑器。

自版本 8.2 起已弃用。请改用 mobile 参数。

插件

定义 插件 是否将启动并可用。默认值为 true

类型: boolean

示例: true

pointerMode

定义在查看器中加载演示文稿编辑器时的指针模式(selecthand)。默认值为 select

类型: string

示例: "select"

指针模式

审阅

包含有关审阅模式的信息。

类型: object

示例:

const review = {
hideReviewDisplay: false,
showReviewChanges: false,
reviewDisplay: "original",
trackChanges: true,
hoverMode: false,
}

showReviewChanges, reviewDisplay, trackChanges 参数自 7.0 版起已弃用。请改用 review 参数。

请注意,如果在编辑器界面中更改此设置,它将存储在浏览器本地存储中,并将覆盖作为 editorConfig.customization.review.hoverModeeditorConfig.customization.review.reviewDisplay 参数发送的任何值。

审阅显示

review.hideReviewDisplay

定义 显示模式 按钮是在 协作 选项卡上显示还是隐藏。

类型: boolean

示例: false

review.hoverMode

定义审阅显示模式:通过将鼠标悬停在更改上来在工具提示中显示审阅(true),或通过单击更改来在气球中显示审阅(false)。

类型: boolean

示例: false

review.reviewDisplay

定义打开文档进行查看时将使用的审阅编辑模式。如果 模式 设置为 view,它将仅对文档编辑器可用。

  • markup - 显示文档,并突出显示建议的更改;
  • simple - 显示文档并突出显示建议的更改,但气球已关闭;
  • final - 显示文档并应用了所有建议的更改;
  • original - 显示原始文档,没有建议的更改。

默认值为 original

类型: string

示例: "original"

review.showReviewChanges

定义在加载编辑器时是否自动显示或隐藏审阅更改面板。默认值为 false

类型: boolean

示例: false

review.trackChanges

无论 document.permissions.review 参数如何,定义是否以审阅编辑模式 (true) 打开文档 (false) (审阅模式仅针对当前用户更改)。如果参数 未定义,则使用 document.permissions.review 值(对于所有文档用户)。

类型: boolean

示例: true

reviewDisplay

定义文档编辑器中的审阅编辑模式。此参数可以采用以下值:

  • markup - 显示文档并突出显示建议的更改;
  • simple - 显示文档并突出显示建议的更改,但气球已关闭;
  • final - 显示文档并应用所有建议的更改;
  • original - 显示原始文档,没有建议的更改。

查看器的默认值是 original, 编辑器的默认值是 markup

类型: string

示例: "original"

自 7.0 版起已弃用。请改用 review.reviewDisplay 参数。

请注意,如果在编辑器界面中更改此设置,它将存储在浏览器本地存储中,并将覆盖作为 editorConfig.customization.reviewDisplay 参数发送的任何值。

showReviewChanges

定义在加载编辑器时是否自动显示或隐藏审阅更改面板。默认值为 false

类型: boolean

示例: false

自 7.0 版起已弃用。请改用 review.showReviewChanges 参数。

slidePlayerBackground

从版本 8.3 开始,定义演示文稿编辑器中幻灯片的背景颜色。可以以 HEX、RGB 或 RGBA 格式表示。例如,#ff0000rgb(255, 0, 0)rgba(255, 0, 0, 0.5)

类型: string

示例: "#000000"

spellcheck

定义在加载编辑器时拼写检查器是自动打开还是关闭。拼写检查器仅适用于文档编辑器和演示文稿编辑器。默认值为 true

类型: boolean

示例: true

自 7.1 版起已弃用。请改用 features.spellcheck 参数。

请注意,如果在编辑器界面中更改此设置,它将存储在浏览器本地存储中,并将覆盖作为 editorConfig.customization.spellcheck 参数发送的任何值。

submitForm

从版本 8.3 开始,定义完成并提交按钮设置。如果此参数是布尔值,则指定完成并提交按钮将在顶部工具栏上显示还是隐藏。按钮仅适用于pdf格式。默认值为true

类型: object or boolean

示例: true

Submit button Submit button

submitForm.visible

定义顶部工具栏上是否显示或隐藏Complete & Submit按钮。按钮仅适用于 pdf 格式。 默认值为true

类型: boolean

示例: true

submitForm.resultMessage

定义表单提交后显示的消息。可用的值如下:

  • "" - 不显示消息;
  • null / undefined - 显示默认消息;
  • "text" - 显示用户指定的任何文本。

类型: string

示例: "text"

toolbarHideFileName

定义文档标题在顶部工具栏上是可见的 (false) 还是隐藏的 (true)。默认值为 false

类型: boolean

示例: false

请注意,当 compactHeadertoolbarNoTabs 参数设置为 true时使用此设置。

工具栏隐藏文件名

toolbarNoTabs

定义顶部工具栏选项卡是清晰显示 (false) 还是仅突出显示以查看选择了哪个 (true)。默认值为 false。自版本 8.2 起已弃用,请使用 editorConfig.customization.features.tabStyle 参数(设置为 line)和 editorConfig.customization.features.tabBackground 参数(等于 toolbar)。

类型: boolean

示例: false

trackChanges

无论 document.permissions.review 参数如何, 定义是(true)否(false)以审阅编辑模式打开文档(仅针对当前用户更改审阅模式)。如果参数是 未定义,则使用 document.permissions.review 值(对于所有文档用户)。

类型: boolean

示例: true

自 7.0 版起已弃用。请改用 review.trackChanges 参数。

uiTheme

定义编辑器主题设置。可以通过两种方式设置:

  • theme id - 用户通过其 id 设置主题参数(theme-light, theme-classic-light, theme-dark, theme-contrast-dark),
  • default theme - 将设置默认的深色或浅色主题值(default-darkdefault-light)。默认的浅色主题是 theme-classic-light

第一个选项具有更高的优先级。

除了可用的编辑器主题外,用户还可以为应用程序界面自定义自己的 颜色主题

类型: string

示例: "theme-dark"

请注意,如果在编辑器界面中更改此设置,它将存储在浏览器本地存储中,并将覆盖作为 editorConfig.customization.uiTheme 参数发送的任何值。

单元

定义标尺和对话框中使用的测量单位。可以取以下值:

  • cm - 厘米;
  • pt - 点;
  • inch - 英寸。

默认值为厘米 (cm)。

类型: string

示例: "cm"

请注意,如果在编辑器界面中更改此设置,它将存储在浏览器本地存储中,并将覆盖作为 editorConfig.customization.unit 参数发送的任何值。

wordHeadingsColor

从版本 8.3 开始,定义文档编辑器中默认标题样式的十六进制颜色。

类型: string

示例: "#00ff00"

zoom

定义以百分比测量的文档显示缩放值。可以取大于 0的值。对于文本文档和演示文稿,可以将此参数设置为 -1 (使文档适合页面选项)或 -2 (使文档页面宽度适合编辑器页面)。默认值为 100

类型: integer

示例: 100

请注意,如果在编辑器界面中更改此设置,它将存储在浏览器本地存储中,并将覆盖作为 editorConfig.customization.zoom 参数发送的任何值。

自定义

示例

const docEditor = new DocsAPI.DocEditor("placeholder", {
editorConfig: {
customization: {
anonymous: {
request: true,
label: "Guest",
},
autosave: true,
close: {
visible: true,
text: "Close file",
},
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",
logoDark: "https://example.com/dark-logo-big.png",
mail: "john@example.com",
name: "John Smith and Co.",
phone: "123456789",
www: "example.com",
},
features: {
roles: true,
spellcheck: {
mode: true,
},
tabBackground: {
mode: "header",
change: true,
},
tabStyle: {
mode: "fill",
change: true,
},
},
feedback: {
url: "https://example.com",
visible: true,
},
forcesave: false,
goback: {
blank: true,
text: "Open file location",
url: "https://example.com",
},
help: true,
hideNotes: false,
hideRightMenu: true,
hideRulers: false,
integrationMode: "embed",
logo: {
image: "https://example.com/logo.png",
imageDark: "https://example.com/dark-logo.png",
imageLight: "https://example.com/light-logo.png",
url: "https://example.com",
visible: true,
},
macros: true,
macrosMode: "warn",
mentionShare: true,
mobile: {
forceView: true,
info: false,
standardView: false,
},
plugins: true,
pointerMode: "select",
review: {
hideReviewDisplay: false,
showReviewChanges: false,
reviewDisplay: "original",
trackChanges: true,
hoverMode: false,
},
slidePlayerBackground: "#000000",
submitForm: {
visible: true,
resultMessage: "text",
},
toolbarHideFileName: false,
uiTheme: "theme-dark",
unit: "cm",
wordHeadingsColor: "#00ff00",
zoom: 100,
},
},
})

此处的 example.com 表示安装文档管理器文档存储服务的服务器名称。要深入了解 ONLYOFFICE 文档服务的客户端-服务器交互机制,请参阅工作原理 章节。