通过调用高级功能接口可用于直接操作文档,本文介绍文档在线协作高级功能接口的调用流程。
概述
JS-SDK提供的接口风格与VBA一致,原则上兼容VBA的接口和参数。在索引调用的时候,请从1开始。
JS-SDK的高级用法按不同的文档类型进行了划分:
文字(Word):doc、docx、wps等后缀文件。
表格(Excel):xls、xlsx等后缀文件。
演示(PPT):ppt、pptx等后缀文件。
PDF:pdf等后缀文件。
公共:在文字(Word)、表格(Excel)、演示(PPT)、PDF等文档都可以使用的高级API。
说明
本文中的instance对象是指JS-SDK实例化后的对象。更多信息,请参见快速入门。
步骤一:等待实例化完成
在调用高级功能接口前,需要先等待ready加载完成。
window.onload = async function() {
const instance = aliyun.config({
url: '在线文档预览地址',
});
//等待instance ready之后再调用高级接口
await instance.ready();
};
步骤二:获取文档类型的应用对象
根据WordApplication
、ExcelApplication
、PPTApplication
、PDFApplication
判断当前文档类型,如果不需要特指文档类型,可使用instance.Application
自动识别文档类型。
//文字文档
const wordApp = instance.WordApplication();
//表格文档
const excelApp = instance.ExcelApplication();
//演示文档
const pptApp = instance.PPTApplication();
//PDF文档
const pdfApp = instance.PDFApplication();
//自动识别
const app = instance.Application;
步骤三:使用高级接口
以设置文字文档缩放比例为例,高级接口的使用方式如下所示。
<script src="https://g.alicdn.com/IMM/office-js/1.1.15/aliyun-web-office-sdk.min.js"></script>
<script>
window.onload = async function() {
const instance = aliyun.config({
url: 'Word文档路径',
});
//等待ready加载完成
await instance.ready();
//自动识别文档类型
const app = instance.Application;
//设置文档缩放比例为50%
app.ActiveDocument.ActiveWindow.View.Zoom.Percentage = 50;
};
</script>
文档内容是否对您有帮助?