onlyoffice简介
onlyoffice是一个在线创建，编辑和协作文档服务
使用方法
1.给编辑器添加一个div占位空间，其中将传递有关编辑器参数的所有信息：
< div id = “placeholder” > </ div >
< script type = “text / javascript”
src = “http://documentserver/web-apps/apps/api/documents/api.js” >
</ script >
2.创建docEditor：
var docEditor = new DocsAPI.DocEditor（“placeholder”，config）;
3.其中config是一个对象，全部属性配置如下：
# Full #
config = {
type: 'desktop or mobile',
width: '100% by default',
height: '100% by default',
documentType: 'text' | 'spreadsheet' | 'presentation',
document: {
title: 'document title',
url: 'document url'
fileType: 'document file type',
options: <advanced options>,
key: 'key',
vkey: 'vkey',
info: {
author: 'author name',
folder: 'path to document',
created: '<creation date>',
sharingSettings: [
{
user: 'user name',
permissions: '<permissions>',
isLink: false
},
...
]
},
permissions: {
edit: <can edit>, // default = true
download: <can download>, // default = true
reader: <can view in readable mode>,
review: <can review>, // default = edit
print: <can print>, // default = true
rename: <can rename>, // default = false
changeHistory: <can change history>, // default = false
comment: <can comment in view mode> // default = edit
}
},
editorConfig: {
mode: 'view or edit',
lang: <language code>,
location: <location>,
canCoAuthoring: <can coauthoring documents>,
canBackToFolder: <can return to folder> - deprecated. use "customization.goback" parameter,
createUrl: 'create document url',
sharingSettingsUrl: 'document sharing settings url',
fileChoiceUrl: 'mail merge sources url',
callbackUrl: <url for connection between sdk and portal>,
mergeFolderUrl: 'folder for saving merged file',
licenseUrl: <url for license>,
customerId: <customer id>,
user: {
id: 'user id',
name: 'user name'
},
recent: [
{
title: 'document title',
url: 'document url',
folder: 'path to document'
},
...
],
templates: [
{
name: 'template name',
icon: 'template icon url',
url: 'http://...'
},
...
],
customization: {
logo: {
image: url,
imageEmbedded: url,
url: http://...
},
backgroundColor: 'header background color',
textColor: 'header text color',
customer: {
name: 'SuperPuper',
address: 'New-York, 125f-25',
mail: 'support@gmail.com',
www: 'www.superpuper.com',
info: 'Some info',
logo: ''
},
about: true,
feedback: {
visible: false,
url: http://...
},
goback: {
url: 'http://...',
text: 'Go to London'
},
chat: true,
comments: true,
zoom: 100,
compactToolbar: false,
leftMenu: true,
rightMenu: true,
toolbar: true,
header: true,
statusBar: true,
autosave: true,
forcesave: false,
commentAuthorOnly: false,
showReviewChanges: false
},
plugins: {
autoStartGuid: 'asc.{FFE1F462-1EA2-4391-990D-4CC84940B754}',
url: '../../../../sdkjs-plugins/',
pluginsData: [
"helloworld/config.json",
"chess/config.json",
"speech/config.json",
"clipart/config.json",
]
}
},
events: {
'onReady': <application ready callback>, // deprecated
'onAppReady': <application ready callback>,
'onBack': <back to folder callback>,
'onDocumentStateChange': <document state changed callback>
'onDocumentReady': <document ready callback>
}
}
# Embedded #
config = {
type: 'embedded',
width: '100% by default',
height: '100% by default',
documentType: 'text' | 'spreadsheet' | 'presentation',
document: {
title: 'document title',
url: 'document url',
fileType: 'document file type',
key: 'key',
vkey: 'vkey'
},
editorConfig: {
licenseUrl: <url for license>,
customerId: <customer id>,
autostart: 'document', // action for app's autostart. for presentations default value is 'player'
embedded: {
embedUrl: 'url',
fullscreenUrl: 'url',
saveUrl: 'url',
shareUrl: 'url',
toolbarDocked: 'top or bottom'
}
},
events: {
'onReady': <application ready callback>, // deprecated
'onAppReady': <application ready callback>,
'onBack': <back to folder callback>,
'onError': <error callback>,
'onDocumentReady': <document ready callback>
}
}
4.下面是我写的示例代码：
<!DOCTYPE>
<html>
<head>
<meta charset="UTF-8">
<script type = "text/javascript" src = "http://192.168.41.138/web-apps/apps/api/documents/api.js"></script>
<script type="text/javascript">
function f() {
var docEditor=new DocsAPI.DocEditor("placeholder", {
document: {
fileType: "docx",
key: "fileKey",
title: "test.xlsx",
url: "http://192.168.43.195:8080/radosgw/doc/test.docx"
},
documentType: "text",
editorConfig: {
lang:"zh-CN",
callbackUrl:"http://192.168.43.195:8080/radosgw/office/callbackUrl",
mode:"edit",
user: {
id: "userId",
name: "user1"
}
}
});
}
</script>
</head>
<body onload="f()">
<div>
<div id = "placeholder"> </div>
</div>
</body>
</html>
