演示文稿中的表格常随数据变化而增补:多出一项指标就要补一列,名单里多一个条目就要加一行;沿用旧模板时,过期的记录与不再需要的字段又要整行整列删去。逐格手工增删既费时,也容易把行高、列宽与单元格格式带乱,表格一多便难以保证前后一致。
本文使用 Spire.Presentation for JavaScript 在浏览器中为 PowerPoint 表格插入与删除行和列。整个处理过程基于 WebAssembly,在用户设备本地完成,无需安装 Office,也不依赖后端服务,演示文稿不必离开浏览器。
本文介绍三个核心功能点:
有关安装和项目配置,请参考 React 项目中集成 Spire.Presentation for JavaScript。以下示例默认 Spire.Presentation for JavaScript 已安装、WebAssembly 模块已初始化。
在 PowerPoint 表格中插入行
表格里要补进一条新记录时,直接找一处空白另起一行并不容易与上下行对齐,行高、字体与底纹都要重新设置,稍不注意就与整张表不一致。以现有一行为样板复制一份,再把它插入到指定位置,新行会沿用该行的行高与单元格格式,只需把文字逐格改写。插入位置由索引决定,新行落位之后,其后的行依次后移,后续取单元格时要用新的编号。
| 写法 | 得到的结果 |
|---|---|
slide.Shapes.get_Item(index) |
按索引取得幻灯片上的形状 |
shape instanceof pptModule.ITable |
判断形状是否为表格 |
table.TableRows.Count |
表格的当前行数 |
table.TableRows.get_Item(index) |
按索引取得行,索引从 0 开始 |
table.TableRows.Insert(index, row) |
以指定的行为样板,在该索引处插入一行 |
row.get_Item(columnIndex) |
取得行中指定列的单元格 |
cell.TextFrame.Text |
设置或读取单元格中的文字 |
具体操作步骤如下:
- 获取 Spire.Presentation 的 WASM 模块并确认已就绪,将字体文件与演示文稿载入 VFS,创建
Presentation对象并调用LoadFromFile()加载,再用Slides.get_Item(0)取得第一张幻灯片。 - 遍历形状集合,用
shape instanceof pptModule.ITable找到幻灯片上的表格。 - 用
table.TableRows.get_Item()取出一行作为样板,把它交给table.TableRows.Insert(),在目标索引处插入一份副本;样板行不必与插入位置相邻。 - 用
table.TableRows.get_Item()取回新插入的行,逐格把文字写入cell.TextFrame.Text,覆盖从样板行复制来的内容。 - 调用
Presentation.SaveToFile()保存结果文件,并用Dispose()释放演示文稿,随后从 VFS 读出文件并触发下载。
在 PowerPoint 表格中插入行的代码如下:
function App() {
const insertRow = async () => {
// 获取 Spire.Presentation WASM 模块
const pptModule = window.wasmModule?.spirepresentation;
// 检查模块是否就绪
if (!pptModule) {
alert('Spire.Presentation is not ready yet');
return;
}
// 将字体与演示文稿载入 VFS
await window.spire.FetchFileToVFS('simsun.ttc', '/Library/Fonts/', `${process.env.PUBLIC_URL}/font/`);
const inputFileName = 'cn_TableRowsColumns.pptx';
await window.spire.FetchFileToVFS(inputFileName, '', `${process.env.PUBLIC_URL}/data/`);
// 加载演示文稿并取得第一张幻灯片
const ppt = new pptModule.Presentation();
ppt.LoadFromFile(inputFileName);
const slide = ppt.Slides.get_Item(0);
// 找到幻灯片上的表格
let table = null;
for (let i = 0; i < slide.Shapes.Count; i++) {
const shape = slide.Shapes.get_Item(i);
if (shape instanceof pptModule.ITable) {
table = shape;
}
}
// 以第 2 行为样板,插入为第 4 行
table.TableRows.Insert(3, table.TableRows.get_Item(1));
// 取回新插入的行,逐格写入新记录
const newRow = table.TableRows.get_Item(3);
const rowData = ['上线部署', '陈晨', '08-01', '08-15', '未开始'];
for (let col = 0; col < rowData.length; col++) {
newRow.get_Item(col).TextFrame.Text = rowData[col];
}
// 保存结果文件
const outputFileName = 'InsertRow_result.pptx';
ppt.SaveToFile({ file: outputFileName, fileFormat: pptModule.FileFormat.Pptx2013 });
ppt.Dispose();
// 从 VFS 读取生成的文件,触发下载
const fileArray = window.dotnetRuntime.Module.FS.readFile(outputFileName);
const blob = new Blob([fileArray], { type: 'application/vnd.openxmlformats-officedocument.presentationml.presentation' });
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = outputFileName;
a.click();
URL.revokeObjectURL(url);
};
return (
<div style={{ textAlign: 'center', height: '300px' }}>
<h1>在 PowerPoint 中增删表格行列</h1>
<button onClick={insertRow}>插入行</button>
</div>
);
}
export default App;
在 PowerPoint 表格中插入一行后的演示文稿:

