挂载文档
挂载节点是指文档应用插入页面时挂载的 HTML DOM 节点,SDK 初始化时,会自动在挂载节点下面插入一个 iframe 元素,并在该 iframe 元素中渲染文档应用。
语法
ZOfficeSDK.mount(url, selector, bAsync, config)
返回值
Application: 文档类型应用对象
- Excel: Excel.Workbook
- Word: Word.Document
- PDF: PDF.Pdf
参数
| 属性 | 数据类型 | 必填 | 说明 |
|---|---|---|---|
| url | string|object | 是 | 要被挂载的文档的地址。此参数也可以设置为对象,见url参数的其他形式 |
| selector | string | 是 | 要挂载文档的DOM节点的selector |
| bAsync | boolean | 否 | true 表示在文档加载完成之前返回 Application,但使用高级API之前需要调用 Application.ready() 方法等待文档加载完成(推荐传true,在文档内容加载完成之前,更早的返回可用的 Application,避免等待时间过长) |
| config | JSON | 否 | 可定制初始化显示/隐藏页面组件 |
示例:
以挂载文档地址为 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开始):