跳到主要内容

挂载文档

挂载节点是指文档应用插入页面时挂载的 HTML DOM 节点,SDK 初始化时,会自动在挂载节点下面插入一个 iframe 元素,并在该 iframe 元素中渲染文档应用。

语法

ZOfficeSDK.mount(url, selector, bAsync, config)

返回值

Application: 文档类型应用对象

  • Excel: Excel.Workbook
  • Word: Word.Document
  • PDF: PDF.Pdf

参数

属性数据类型必填说明
urlstring|object要被挂载的文档的地址。此参数也可以设置为对象,见url参数的其他形式
selectorstring要挂载文档的DOM节点的selector
bAsyncbooleantrue 表示在文档加载完成之前返回 Application,但使用高级API之前需要调用 Application.ready() 方法等待文档加载完成(推荐传true,在文档内容加载完成之前,更早的返回可用的 Application,避免等待时间过长)
configJSON可定制初始化显示/隐藏页面组件

示例:

以挂载文档地址为 http://172.16.22.98/docs/app/thirdparty-rest/1347466381985058817/edit/content?zdocs_access_token=653b90d845a785e3c69aeba 的表格文档为例

<!DOCTYPE html>
<html lang="en">

<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width,initial-scale=1.0,maximum-scale=1.0,user-scalable=no" />
<meta http-equiv="X-UA-Compatible" content="ie=edge" />
<title>JSSDK</title>
</head>

<body>

<div id="doc1" class="doc-container"></div>

<script src="sdk 地址"></script>
<script>
window.onload = async function() {
const Application = await ZOfficeSDK.mount('http://172.16.22.98/docs/app/thirdparty-rest/1347466381985058817/edit/content?zdocs_access_token=653b90d845a785e3c69aeba', '#doc1', true);
await Application.ready();
const sheets = await Application.ActiveWorkbook.getSheets()
console.log(sheets);
}
</script>
</body>
</html>

url参数的其他形式

url参数支持另外两种对象形式:

第一种(v8.2开始):

url直接传字符串,sdk会发送get请求访问文档中台。如果想让sdk发送post请求,可以将url改为下面形式的对象,参数会在请求体中发送。这种方式仅适用于标准集成,相关概念见安全

{
url: 在线文档的访问地址(不带查询参数),
access_token: 三方系统需要的token,
可选自定义参数1: '',
可选自定义参数2: '',
// ...
}

第二种(v8.1开始):

当使用前端SDK集成时需要使用配置对象替代url,详见编辑示例配置