幻灯片上的文字如果一次性全部出现,观众往往来不及逐条理解;把一段文字拆成几个要点依次呈现,讲解的节奏会更清楚。手工为每一段文字设置动画既费时,页数一多也很难保持统一。通过 Spire.Presentation for JavaScript 在生成演示文稿时一并设置文本动画,可以让每段文字的出场方式固定下来,后续复用也不必反复调整。
本文使用 Spire.Presentation for JavaScript 在浏览器中为 PowerPoint 的文本添加动画。整个处理过程基于 WebAssembly,在用户设备本地完成,无需安装 Office,也不依赖后端服务,演示文稿不必离开浏览器。
本文介绍两个核心功能点:
有关安装和项目配置,请参考 React 项目中集成 Spire.Presentation for JavaScript。以下示例默认 Spire.Presentation for JavaScript 已安装、WebAssembly 模块已初始化。
为文本的每个段落添加动画
一段文字常常分成几个段落:先给出概括,再逐条展开。为整个文本框添加动画时,所有文字会作为一个整体播放;把动画按段落拆开,要点就能依次出现。段落数量并不固定,可以先读取文本形状中的段落数量,再循环为每一段添加一个效果,并用起止段落限定各自的范围;如果只需要其中一段先出现,同样可以为这一段单独指定范围。
| 写法 | 得到的结果 |
|---|---|
slide.Shapes.get_Item(index) |
按索引取得幻灯片中的形状,文本形状同样适用 |
slide.Timeline.MainSequence.AddEffect(shape, effectType) |
为形状添加动画效果,返回对应的效果对象 |
effect.SetStartEndParagraphs(start, end) |
限定动画作用的起止段落,段落索引从 0 开始 |
shape.TextFrame.Paragraphs.Count |
取得文本形状中的段落数量,作为循环上限 |
AnimationEffectType.FadedZoom 等成员 |
指定入场动画的效果类型,如淡出缩放 |
具体操作步骤如下:
- 获取 Spire.Presentation 的 WASM 模块并确认已就绪,将字体文件与演示文稿载入 VFS,再创建
Presentation对象并加载该文件。 - 通过
Presentation.Slides.get_Item(0)取得第一张幻灯片,再用Shapes.get_Item()取出其中的文本形状。 - 通过
TextFrame.Paragraphs.Count读取段落数量,作为循环的次数。 - 在循环体内为文本形状调用
MainSequence.AddEffect(),再用SetStartEndParagraphs()把第 i 个段落设为该效果的作用范围。 - 调用
Presentation.SaveToFile()保存结果文件,并用Dispose()释放演示文稿,随后从 VFS 读出文件并触发下载。
为文本的每个段落添加动画的代码如下:
function App() {
const animateParagraphs = 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_AnimationText.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 textShape = slide.Shapes.get_Item(1);
// 取得文本形状中的段落数量
const paragraphCount = textShape.TextFrame.Paragraphs.Count;
// 为每个段落各添加一个动画效果
for (let i = 0; i < paragraphCount; i++) {
const effect = slide.Timeline.MainSequence.AddEffect(textShape, pptModule.AnimationEffectType.FadedZoom);
effect.SetStartEndParagraphs(i, i);
}
// 保存结果文件
const outputFileName = 'AnimateParagraphs_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={animateParagraphs}>为每个段落添加动画</button>
</div>
);
}
export default App;
为文本的每个段落添加动画后的演示文稿:

