演示文稿中的动画决定了内容在放映时出现的方式与节奏。形状、标题和要点如果一次性全部显示,观众很难跟上讲解的顺序;逐页手动设置动画,既费时,也难以在批量生成的文档中保持统一。通过 Spire.Presentation for JavaScript 为形状添加动画,可以在生成演示文稿的同时安排好每页的呈现顺序,让内容与效果一起稳定复用。
本文使用 Spire.Presentation for JavaScript 在浏览器中为 PowerPoint 形状添加动画。整个处理过程基于 WebAssembly,在用户设备本地完成,无需安装 Office,也不依赖后端服务,演示文稿不必离开浏览器。
本文介绍两个核心功能点:
有关安装和项目配置,请参考 React 项目中集成 Spire.Presentation for JavaScript。以下示例默认 Spire.Presentation for JavaScript 已安装、WebAssembly 模块已初始化。
为 PowerPoint 形状添加入场动画
新添加的形状在放映时不会自动带有动效。为它们指定入场动画后,形状会按动画序列依次呈现,讲解时可以逐步展开内容,而不是让整页一次性呈现。每张幻灯片的动画保存在同一个主动画序列中,按添加的先后排列,放映时也按这个顺序触发。
| 写法 | 得到的结果 |
|---|---|
slide.Timeline.MainSequence |
取得当前幻灯片的主动画序列,按顺序存放页内的动画效果 |
MainSequence.AddEffect(shape, effectType) |
为一个形状添加动画效果,返回对应的效果对象 |
AnimationEffectType.FadedSwivel、FadedZoom、Float 等成员 |
指定入场动画的效果类型,如淡出旋转、淡出缩放、浮入 |
slide.Shapes.AppendShape({ shapeType, rectangle }) |
在幻灯片指定区域内添加形状 |
具体操作步骤如下:
- 获取 Spire.Presentation 的 WASM 模块并确认已就绪,将字体文件载入 VFS,再创建
Presentation对象。 - 通过
Presentation.Slides.get_Item(0)取得第一张幻灯片。 - 用
Shapes.AppendShape()添加标题文本框与三个图形,并通过Fill、Line设置填充与边框。 - 依次调用
slide.Timeline.MainSequence.AddEffect(),为三个图形分别指定AnimationEffectType.FadedSwivel、FadedZoom与Float。 - 调用
Presentation.SaveToFile()保存结果文件,并用Dispose()释放演示文稿,随后从 VFS 读出文件并触发下载。
为 PowerPoint 形状添加入场动画的代码如下:
function App() {
const addEntranceAnimation = 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 ppt = new pptModule.Presentation();
const slide = ppt.Slides.get_Item(0);
// 添加标题文本框
const title = slide.Shapes.AppendShape({
shapeType: pptModule.ShapeType.Rectangle,
rectangle: pptModule.RectangleF.FromLTRB(60, 60, 660, 140),
});
title.Fill.FillType = pptModule.FillFormatType.None;
title.Line.FillType = pptModule.FillFormatType.None;
title.AppendTextFrame('形状动画演示');
title.TextFrame.TextRange.FontHeight = 32;
title.TextFrame.TextRange.Fill.FillType = pptModule.FillFormatType.Solid;
title.TextFrame.TextRange.Fill.SolidColor.Color = pptModule.Color.get_Black();
title.TextFrame.Paragraphs.get_Item(0).Alignment = pptModule.TextAlignmentType.Center;
// 添加三个图形
const triangle = slide.Shapes.AppendShape({
shapeType: pptModule.ShapeType.Triangle,
rectangle: pptModule.RectangleF.FromLTRB(90, 240, 190, 340),
});
triangle.Fill.FillType = pptModule.FillFormatType.Solid;
triangle.Fill.SolidColor.Color = pptModule.Color.get_CadetBlue();
triangle.Line.FillType = pptModule.FillFormatType.Solid;
triangle.Line.SolidFillColor.Color = pptModule.Color.get_White();
const rectangle = slide.Shapes.AppendShape({
shapeType: pptModule.ShapeType.Rectangle,
rectangle: pptModule.RectangleF.FromLTRB(250, 240, 430, 340),
});
rectangle.Fill.FillType = pptModule.FillFormatType.Solid;
rectangle.Fill.SolidColor.Color = pptModule.Color.get_LightSkyBlue();
rectangle.Line.FillType = pptModule.FillFormatType.Solid;
rectangle.Line.SolidFillColor.Color = pptModule.Color.get_White();
rectangle.AppendTextFrame('动画形状');
rectangle.TextFrame.TextRange.FontHeight = 24;
const cloud = slide.Shapes.AppendShape({
shapeType: pptModule.ShapeType.Cloud,
rectangle: pptModule.RectangleF.FromLTRB(500, 235, 620, 345),
});
cloud.Fill.FillType = pptModule.FillFormatType.Solid;
cloud.Fill.SolidColor.Color = pptModule.Color.get_White();
cloud.Line.FillType = pptModule.FillFormatType.Solid;
cloud.Line.SolidFillColor.Color = pptModule.Color.get_CadetBlue();
// 为三个图形依次添加入场动画
slide.Timeline.MainSequence.AddEffect(triangle, pptModule.AnimationEffectType.FadedSwivel);
slide.Timeline.MainSequence.AddEffect(rectangle, pptModule.AnimationEffectType.FadedZoom);
slide.Timeline.MainSequence.AddEffect(cloud, pptModule.AnimationEffectType.Float);
// 保存结果文件
const outputFileName = 'AddEntranceAnimation_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={addEntranceAnimation}>添加入场动画</button>
</div>
);
}
export default App;
为三个形状添加入场动画后的演示文稿:

