同一组图形往往要在多张幻灯片上重复出现:流程示意、图例、装饰色块在多页之间保持相近的样式。手工逐页复制虽然可行,但页面一多就容易遗漏,把图形搬到版式不同的页面上时,位置与尺寸也常常需要重新对齐。通过 Spire.Presentation for JavaScript 在生成演示文稿的同时完成形状复制,可以让同一组图形在各页之间保持一致,也省去了反复调整的时间。
本文使用 Spire.Presentation for JavaScript 在浏览器中复制 PowerPoint 幻灯片中的形状。整个处理过程基于 WebAssembly,在用户设备本地完成,无需安装 Office,也不依赖后端服务,演示文稿不必离开浏览器。
本文介绍两个核心功能点:
有关安装和项目配置,请参考 React 项目中集成 Spire.Presentation for JavaScript。以下示例默认 Spire.Presentation for JavaScript 已安装、WebAssembly 模块已初始化。
将指定形状复制到另一张幻灯片
借用其他页面上已经排好的图形,是制作演示文稿时常见的做法:前一页介绍的图形,后续页面仍要沿用;模板页中的示范图形,也要出现在具体内容页上。复制单个形状时,只需指明它在源幻灯片中的位置,再把它加入目标幻灯片,形状的填充、边框与文字会随之一起带过去,源幻灯片本身保持不变。
| 写法 | 得到的结果 |
|---|---|
Presentation.Slides.get_Item(index) |
按索引取得演示文稿中的幻灯片,索引从 0 开始 |
slide.Shapes |
取得幻灯片上的全部形状 |
slide.Shapes.get_Item(index) |
按索引取出幻灯片中的某个形状 |
slide.Shapes.Count |
取得幻灯片上的形状总数 |
targetSlide.Shapes.AddShape(sourceShape) |
把源形状复制到目标幻灯片,副本保留原有的位置与尺寸 |
具体操作步骤如下:
- 获取 Spire.Presentation 的 WASM 模块并确认已就绪,将字体文件与演示文稿载入 VFS,再创建
Presentation对象并加载该文件。 - 通过
Presentation.Slides.get_Item()分别取得源幻灯片与目标幻灯片。 - 用源幻灯片的
Shapes.get_Item()取出要复制的形状,交给目标幻灯片的Shapes.AddShape()完成复制。 - 调用
Presentation.SaveToFile()保存结果文件,并用Dispose()释放演示文稿,随后从 VFS 读出文件并触发下载。
将指定形状复制到另一张幻灯片的代码如下:
function App() {
const copyShape = 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_ShapeDeck.pptx';
await window.spire.FetchFileToVFS(inputFileName, '', `${process.env.PUBLIC_URL}/data/`);
// 加载演示文稿
const ppt = new pptModule.Presentation();
ppt.LoadFromFile(inputFileName);
// 指定源幻灯片与目标幻灯片
const sourceSlide = ppt.Slides.get_Item(0);
const targetSlide = ppt.Slides.get_Item(1);
// 把源幻灯片中的第 2 个形状复制到目标幻灯片
targetSlide.Shapes.AddShape(sourceSlide.Shapes.get_Item(1));
// 保存结果文件
const outputFileName = 'CopyShape_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>复制幻灯片中的形状</h1>
<button onClick={copyShape}>复制指定形状</button>
</div>
);
}
export default App;
将指定形状复制到另一张幻灯片后的演示文稿:

将一张幻灯片中的所有形状复制到另一张幻灯片
一页幻灯片上常有标题、说明文字与若干图形,逐个复制既繁琐又容易漏项。借助形状集合,可以按索引遍历源幻灯片上的每一个形状,依次复制到目标幻灯片,使目标页获得与源页相同的整套内容。目标页是空白页时,复制完成后即可直接作为一页完整的内容页使用。
具体操作步骤如下:
- 将字体与演示文稿载入 VFS,加载演示文稿后取得源幻灯片与目标幻灯片。
- 以
Shapes.Count作为循环上限,用Shapes.get_Item()逐个取出源幻灯片上的形状。 - 在循环体内把每个形状交给目标幻灯片的
Shapes.AddShape(),完成整页复制。 - 调用
Presentation.SaveToFile()保存结果文件,并用Dispose()释放演示文稿,随后从 VFS 读出文件并触发下载。
将一张幻灯片中的所有形状复制到另一张幻灯片的代码如下:
function App() {
const copyAllShapes = 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_ShapeDeck.pptx';
await window.spire.FetchFileToVFS(inputFileName, '', `${process.env.PUBLIC_URL}/data/`);
// 加载演示文稿
const ppt = new pptModule.Presentation();
ppt.LoadFromFile(inputFileName);
// 指定源幻灯片与空白的目标幻灯片
const sourceSlide = ppt.Slides.get_Item(0);
const targetSlide = ppt.Slides.get_Item(2);
// 逐个取出源幻灯片中的形状并复制到目标幻灯片
for (let i = 0; i < sourceSlide.Shapes.Count; i++) {
targetSlide.Shapes.AddShape(sourceSlide.Shapes.get_Item(i));
}
// 保存结果文件
const outputFileName = 'CopyAllShapes_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>复制幻灯片中的所有形状</h1>
<button onClick={copyAllShapes}>复制幻灯片中的所有形状</button>
</div>
);
}
export default App;
将一张幻灯片中的所有形状复制到另一张幻灯片后的演示文稿:

常见问题
复制后的形状是否保留原有的填充与文字格式
原因:复制形状时,除了轮廓与位置,形状内部的文字、填充色与字号也需要一并保留,才能直接沿用源页面的排版。
解决:AddShape() 复制的是形状本身,填充、线条、文字与字体设置都会随之保留。复制完成后取回该形状,读取 Fill 与 TextFrame 即可确认:
const copiedShape = targetSlide.Shapes.get_Item(targetSlide.Shapes.Count - 1);
console.log(copiedShape.Fill.SolidColor.Color.ToString());
console.log(copiedShape.TextFrame.Text, copiedShape.TextFrame.TextRange.FontHeight);
复制后如何调整形状的位置与尺寸
原因:复制得到的形状会沿用源幻灯片上的坐标,落在与源页相同的位置;目标页的版式不同,或者希望图形换一处摆放时,就需要在复制之后再调整。
解决:复制完成后,用集合的末位索引取回该形状,再设置 Left、Top、Width 与 Height:
const copiedShape = targetSlide.Shapes.get_Item(targetSlide.Shapes.Count - 1);
copiedShape.Left = 470;
copiedShape.Top = 170;
copiedShape.Width = 160;
copiedShape.Height = 100;
如何把形状复制到其他演示文稿
原因:图形常常沉淀在模板文件或旧项目里,新的演示文稿需要把它们引过来,逐个重画成本很高。
解决:复制时传入的形状对象并不限定来自同一个演示文稿。分别加载源文稿与目标文稿,把源文稿中的形状交给目标文稿的幻灯片,再保存目标文稿即可:
const sourcePpt = new pptModule.Presentation();
sourcePpt.LoadFromFile('source.pptx');
const targetPpt = new pptModule.Presentation();
targetPpt.Slides.get_Item(0).Shapes.AddShape(sourcePpt.Slides.get_Item(0).Shapes.get_Item(0));
targetPpt.SaveToFile({ file: 'output.pptx', fileFormat: pptModule.FileFormat.Pptx2013 });
获取免费许可证
如果您希望删除结果文档中的评估消息,或者摆脱功能限制,请该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。获取有效期 30 天的临时许可证。