设置文本按字或按词播放
当一段文字本身就是希望观众留意的语句时,整段同时出现会显得突兀,按字或按词依次呈现则能引导视线逐字读完。文本动画可以指定分组的单位:按字母分组时逐个字母出现,按单词分组时逐个单词出现;再配合间隔设置,控制相邻两组文字出现的快慢。
| 写法 | 得到的结果 |
|---|---|
effect.IterateType + AnimateType.Letter、AnimateType.Word |
指定文字按字母或按单词分组播放 |
effect.IterateTimeValue |
设置相邻两组文字之间的间隔 |
具体操作步骤如下:
- 将字体与演示文稿载入 VFS,加载演示文稿后取得第二张幻灯片与其中的文本形状。
- 为第 1 个段落添加动画并用
SetStartEndParagraphs()限定范围,把IterateType设为AnimateType.Letter,再用IterateTimeValue设置相邻字母的间隔。 - 为第 2 个段落添加另一个动画并限定范围,把
IterateType设为AnimateType.Word,再用IterateTimeValue设置相邻单词的间隔。 - 调用
Presentation.SaveToFile()保存结果文件,并用Dispose()释放演示文稿,随后从 VFS 读出文件并触发下载。
设置文本按字或按词播放的代码如下:
function App() {
const iterateText = 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_AnimationText.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(1);
const textShape = slide.Shapes.get_Item(1);
// 第 1 个段落按字母播放,相邻字母间隔 10
const letterEffect = slide.Timeline.MainSequence.AddEffect(textShape, pptModule.AnimationEffectType.FadedZoom);
letterEffect.SetStartEndParagraphs(0, 0);
letterEffect.IterateType = pptModule.AnimateType.Letter;
letterEffect.IterateTimeValue = 10;
// 第 2 个段落按单词播放,相邻单词间隔 15
const wordEffect = slide.Timeline.MainSequence.AddEffect(textShape, pptModule.AnimationEffectType.Float);
wordEffect.SetStartEndParagraphs(1, 1);
wordEffect.IterateType = pptModule.AnimateType.Word;
wordEffect.IterateTimeValue = 15;
// 保存结果文件
const outputFileName = 'IterateText_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={iterateText}>设置逐字、逐词播放</button>
</div>
);
}
export default App;
设置文本按字或按词播放后的演示文稿:

常见问题
如何调整多个动画的播放顺序
原因:主动画序列按效果添加的先后排列,放映时也按这一顺序触发;后添加的效果总排在末尾,只在末尾追加无法得到想要的先后。
解决:按需要的顺序调用 AddEffect();若效果已经添加、顺序不对,可以用 MainSequence.RemoveAt() 删除它,再按正确顺序重新添加,新效果会排在末尾。重新添加后需要重新设置段落范围与时长:
const sequence = slide.Timeline.MainSequence;
sequence.RemoveAt(0); // 移除位置不对的效果
const effect = sequence.AddEffect(textShape, pptModule.AnimationEffectType.FadedZoom);
effect.SetStartEndParagraphs(0, 0);
如何设置动画的持续时间、延迟和重复次数
原因:默认的动画时长与触发节奏固定,讲解速度不同,或需要循环强调某个效果时,就要单独调整。
解决:通过效果的 Timing 设置播放时长、触发延迟与重复方式。Duration 与 TriggerDelayTime 以秒为单位;按次数重复时把 AnimationRepeatType 设为 Number,再用 RepeatCount 指定次数:
const effect = slide.Timeline.MainSequence.get_Item(0);
effect.Timing.Duration = 1.5; // 播放一次 1.5 秒
effect.Timing.TriggerDelayTime = 0.5; // 触发后延迟 0.5 秒
effect.Timing.AnimationRepeatType = pptModule.AnimationRepeatType.Number;
effect.Timing.RepeatCount = 3; // 重复 3 次
若希望动画一直重复到离开本页,可把 AnimationRepeatType 设为 UtilEndOfSlide。
如何让多个段落动画自动衔接播放
原因:新添加的动画会等待点击才播放,几个段落需要逐次点击,讲解节奏容易被打断。
解决:把效果的 Timing.TriggerType 设为 AnimationTriggerType.AfterPrevious,该动画会在上一个动画结束后自动开始:
effect.Timing.TriggerType = pptModule.AnimationTriggerType.AfterPrevious;
获取免费许可证
如果您希望删除结果文档中的评估消息,或者摆脱功能限制,请该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。获取有效期 30 天的临时许可证。