为形状添加退出动画
入场动画决定形状如何出现,退出动画则在讲解完某块内容后把它带走,让页面空出位置给后续内容。调用 AddEffect() 添加效果后,把 PresetClassType 设为 TimeNodePresetClassType.Exit,该效果就从入场改为退出:
const effect = slide.Timeline.MainSequence.AddEffect(shape, pptModule.AnimationEffectType.RandomBars);
effect.PresetClassType = pptModule.TimeNodePresetClassType.Exit;
设置动画的播放时长、延迟与重复方式
默认的动画时长和触发节奏适合单次讲解,遇到需要强调或持续展示的内容便显得不足:有的动画需要放慢,让观众看清变化过程;有的需要在页面停留期间不断重复,提醒观众关注。每个效果对象都带有 Timing,可以分别控制播放时长、延迟与重复方式,而不必改动动画本身的效果类型。
| 写法 | 得到的结果 |
|---|---|
effect.Timing.Duration |
动画播放一次所用的时间,单位为秒 |
effect.Timing.TriggerDelayTime |
触发后延迟播放的时间,单位为秒 |
Timing.AnimationRepeatType |
设置动画的重复方式 |
AnimationRepeatType.UtilEndOfSlide |
持续播放,直到离开本页 |
AnimationRepeatType.Number + Timing.RepeatCount |
按固定次数重复播放 |
具体操作步骤如下:
- 获取 Spire.Presentation 的 WASM 模块并确认已就绪,将字体文件载入 VFS,再创建
Presentation对象并取得第一张幻灯片。 - 用
Shapes.AppendShape()添加两个色块,分别设置填充色。 - 为第一个色块调用
AddEffect()添加动画,再通过effect.Timing.Duration与effect.Timing.TriggerDelayTime设置播放时长与延迟。 - 将
effect.Timing.AnimationRepeatType设为AnimationRepeatType.UtilEndOfSlide,让该动画持续播放到离开本页。 - 为第二个色块添加动画,把
Timing.AnimationRepeatType设为AnimationRepeatType.Number,再用Timing.RepeatCount指定重复次数。 - 保存结果文件、释放演示文稿,随后从 VFS 读出文件并触发下载。
设置动画的播放时长、延迟与重复方式的代码如下:
function App() {
const setAnimationTiming = 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 ppt = new pptModule.Presentation();
const slide = ppt.Slides.get_Item(0);
// 添加两个色块
const firstBar = slide.Shapes.AppendShape({
shapeType: pptModule.ShapeType.Rectangle,
rectangle: pptModule.RectangleF.FromLTRB(120, 180, 320, 360),
});
firstBar.Fill.FillType = pptModule.FillFormatType.Solid;
firstBar.Fill.SolidColor.Color = pptModule.Color.get_CadetBlue();
firstBar.Line.FillType = pptModule.FillFormatType.None;
const secondBar = slide.Shapes.AppendShape({
shapeType: pptModule.ShapeType.Rectangle,
rectangle: pptModule.RectangleF.FromLTRB(400, 180, 600, 360),
});
secondBar.Fill.FillType = pptModule.FillFormatType.Solid;
secondBar.Fill.SolidColor.Color = pptModule.Color.get_LightSkyBlue();
secondBar.Line.FillType = pptModule.FillFormatType.None;
// 为一个色块添加动画,并设置播放时长与延迟
const effect = slide.Timeline.MainSequence.AddEffect(firstBar, pptModule.AnimationEffectType.FadedZoom);
effect.Timing.Duration = 1.5;
effect.Timing.TriggerDelayTime = 0.5;
effect.Timing.AnimationRepeatType = pptModule.AnimationRepeatType.UtilEndOfSlide;
// 为另一个色块添加动画,重复三次
const loopEffect = slide.Timeline.MainSequence.AddEffect(secondBar, pptModule.AnimationEffectType.FadedSwivel);
loopEffect.Timing.Duration = 1;
loopEffect.Timing.AnimationRepeatType = pptModule.AnimationRepeatType.Number;
loopEffect.Timing.RepeatCount = 3;
// 保存结果文件
const outputFileName = 'SetAnimationTiming_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={setAnimationTiming}>设置动画时长与重复</button>
</div>
);
}
export default App;
设置动画的播放时长、延迟与重复方式后的演示文稿:

常见问题
如何读取幻灯片中已有的动画
原因:在已有演示文稿上继续加工时,需要先确认每页已经设置了哪些动画,才能判断是否要补充或调整。
解决:遍历主动画序列,读取每个效果的动画类型、目标形状与播放时长:
const sequence = slide.Timeline.MainSequence;
for (let i = 0; i < sequence.Count; i++) {
const effect = sequence.get_Item(i);
console.log(effect.AnimationEffectType, effect.ShapeTarget.Name, effect.Timing.Duration);
}
如何让动画在上一动画结束后自动播放
原因:新添加的动画默认等待点击才播放,连续几个效果需要逐次点击,节奏容易被打断。
解决:把 Timing.TriggerType 设为 AnimationTriggerType.AfterPrevious,该动画会在上一个动画结束后自动开始;设为 WithPrevious 则与上一个动画同时播放:
effect.Timing.TriggerType = pptModule.AnimationTriggerType.AfterPrevious;
为什么导出的图片中看不到动画
原因:动画记录在演示文稿的动画时间轴中,放映时才按顺序呈现;保存为图片得到的是静态画面,只反映形状最终的样式与位置。
解决:在支持动画的查看器中放映演示文稿查看效果;导出的图片适合用于展示单帧排版,不承载动画过程。
获取免费许可证
如果您希望删除结果文档中的评估消息,或者摆脱功能限制,请该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。获取有效期 30 天的临时许可证。







