调用流程

通过调用高级功能接口可用于直接操作文档,本文介绍文档在线协作高级功能接口的调用流程。

概述

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();
};

步骤二:获取文档类型的应用对象

根据WordApplicationExcelApplicationPPTApplicationPDFApplication判断当前文档类型,如果不需要特指文档类型,可使用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>