演示文稿中的参数对照、清单与汇总数字,用表格呈现比大段文字更直观。逐页手工插入表格、逐格填写内容,页数一多既费时,也容易出现行列数目不一致、样式前后不统一的情况;复用旧模板时,页面上残留的过时表格又要整张清理。
本文使用 Spire.Presentation for JavaScript 在浏览器中创建与删除 PowerPoint 表格。整个处理过程基于 WebAssembly,在用户设备本地完成,无需安装 Office,也不依赖后端服务,演示文稿不必离开浏览器。
本文介绍两个核心功能点:
有关安装和项目配置,请参考 React 项目中集成 Spire.Presentation for JavaScript。以下示例默认 Spire.Presentation for JavaScript 已安装、WebAssembly 模块已初始化。
在 PowerPoint 幻灯片中添加表格
新建的演示文稿自带一张空白幻灯片,表格的插入位置与列宽、行高都在插入时一并确定。先按行列数目给出各列宽度与各行高度,再把文字逐格写入,表格就能准确落在页面的预期区域。套用内置表格样式后,表头与明细行自动区分底色,不必逐格设置边框与填充,多张幻灯片上的表格也能保持一致的观感。
| 写法 | 得到的结果 |
|---|---|
Presentation.Slides.get_Item(index) |
按索引取得幻灯片,索引从 0 开始 |
slide.Shapes.AppendTable(x, y, widths, heights) |
在指定位置按给定列宽与行高添加表格 |
table.get_Item(columnIndex, rowIndex) |
按列、行索引取得单元格 |
cell.TextFrame.Text |
设置或读取单元格中的文字 |
cell.TextFrame.Paragraphs.get_Item(0).TextRanges.get_Item(0) |
取得单元格首段的文本范围,用于设置字体 |
textRange.LatinFont |
设置文本范围的字体 |
paragraph.Alignment = TextAlignmentType.Center |
把段落设为水平居中 |
table.StylePreset = TableStylePreset.MediumStyle1Accent2 |
套用内置表格样式 |
具体操作步骤如下:
- 获取 Spire.Presentation 的 WASM 模块并确认已就绪,将字体文件载入 VFS,再创建
Presentation对象,用Slides.get_Item(0)取得第一张幻灯片。 - 准备列宽与行高数组,调用
slide.Shapes.AppendTable()添加表格,返回的对象即可用于后续写值。 - 逐行逐列遍历数据,用
table.get_Item()取得单元格,把文字写入cell.TextFrame.Text,再通过TextRanges.get_Item(0)设置LatinFont。 - 把表头行各单元格的段落
Alignment设为TextAlignmentType.Center,并把StylePreset设为TableStylePreset.MediumStyle1Accent2。 - 调用
Presentation.SaveToFile()保存结果文件,并用Dispose()释放演示文稿,随后从 VFS 读出文件并触发下载。
在 PowerPoint 幻灯片中添加表格的代码如下:
function App() {
const addTable = async () => {
// 获取 Spire.Presentation WASM 模块
const pptModule = window.wasmModule?.spirepresentation;
// 检查模块是否就绪
if (!pptModule) {
alert('Spire.Presentation is not ready yet');
return;
}
// 将字体载入 VFS
await window.spire.FetchFileToVFS('arial.ttf', '/Library/Fonts/', `${process.env.PUBLIC_URL}/font/`);
// 创建演示文稿,并取得第一张幻灯片
const ppt = new pptModule.Presentation();
const slide = ppt.Slides.get_Item(0);
// 定义四列宽度与五行高度(单位:点)
const widths = [150, 150, 150, 150];
const heights = [40, 40, 40, 40, 40];
// 在指定位置添加四列五行的表格
const table = slide.Shapes.AppendTable(60, 120, widths, heights);
// 准备写入表格的数据,首行为表头
const data = [
['产品', '一月', '二月', '三月'],
['笔记本电脑', '320', '368', '402'],
['台式机', '215', '238', '260'],
['显示器', '410', '452', '498'],
['打印机', '180', '196', '214'],
];
// 逐行逐列写入单元格文字,并统一设置字体
for (let row = 0; row < data.length; row++) {
for (let col = 0; col < data[row].length; col++) {
const cell = table.get_Item(col, row);
cell.TextFrame.Text = data[row][col];
const textRange = cell.TextFrame.Paragraphs.get_Item(0).TextRanges.get_Item(0);
textRange.LatinFont = new pptModule.TextFont('Arial');
}
}
// 表头行居中,并套用内置表格样式
for (let col = 0; col < 4; col++) {
table.get_Item(col, 0).TextFrame.Paragraphs.get_Item(0).Alignment = pptModule.TextAlignmentType.Center;
}
table.StylePreset = pptModule.TableStylePreset.MediumStyle1Accent2;
// 保存结果文件
const outputFileName = 'AddTable_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={addTable}>添加表格</button>
</div>
);
}
export default App;
添加表格后的演示文稿:

删除 PowerPoint 幻灯片中的表格
表格与文字、图片、图形同处一张幻灯片的形状集合中,按索引删除很容易误伤其他元素。先遍历集合,按类型把表格挑出来放进一个独立数组,再逐个删除,其余形状不受影响。这样处理的另一处好处是,即使一张幻灯片上有多张表格,也能一次清理干净。
| 写法 | 得到的结果 |
|---|---|
slide.Shapes.Count |
幻灯片上的形状总数 |
slide.Shapes.get_Item(index) |
按索引取得幻灯片上的形状 |
shape instanceof pptModule.ITable |
判断形状是否为表格 |
slide.Shapes.Remove(shape) |
从幻灯片上删除指定形状 |
具体操作步骤如下:
- 获取 Spire.Presentation 的 WASM 模块并确认已就绪,将字体文件与演示文稿载入 VFS,创建
Presentation对象并调用LoadFromFile()加载,再用Slides.get_Item(0)取得第一张幻灯片。 - 以
Shapes.Count为上限遍历形状集合,用Shapes.get_Item(i)逐个取出形状,通过shape instanceof pptModule.ITable判断是否为表格,命中的放入独立数组。 - 遍历该数组,对每个表格调用
Shapes.Remove()从幻灯片上删除。 - 调用
Presentation.SaveToFile()保存结果文件,并用Dispose()释放演示文稿,随后从 VFS 读出文件并触发下载。
删除 PowerPoint 幻灯片中的表格的代码如下:
function App() {
const removeTable = async () => {
// 获取 Spire.Presentation WASM 模块
const pptModule = window.wasmModule?.spirepresentation;
// 检查模块是否就绪
if (!pptModule) {
alert('Spire.Presentation is not ready yet');
return;
}
// 将演示文稿载入 VFS
const inputFileName = 'cn_Tables.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);
// 遍历形状集合,把表格收集到独立的数组
const tables = [];
for (let i = 0; i < slide.Shapes.Count; i++) {
const shape = slide.Shapes.get_Item(i);
if (shape instanceof pptModule.ITable) {
tables.push(shape);
}
}
// 逐个从幻灯片上删除表格
for (let i = 0; i < tables.length; i++) {
slide.Shapes.Remove(tables[i]);
}
// 保存结果文件
const outputFileName = 'RemoveTable_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={removeTable}>删除表格</button>
</div>
);
}
export default App;
删除幻灯片中的表格后的演示文稿:

常见问题
如何调整表格的列宽与行高
原因:表格的列宽与行高在插入时按数组给定,插入之后要单独调整某一列或某一行,需要先从行列集合中取到对应的对象。
解决:ColumnsList 与 TableRows 可以按索引取到列与行(索引从 0 开始),分别设置 Width 与 Height,表格的总宽高随之变化:
table.ColumnsList.get_Item(1).Width = 220;
table.TableRows.get_Item(1).Height = 60;
如何让单元格里的文字垂直居中
原因:单元格的文字默认锚定在顶部,行高调大之后文字贴在上边缘,看起来不再居中。
解决:把单元格的 TextAnchorType 设为 TextAnchorType.Center;需要靠上或靠下时,分别换成 Top 或 Bottom:
table.get_Item(col, row).TextAnchorType = pptModule.TextAnchorType.Center;
获取免费许可证
如果您希望删除结果文档中的评估消息,或者摆脱功能限制,请该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。获取有效期 30 天的临时许可证。







