一份演示文稿改到第二版、第三版,图片往往最先过时:产品换了新外观,配图要整张替换;页面排版收紧,图片得等比缩小;某张示意图不再需要,就该从页面上拿掉。在桌面软件里逐页点选,几十页的稿子要重复同样的动作;交给服务端处理,文件又得先上传出去。
本文用 Spire.Presentation for JavaScript 在浏览器里直接调整、替换和删除 PowerPoint 图片。三个操作都围绕 SlidePicture 这个图片形状展开。整个过程基于 WebAssembly 在浏览器端完成,无需安装 Office,也不依赖后端,文件始终留在用户的设备上。
本文介绍三个核心功能点:
有关安装和项目配置,请参考 React 项目中集成 Spire.Presentation for JavaScript。下面的示例假定 Spire.Presentation 已安装、WebAssembly 模块已初始化。
编辑 PowerPoint 图片
Spire.Presentation for JavaScript 提供 IEmbedImage 接口,可以编辑幻灯片上图片的大小、位置、旋转角度、名称、可替代文本和透明度等属性。
具体操作步骤如下:
- 获取 Spire.Presentation 的 WASM 模块,确认已就绪。
- 使用
Presentation.LoadFromFile()方法加载一个 PowerPoint 演示文稿。 - 遍历文档中的所有幻灯片,以及每张幻灯片上的所有形状。
- 设置图片相关属性。
- 使用
Presentation.SaveToFile()方法保存结果演示文稿,从 VFS 读出并触发浏览器下载。
编辑图片的代码如下:
function App() {
const editImages = async () => {
// 获取 Spire.Presentation WASM 模块
const pptModule = window.wasmModule?.spirepresentation;
// 检查模块是否就绪
if (!pptModule) {
alert('Spire.Presentation is not ready yet');
return;
}
// 载入示例演示文稿与字体
await window.spire.FetchFileToVFS('示例演示文稿.pptx', '', `${process.env.PUBLIC_URL}/data/`);
await window.spire.FetchFileToVFS('ARIALUNI.TTF', '/Library/Fonts/', `${process.env.PUBLIC_URL}/font/`);
// 创建 Presentation 实例并加载演示文稿
const ppt = new pptModule.Presentation();
ppt.LoadFromFile('示例演示文稿.pptx');
// 逐页遍历幻灯片与形状
let pictureIndex = 0;
for (let i = 0; i < ppt.Slides.Count; i++) {
const slide = ppt.Slides.get_Item(i);
for (let j = 0; j < slide.Shapes.Count; j++) {
const shape = slide.Shapes.get_Item(j);
// 判断是否为图片形状,并转成 IEmbedImage
if (shape instanceof pptModule.SlidePicture) {
const image = pptModule.IEmbedImage.Convert(shape);
// 设置大小、位置与旋转角度
image.Width = 200;
image.Height = 150;
image.Left = 80 + pictureIndex * 220;
image.Top = 160;
image.Rotation = 10;
// 设置名称、可替代文本与可替代标题
image.Name = `产品图片_${pictureIndex + 1}`;
image.AlternativeText = '产品展示图';
image.AlternativeTitle = `image${pictureIndex + 1}`;
// 设置透明度(百分比)
image.PictureFill.Picture.Transparency = 30;
pictureIndex++;
}
}
}
// 保存结果文件
const outputFileName = '编辑图片后.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 id="btn-1" onClick={editImages}>
编辑图片
</button>
</div>
);
}
export default App;
图片的大小、位置、旋转角度和透明度都已更新:

替换 PowerPoint 中的指定图片
Spire.Presentation for JavaScript 提供 Presentation.Images 集合,可以用新图片替换幻灯片上的指定图片。
具体操作步骤如下:
- 获取 Spire.Presentation 的 WASM 模块,确认已就绪。
- 读入示例演示文稿、新图片与字体,创建
Presentation对象并加载演示文稿。 - 用
new Stream()打开新图片文件,通过Presentation.Images.Append()加入图片资源。 - 取目标幻灯片,遍历
Shapes,按AlternativeTitle找到图片形状并替换EmbedImage。 - 保存结果文件,从 VFS 读出并触发浏览器下载。
替换指定图片的代码如下:
function App() {
const replaceImage = async () => {
// 获取 Spire.Presentation WASM 模块
const pptModule = window.wasmModule?.spirepresentation;
// 检查模块是否就绪
if (!pptModule) {
alert('Spire.Presentation is not ready yet');
return;
}
// 载入示例演示文稿、新图片与字体
await window.spire.FetchFileToVFS('示例演示文稿.pptx', '', `${process.env.PUBLIC_URL}/data/`);
await window.spire.FetchFileToVFS('新图片.png', '', `${process.env.PUBLIC_URL}/data/`);
await window.spire.FetchFileToVFS('ARIALUNI.TTF', '/Library/Fonts/', `${process.env.PUBLIC_URL}/font/`);
// 创建 Presentation 实例并加载演示文稿
const ppt = new pptModule.Presentation();
ppt.LoadFromFile('示例演示文稿.pptx');
// 把新图片加入文档的图片资源
const stream = new pptModule.Stream('新图片.png');
const image = ppt.Images.Append({ stream });
stream.Close();
// 取第二张幻灯片,找到替代标题为 image1 的图片并替换
const slide = ppt.Slides.get_Item(1);
for (let i = 0; i < slide.Shapes.Count; i++) {
const shape = slide.Shapes.get_Item(i);
if (shape instanceof pptModule.SlidePicture && shape.AlternativeTitle === 'image1') {
shape.PictureFill.Picture.EmbedImage = image;
}
}
// 保存结果文件
const outputFileName = '替换图片后.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 id="btn-2" onClick={replaceImage}>
替换图片
</button>
</div>
);
}
export default App;
第二张幻灯片中的目标图片已换成新图:

按顺序定位图片
示例用 AlternativeTitle 匹配目标图片,值来自文档里设置的替代标题。图片没有设置替代标题时,可以按它在页面上的先后顺序定位:
// 取第二张幻灯片上的第一张图片
const slide = ppt.Slides.get_Item(1);
let pictureIndex = 0;
for (let i = 0; i < slide.Shapes.Count; i++) {
const shape = slide.Shapes.get_Item(i);
if (shape instanceof pptModule.SlidePicture) {
if (pictureIndex === 0) {
shape.PictureFill.Picture.EmbedImage = image;
}
pictureIndex++;
}
}
删除 PowerPoint 中的图片
Spire.Presentation for JavaScript 提供 Shapes.RemoveAt() 方法,可以删除幻灯片上的图片形状。
具体操作步骤如下:
- 获取 Spire.Presentation 的 WASM 模块,确认已就绪。
- 读入示例演示文稿与字体,创建
Presentation对象并加载该文件。 - 用
Slides.get_Item(1)取第二张幻灯片。 - 从后往前遍历
Shapes,用instanceof SlidePicture筛出图片并调用RemoveAt()删除。 - 保存结果文件,从 VFS 读出并触发浏览器下载。
删除页面图片的代码如下:
function App() {
const deleteImages = async () => {
// 获取 Spire.Presentation WASM 模块
const pptModule = window.wasmModule?.spirepresentation;
// 检查模块是否就绪
if (!pptModule) {
alert('Spire.Presentation is not ready yet');
return;
}
// 载入示例演示文稿与字体
await window.spire.FetchFileToVFS('示例演示文稿.pptx', '', `${process.env.PUBLIC_URL}/data/`);
await window.spire.FetchFileToVFS('ARIALUNI.TTF', '/Library/Fonts/', `${process.env.PUBLIC_URL}/font/`);
// 创建 Presentation 实例并加载演示文稿
const ppt = new pptModule.Presentation();
ppt.LoadFromFile('示例演示文稿.pptx');
// 取第二张幻灯片
const slide = ppt.Slides.get_Item(1);
// 从后往前遍历,删除页面上的所有图片形状
for (let i = slide.Shapes.Count - 1; i >= 0; i--) {
if (slide.Shapes.get_Item(i) instanceof pptModule.SlidePicture) {
slide.Shapes.RemoveAt(i);
}
}
// 保存结果文件
const outputFileName = '删除图片后.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 id="btn-3" onClick={deleteImages}>
删除图片
</button>
</div>
);
}
export default App;
第二张幻灯片上的图片已全部删除:

只删除指定的图片
不想清空整页时,在循环里加一个条件,只移除匹配的图片:
// 倒序遍历,只删除替代标题为 image1 的图片
for (let i = slide.Shapes.Count - 1; i >= 0; i--) {
const shape = slide.Shapes.get_Item(i);
if (shape instanceof pptModule.SlidePicture && shape.AlternativeTitle === 'image1') {
slide.Shapes.RemoveAt(i);
}
}
常见问题
修改图片宽高后为什么只从左上角变化
原因:Width 和 Height 只改图片形状的宽高,Left 与 Top 保持原值,左上角成为缩放的固定点。
解决:需要以中心或页面为基准缩放时,同步调整 Left 与 Top:
// 以原中心为基准缩放
const centerX = shape.Left + shape.Width / 2;
const centerY = shape.Top + shape.Height / 2;
shape.Width = shape.Width * scale;
shape.Height = shape.Height * scale;
shape.Left = centerX - shape.Width / 2;
shape.Top = centerY - shape.Height / 2;
替换图片时为什么匹配不到目标图片
原因:示例按 shape.AlternativeTitle === 'image1' 判断,示例演示文稿里的目标图片已经设置了这个替代标题。文档里没有设置,或者值不同,条件就不成立。
解决:先打印页面里所有图片形状的替代标题,再按实际值匹配。也可以改用上面的按顺序定位。
if (shape instanceof pptModule.SlidePicture) {
console.log(shape.AlternativeTitle, shape.Name);
}
替换后图片为什么被拉伸或变模糊
原因:替换只换嵌入的图源,图片形状的宽高没有变。新图的比例与原来的显示框不一致时,会被拉伸。新图分辨率低于显示尺寸时,看起来会发虚。
解决:选用比例接近的图片,或者在替换后同步调整 Width 与 Height。需要保持比例时,按新图的宽高比计算其中一个值。
删除后为什么页面上还能看到图片
原因:代码只移除了页面 Shapes 里的 SlidePicture。母版、版式、背景填充里的图片,以及组合形状内部的图片,不在这一层集合中。
解决:母版图片通过 Presentation.Masters 处理,背景图片需要清除对应页的填充,组合形状要先拆组,或进入组合内部递归查找图片形状。
获取免费许可证
如果您希望删除结果文档中的评估消息,或者摆脱功能限制,请该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。获取有效期 30 天的临时许可证。







