配置概述
传递给 DocsAPI.DocEditor 构造函数的配置对象包含以下主要部分：
config - 根部分，包含文档类型、平台类型和显示尺寸；
-
document- 包含文档参数（标题、网址、文件类型等）；info- 包含文档元数据（所有者、文件夹、上传日期、共享设置）；permissions- 定义文档访问权限（编辑、下载、评论、打印等）；
-
editorConfig- 定义编辑器界面参数：打开模式、语言、回调 URL 等；customization- 允许自定义编辑器界面：品牌、按钮、链接、徽标和其他 UI 元素；embedded- 定义嵌入模式控件的行为（当 type 为 embedded 时使用）；plugins- 将 plugins 连接到 ONLYOFFICE 文档，供所有编辑器用户使用；
-
events- 文档操作触发的事件处理程序列表（加载、编辑、保存等）。
包含所有可用参数的完整 config：
const config = {
document: {
fileType: "docx",
isForm: true,
info: {
favorite: true,
folder: "Example Files",
owner: "John Smith",
sharingSettings: [
{
permissions: "Full Access",
user: "John Smith",
},
{
isLink: true,
permissions: "Read Only",
user: "External link",
},
],
uploaded: "2010-07-07 3:46 PM",
},
key: "Khirz6zTPdfd7",
permissions: {
chat: true,
comment: true,
commentGroups: [{
edit: ["Group2", ""],
remove: [""],
view: "",
}],
copy: true,
deleteCommentAuthorOnly: false,
download: true,
edit: true,
editCommentAuthorOnly: false,
fillForms: true,
modifyContentControl: true,
modifyFilter: true,
print: true,
protect: true,
review: true,
reviewGroups: ["Group1", "Group2", ""],
userInfoGroups: ["Group1", ""],
},
referenceData: {
fileKey: "BCFA2CED",
instanceId: "https://example.com",
},
title: "Example Document Title.docx",
url: "https://example.com/url-to-example-document.docx",
},
documentType: "word",
editorConfig: {
actionLink: ACTION_DATA,
callbackUrl: "https://example.com/url-to-callback.ashx",
coEditing: {
mode: "fast",
change: true,
},
createUrl: "https://example.com/url-to-create-document/",
customization: {
about: true,
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: {
featuresTips: true,
roles: true,
spellcheck: {
mode: true,
change: true,
},
tabBackground: {
mode: "header",
change: true,
},
tabStyle: {
mode: "fill",
change: true,
},
},
feedback: {
url: "https://example.com",
visible: true,
},
font: {
name: "Arial",
size: "11px",
},
forcesave: false,
forceWesternFontSize: false,
goback: {
blank: true,
text: "Open file location",
url: "https://example.com",
},
help: true,
hideNotes: false,
hideRightMenu: true,
hideRulers: false,
integrationMode: "embed",
layout: {
header: {
editMode: true,
save: true,
user: true,
users: true,
},
leftMenu: {
mode: true,
navigation: true,
spellcheck: true,
},
rightMenu: {
mode: true,
},
statusBar: {
actionStatus: true,
docLang: true,
textLang: true,
},
toolbar: {
collaboration: {
mailmerge: true,
},
draw: true,
file: {
close: true,
info: true,
save: true,
settings: true,
},
home: {},
layout: true,
plugins: true,
protect: true,
references: true,
save: true,
view: {
navigation: true,
},
},
},
loaderLogo: "https://example.com/loader-logo.png",
loaderName: "The document is loading, please wait...",
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,
},
showHorizontalScroll: true,
showVerticalScroll: true,
slidePlayerBackground: "#000000",
submitForm: {
visible: true,
resultMessage: "text",
},
suggestFeature: true,
toolbarHideFileName: false,
uiTheme: "theme-dark",
unit: "cm",
wordHeadingsColor: "#00ff00",
zoom: 100,
},
embedded: {
embedUrl: "https://example.com/embedded?doc=exampledocument1.docx",
fullscreenUrl: "https://example.com/embedded?doc=exampledocument1.docx#fullscreen",
saveUrl: "https://example.com/download?doc=exampledocument1.docx",
shareUrl: "https://example.com/view?doc=exampledocument1.docx",
toolbarDocked: "top",
},
lang: "en",
mode: "edit",
plugins: {
autostart: [
"asc.{0616AE85-5DBE-4B6B-A0A9-455C4F1503AD}",
"asc.{FFE1F462-1EA2-4391-990D-4CC84940B754}",
],
options: {
"all": {
keyAll: "valueAll",
},
"asc.{38E022EA-AD92-45FC-B22B-49DF39746DB4}": {
keyYoutube: "valueYoutube",
},
},
pluginsData: [
"https://example.com/plugin1/config.json",
"https://example.com/plugin2/config.json",
],
},
recent: [
{
folder: "Example Files",
title: "exampledocument1.docx",
url: "https://example.com/exampledocument1.docx",
},
{
folder: "Example Files",
title: "exampledocument2.docx",
url: "https://example.com/exampledocument2.docx",
},
],
region: "en-US",
templates: [
{
image: "https://example.com/exampletemplate1.png",
title: "exampletemplate1.docx",
url: "https://example.com/url-to-create-template1",
},
{
image: "https://example.com/exampletemplate2.png",
title: "exampletemplate2.docx",
url: "https://example.com/url-to-create-template2",
},
],
user: {
group: "Group1,Group2",
id: "78e1e841",
image: "https://example.com/url-to-user-avatar.png",
name: "John Smith",
},
},
events: {
onAppReady,
onCollaborativeChanges,
onDocumentReady,
onDocumentStateChange,
onDownloadAs,
onError,
onInfo,
onMakeActionLink,
onMetaChange,
onOutdatedVersion,
onPluginsReady,
onRequestClose,
onRequestCreateNew,
onRequestEditRights,
onRequestHistory,
onRequestHistoryClose,
onRequestHistoryData,
onRequestInsertImage,
onRequestMailMergeRecipients,
onRequestOpen,
onRequestReferenceData,
onRequestReferenceSource,
onRequestRefreshFile,
onRequestRename,
onRequestRestore,
onRequestSaveAs,
onRequestSelectDocument,
onRequestSelectSpreadsheet,
onRequestSendNotify,
onRequestSharingSettings,
onRequestStartFilling,
onRequestUsers,
onSubmit,
onUserActionRequired,
onWarning,
},
height: "100%",
token: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.e30.LwimMJA3puF3ioGeS-tfczR3370GXBZMIL-bdpu4hOU",
type: "desktop",
width: "100%",
};
const docEditor = new DocsAPI.DocEditor("placeholder", config);
将 example.com 替换为您的文档存储服务的主机地址。请参阅工作原理部分，了解有关 ONLYOFFICE 文档 服务客户端-服务器交互的更多信息。