概述

您所在的位置：网站首页 › wps核心支持库是什么 › 概述

概述

#概述| 来源: 网络整理| 查看: 265

js-sdk 除了提供基础的文档配置和使用，还提供了高级 API 来直接操作文档，接口风格与 VBA 一致，原则上兼容 VBA 的接口和参数。

js-sdk 的高级用法按不同的文档类型进行了划分：

文字（Word）：doc、docx、wps 等后缀文件表格（Excel）：xls、xlsx 等后缀文件演示（PPT）：ppt、pptx 等后缀文件PDF：pdf 等后缀文件

当然还有特殊目录：

公共：在文字（Word）、表格（Excel）、演示（PPT）、PDF 等文档都可以使用的高级 API

下面举例说明高级 API 调用流程。

实例：设置文档缩放

在上手之前，我们尝试一个小例子，通过控制文档的缩放比例，来了解下高级 API 的强大功能：

1 2 3 4 5 6 7 8 async function example() { await instance.ready(); const app = instance.Application; // 设置文档缩放比例为 50% app.ActiveDocument.ActiveWindow.View.Zoom.Percentage = 50; }

如果需要大量使用高级 API，请认真阅读注意事项，了解销毁对象等相关知识

那么，在这个例子中，我们需要了解哪些信息？下面通过 3 个步骤让你快速了解高级 API 相关信息。

步骤一：等待实例化完成

在调用高级 API 之前，需要先等待 ready() 方法执行完毕。

1 2 3 4 5 6 7 8 window.onload = async function() { const jssdk = WebOfficeSDK.config({ url: '在线文档预览地址', // 该地址需要后端提供，https://wwo.wps.cn/office/p/xxx }); // 需要等待 jssdk ready 之后再调用高级 API await jssdk.ready(); };步骤二：取得文档类型应用对象

根据相应的字段取得文档对应的应用对象，如果不需要特指，那就使用 jssdk.Application。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 // 文字 const wordApp = jssdk.WordApplication(); // 表格 const excelApp = jssdk.ExcelApplication(); // 演示 const pptApp = jssdk.PPTApplication(); // PDF const pdfApp = jssdk.PDFApplication(); // 自动识别 const app = jssdk.Application;

提示：可以根据 WordApplication、ExcelApplication、PPTApplication、PDFApplication 来判断当前是什么文档类型，下面文章中默认通过 jssdk.Application 自动识别文档类型。

步骤三：使用高级 API

这里以设置文字缩放比例为例，表明 API 的使用方式：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 window.onload = async function() { const jssdk = WebOfficeSDK.config({ url: 'xxxx', // Word 文档路径 }); // 等待加载完毕 await jssdk.ready(); // 自动识别 const app = jssdk.Application; // 设置文档缩放比例为 50% app.ActiveDocument.ActiveWindow.View.Zoom.Percentage = 50; };

【本文地址】

概述

概述

今日新闻

推荐新闻