教程：创建 Excel 表格并设置其格式

项目
11/17/2023

本教程介绍了录制、编辑和编写 Office 脚本 for Excel 的基础知识。你将录制一个脚本，以便将某些格式应用于销售记录工作表。然后，可编辑录制的脚本以应用更多格式、创建表格并对表格进行排序。这种“先记录后编辑”模式是查看 Microsoft Excel 操作作为代码的外观的重要工具。

先决条件

在本教程中，你需要访问 Office 脚本。如果未显示“自动”选项卡，请查看平台支持。

重要

本教程面向在 JavaScript 或 TypeScript 方面具备初级到中级知识的人员。如果你不熟悉 JavaScript，建议从 Mozilla JavaScript 教程入手。请访问 Office 脚本代码编辑器环境，以了解有关脚本环境的详细信息。

添加数据和录制基本脚本

首先，需要一些数据和一个小的起始脚本。

创建新的 Excel 工作簿。
复制以下水果销售数据，并将其粘贴到工作表中，从单元格 A1 开始。

水果 2018 2019

橙子 1000 1200

柠檬 800 900

酸橙 600 500

葡萄柚 900 700
打开“自动”选项卡。如果未看到“自动”选项卡，请通过选择下拉箭头来检查功能区溢出。如果仍未解决问题，请按照文章解决 Office 脚本问题中的建议操作。
选择“录制操作”按钮。
选择单元格“A2:C2”（“橙色”行），并将填充颜色设置为橙色。
通过选择“停止”按钮来停止录制。

你的工作表应如下所示（不要担心颜色是否不同）:

水果	2018	2019
橙子	1000	1200
柠檬	800	900
酸橙	600	500
葡萄柚	900	700

编辑现有脚本

前面的脚本将“橙子”行的颜色设置为橙色。为“Lemons”添加黄色行。

从立即打开的 详细信息 窗格中，选择“编辑”按钮。
你应该会该看到与此代码类似的内容：
```
function main(workbook: ExcelScript.Workbook) {
  // Set fill color to FFC000 for range Sheet1!A2:C2
  let selectedSheet = workbook.getActiveWorksheet();
  selectedSheet.getRange("A2:C2").getFormat().getFill().setColor("FFC000");
}
```
此代码从工作簿中获取当前工作表。然后，它将设置区域 A2:C2 的填充颜色。

区域是 Excel 中的 Office 脚本的基本组成部分。区域是一个连续的矩形单元格块，其中包含值、公式和格式。它们是单元格的基本结构，你可以通过它们执行大多数脚本编写任务。
将以下行添加到脚本的末尾（在 color 设置位置和结束 } 之间）：
```
selectedSheet.getRange("A3:C3").getFormat().getFill().setColor("yellow");
```
通过选择“运行”来测试脚本。工作簿现在应如下所示：

创建表格

接下来，将此水果销售数据转换为表。你将继续修改整个教程的第一个脚本。

将以下行添加到脚本的末尾（在结束 } 之前）：
```
let table = selectedSheet.addTable("A1:C5", true);
```
该调用将返回 Table 对象。使用该表对数据进行排序。根据“Fruit”列中的值按升序对数据进行排序。在创建表格后添加以下行：
```
table.getSort().apply([{ key: 0, ascending: true }]);
```
你的脚本应如下所示：
```
function main(workbook: ExcelScript.Workbook) {
    // Set fill color to FFC000 for range Sheet1!A2:C2
    let selectedSheet = workbook.getActiveWorksheet();
    selectedSheet.getRange("A2:C2").getFormat().getFill().setColor("FFC000");
    selectedSheet.getRange("A3:C3").getFormat().getFill().setColor("yellow");
    let table = selectedSheet.addTable("A1:C5", true);
    table.getSort().apply([{ key: 0, ascending: true }]);
}
```
表格具有 TableSort 对象，可通过 Table.getSort 方法进行访问。可以对该对象应用排序条件。 apply 方法接受 SortField 对象的数组。在这种情况下，只有一个排序条件，因此只使用一个 SortField。 key: 0 将具有排序定义值的列设置为“0”（这是表格上的第一列，在本示例中为 A）。 ascending: true 以升序（而不是降序）对数据进行排序。
运行脚本。你看到的表格应类似于：

注意

如果重新运行该脚本，将会收到错误消息。这是因为不能在另一个表格的顶部创建表格。但是，可以在其他工作表或工作簿上运行脚本。

重新运行脚本

在当前工作簿中创建一个新的工作表。
从教程开头复制水果数据，并将其粘贴到新的工作表中，从单元格 A1 开始。
运行脚本。

后续步骤

完成教程：清理和规范化 Excel 工作簿数据。它指导你如何使用 Office 脚本从工作簿中读取数据。