Excel JavaScript API 以编程方式控制 Excel 工作簿中的文本、表和图表。 在本单元中，你将了解如何使用表，包括格式设置选项、如何筛选数据以及对表中的数据进行排序。 你还将了解如何向工作表添加和自定义图表。
Microsoft 365开发人员平台（包括 Office）为开发人员提供了许多用于嵌入自定义项的画布，Office 加载项是三个画布之一：文档、对话和页面。
Microsoft Teams 在用户之间进行对话，使开发人员能够使用消息传递扩展、对话机器人和其他自定义选项来扩展体验。
开发人员使用 SharePoint 框架 自定义 SharePoint Server 和 SharePoint Online 中的页面。
还可以扩展 Office 客户端（如 Word、Excel、PowerPoint、OneNote 和 Outlook）以使用加载项实现自定义任务窗格、操作和其他自定义项。
首先，我们将了解适用于 Microsoft Excel 的 Office.js 的剖析：
- 当页面首次加载加载项时，所有 Office 加载项都必须停止 方法。
- 如果在加载项中使用较新的 Office.js 功能，请务必使用 API 检查客户端是否支持这些扩展。
- 对于 Excel JavaScript API，你可以使用 方法获取当前工作簿 的实例。
- 引用当前 Excel 工作簿的后，可以使用方法加载上下文中的任何属性。 此方法将添加请求队列，以便出于性能原因将多个请求链接在一起。
- 准备好检索已排队的属性或执行任何排队操作时，请使用 方法执行使用 方法定义的一批排队操作。
- 方法将返回一个 JavaScript 承诺，可用于获取结果或上一个操作并执行新操作。
- 最佳做法是，应侦听、捕获和处理使用 Excel JavaScript API 时可能发生的任何错误。
Excel 加载项开发人员应了解 Excel 工作簿的层次结构，以及它与 Office.js 中的对象之间的关系。
Office.js 通过 和 属性为 Excel 工作簿提供上下文。
工作簿包括含有多个集合的工作表。 这些集合包括图表、表和数据透视表等内容。
可以直接从工作簿对象（包括表和数据透视表）访问工作表中的许多对象。
工作表使用 和 方法来识别其同级。
可以使用 方法获取活动工作表，并使用 方法设置活动工作表。
Office.js 还提供许多工作表事件，如 、 和 ，开发人员可以在其自定义加载项中使用这些事件。
表是电子表格的核心。 Excel 支持定义数据范围，以作为数据表的基础。
范围表示一个或多个相邻的单元格，例如单元格、行、列、单元格块等。
可以使用工作表和地址获取包含 Office.js 的范围对象。 例如，范围"A1：D4"表示此屏幕截图中从左上到右下单元格的范围。
表是基于数据范围建立的。
函数接受具有标志的数据范围，以指示表是否具有标题。
可通过其命名范围或 ID 检索现有表。 开发人员还可以循环访问工作表中的表集合。
添加表后，可以使用二维数组添加标题和表行。
使用标题标志创建的表将使用数据范围中的第一行作为其标题。
还可以将 属性与二维数组一起使用来设置标题值。
以下代码片段演示了使用 Excel JavaScript API 的工作文本和段落的工作示例：
从工作表获取数据范围：
根据指定的范围将表插入到工作表中
从工作簿或工作表中按名称获取表
将标题行添加到指定的表
通过冻结最顶端的行来冻结标题行
删除表中的第二行
更新表中的第二行
将行添加到表的末尾
添加行
可以使用 Office.js 筛选表中的任何列。
若要筛选一列，请首先获取列的引用，然后使用 方法筛选特定值。
以下代码将按 Education 和 Groceries的值筛选表的类别列：
还可以分别使用表函数 和 ，以编程方式重新应用和清除表上的筛选器。
以下代码将演示如何重新应用和清除筛选器：
开发人员可以使用 Excel 加载项中的 Office.js API 对表数据进行排序。若要进行排序，请调用 方法并包含 参数以指定要排序的字段。
以下代码定义了排序字段的数组。 属性指定表中的列索引，布尔属性指定是按升序还是降序排序：
可以使用 和 方法重新应用和清除表排序。
Microsoft Excel 已成为一个数据操作和可视化的平台。 理所当然地，Excel JavaScript API 允许开发人员添加和操作图表。
图表存在于工作表中，但也可以直接从工作簿对象访问。
图表具有许多复杂的关系属性，可用于微调图表的外观。 其中包括标题、图例、轴、系列、标签和格式。
用户和开发人员可以基于数据范围创建图表，并且通常使用表创建图表。
函数用于创建一个图表，该图表接受图表、数据和。 参数支持以下值
- 自动
- 标量
- 矩阵
Excel 支持多种不同类型的图表。 开发人员可以使用 方法将图表添加到工作表。
参数指定要使用的图表类型。 有关Excel.ChartType enum的可用选项，请参阅 SDK。
参数指定系列是按行还是按列。 有关Excel.ChartSeriesBy enum的可用选项，请参阅 SDK。
Excel 图表对象包含开发人员可用于在 Excel 工作表中自定义图表的多个属性。 下表列出了 Office.js 图表对象中的一些常用属性：
除了上表中的属性外，图表对象还包括多个关系属性。 这些会影响图表在 Excel 中的显示方式：
以下代码示例演示如何使用 Office.js API 在 Excel 中创建和操作图表：
使用表数据添加聚集柱形图
按名称获取现有图表
修改图表属性，例如位置、标题、颜色和字号