在 PowerPoint 表格中插入列
表格需要增加一个字段时,仅在右侧补上文字并不足以形成新列,列宽、边框与底纹都要与相邻列一致。列集合同样可以拿已有的列作样板:复制一份后插入到指定列位置,新列会继承样板的列宽与单元格格式,表格总宽相应增加。插入之前先留出这部分横向空间,表格才不会越过幻灯片边界。
| 写法 | 得到的结果 |
|---|---|
table.ColumnsList.Count |
表格的当前列数 |
table.ColumnsList.get_Item(index) |
按索引取得列,索引从 0 开始 |
table.ColumnsList.Insert(index, column) |
以指定的列为样板,在该索引处插入一列 |
table.get_Item(columnIndex, rowIndex) |
按列、行索引取得单元格 |
cell.TextFrame.Text |
设置或读取单元格中的文字 |
具体操作步骤如下:
- 获取 Spire.Presentation 的 WASM 模块并确认已就绪,将字体文件与演示文稿载入 VFS,创建
Presentation对象并调用LoadFromFile()加载,再用Slides.get_Item(0)取得第一张幻灯片。 - 遍历形状集合,用
shape instanceof pptModule.ITable找到幻灯片上的表格。 - 用
table.ColumnsList.get_Item()取出一列作为样板,把它交给table.ColumnsList.Insert(),在目标索引处插入一份副本。 - 按新的列索引,用
table.get_Item()逐行取得单元格,把文字写入cell.TextFrame.Text,覆盖从样板列复制来的内容。 - 调用
Presentation.SaveToFile()保存结果文件,并用Dispose()释放演示文稿,随后从 VFS 读出文件并触发下载。
在 PowerPoint 表格中插入列的代码如下:
function App() {
const insertColumn = async () => {
// 获取 Spire.Presentation WASM 模块
const pptModule = window.wasmModule?.spirepresentation;
// 检查模块是否就绪
if (!pptModule) {
alert('Spire.Presentation is not ready yet');
return;
}
// 将字体与演示文稿载入 VFS
await window.spire.FetchFileToVFS('simsun.ttc', '/Library/Fonts/', `${process.env.PUBLIC_URL}/font/`);
const inputFileName = 'cn_TableRowsColumns.pptx';
await window.spire.FetchFileToVFS(inputFileName, '', `${process.env.PUBLIC_URL}/data/`);
// 加载演示文稿并取得第一张幻灯片
const ppt = new pptModule.Presentation();
ppt.LoadFromFile(inputFileName);
const slide = ppt.Slides.get_Item(0);
// 找到幻灯片上的表格
let table = null;
for (let i = 0; i < slide.Shapes.Count; i++) {
const shape = slide.Shapes.get_Item(i);
if (shape instanceof pptModule.ITable) {
table = shape;
}
}
// 以第 5 列为样板,插入为第 3 列
table.ColumnsList.Insert(2, table.ColumnsList.get_Item(4));
// 按新的列索引,逐行写入新字段的文字
const columnData = ['完成率', '100%', '100%', '65%', '0%'];
for (let row = 0; row < columnData.length; row++) {
table.get_Item(2, row).TextFrame.Text = columnData[row];
}
// 保存结果文件
const outputFileName = 'InsertColumn_result.pptx';
ppt.SaveToFile({ file: outputFileName, fileFormat: pptModule.FileFormat.Pptx2013 });
ppt.Dispose();
// 从 VFS 读取生成的文件,触发下载
const fileArray = window.dotnetRuntime.Module.FS.readFile(outputFileName);
const blob = new Blob([fileArray], { type: 'application/vnd.openxmlformats-officedocument.presentationml.presentation' });
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = outputFileName;
a.click();
URL.revokeObjectURL(url);
};
return (
<div style={{ textAlign: 'center', height: '300px' }}>
<h1>在 PowerPoint 中增删表格行列</h1>
<button onClick={insertColumn}>插入列</button>
</div>
);
}
export default App;
在 PowerPoint 表格中插入一列后的演示文稿:

删除 PowerPoint 表格中的行和列
沿用旧表格时,过期的记录与不再需要的字段要整行整列清掉,而页面上的标题、图片等形状必须原样保留。行集合与列集合各自提供按索引删除的成员,一次调用删去一行或一列,其余内容不受影响;删除之后,其后的行列依次前移,表格宽度随列数收窄。要连续删除多处时从后往前进行,编号才不会在过程中错位。
| 写法 | 得到的结果 |
|---|---|
table.TableRows.Count |
表格的当前行数 |
table.ColumnsList.Count |
表格的当前列数 |
table.TableRows.RemoveAt(index, false) |
删除索引对应的行 |
table.ColumnsList.RemoveAt(index, false) |
删除索引对应的列 |
具体操作步骤如下:
- 获取 Spire.Presentation 的 WASM 模块并确认已就绪,将字体文件与演示文稿载入 VFS,创建
Presentation对象并调用LoadFromFile()加载,再用Slides.get_Item(0)取得第一张幻灯片。 - 遍历形状集合,用
shape instanceof pptModule.ITable找到幻灯片上的表格。 - 调用
table.TableRows.RemoveAt()删除不再需要的行,调用table.ColumnsList.RemoveAt()删除不再需要的列;每次调用去掉一行或一列。 - 调用
Presentation.SaveToFile()保存结果文件,并用Dispose()释放演示文稿,随后从 VFS 读出文件并触发下载。
删除 PowerPoint 表格中的行和列的代码如下:
function App() {
const removeRowsAndColumns = async () => {
// 获取 Spire.Presentation WASM 模块
const pptModule = window.wasmModule?.spirepresentation;
// 检查模块是否就绪
if (!pptModule) {
alert('Spire.Presentation is not ready yet');
return;
}
// 将字体与演示文稿载入 VFS
await window.spire.FetchFileToVFS('simsun.ttc', '/Library/Fonts/', `${process.env.PUBLIC_URL}/font/`);
const inputFileName = 'cn_TableRowsColumns.pptx';
await window.spire.FetchFileToVFS(inputFileName, '', `${process.env.PUBLIC_URL}/data/`);
// 加载演示文稿并取得第一张幻灯片
const ppt = new pptModule.Presentation();
ppt.LoadFromFile(inputFileName);
const slide = ppt.Slides.get_Item(0);
// 找到幻灯片上的表格
let table = null;
for (let i = 0; i < slide.Shapes.Count; i++) {
const shape = slide.Shapes.get_Item(i);
if (shape instanceof pptModule.ITable) {
table = shape;
}
}
// 删除第 3 行与第 4 列
table.TableRows.RemoveAt(2, false);
table.ColumnsList.RemoveAt(3, false);
// 保存结果文件
const outputFileName = 'RemoveRowsColumns_result.pptx';
ppt.SaveToFile({ file: outputFileName, fileFormat: pptModule.FileFormat.Pptx2013 });
ppt.Dispose();
// 从 VFS 读取生成的文件,触发下载
const fileArray = window.dotnetRuntime.Module.FS.readFile(outputFileName);
const blob = new Blob([fileArray], { type: 'application/vnd.openxmlformats-officedocument.presentationml.presentation' });
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = outputFileName;
a.click();
URL.revokeObjectURL(url);
};
return (
<div style={{ textAlign: 'center', height: '300px' }}>
<h1>在 PowerPoint 中增删表格行列</h1>
<button onClick={removeRowsAndColumns}>删除行列</button>
</div>
);
}
export default App;
删除 PowerPoint 表格中的一行和一列后的演示文稿:

常见问题
如何在表格末尾追加行或列
原因:Insert() 需要在指定索引处落位,往表格末尾补内容时还要先算出末尾的索引。
解决:希望直接追加到末尾时,可用 TableRows.Append() 与 ColumnsList.Add(),把样板行或样板列交给它们,新行、新列会排在表格最后:
table.TableRows.Append(table.TableRows.get_Item(1));
table.ColumnsList.Add(table.ColumnsList.get_Item(1));
如何一次向表格插入多行或多列
原因:Insert() 与 Append() 一次只处理一行或一列,要新增的行数或列数较多时,需要分多次调用。
解决:把插入动作放进循环,重复次数就是新增的行数或列数;每次让索引递增,新行、新列会连续排在表格中:
for (let i = 0; i < 2; i++) {
table.TableRows.Insert(2 + i, table.TableRows.get_Item(1));
}
for (let i = 0; i < 2; i++) {
table.ColumnsList.Insert(2 + i, table.ColumnsList.get_Item(1));
}
如何设置插入行或列后的行高与列宽
原因:新行沿用样板行的高度,新列沿用样板列的宽度;要改成其他尺寸,需要先从行集合与列集合取到对应的行、列。
解决:TableRows 与 ColumnsList 都按索引取得行与列(索引从 0 开始),分别设置 Height 与 Width,表格的总高与总宽随之变化:
table.TableRows.get_Item(1).Height = 60;
table.ColumnsList.get_Item(0).Width = 90;
如何清空表格内容并保留行列结构
原因:有时只需要沿用表格的行列与样式,原有文字要全部去掉;直接删除行列会改变表格结构。
解决:按当前的行数与列数做双重循环,把每个单元格的 TextFrame.Text 设为空字符串,行高、列宽与样式保持不变:
for (let row = 0; row < table.TableRows.Count; row++) {
for (let col = 0; col < table.ColumnsList.Count; col++) {
table.get_Item(col, row).TextFrame.Text = '';
}
}
获取免费许可证
如果您希望删除结果文档中的评估消息,或者摆脱功能限制,请该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。获取有效期 30 天的临时许可证。







