流程、层级与循环关系若只用文字罗列,读者需要逐行比对才能理清先后与从属;换成 SmartArt 图形后,节点按布局自动排布,连线把关系直接画出来,增加节点时图形也会随之调整。手工在 PowerPoint 中逐个绘制既费时,又难以保证间距与对齐一致。
本文使用 Spire.Presentation for JavaScript 在浏览器中创建并调整 PowerPoint SmartArt 图形。整个处理过程基于 WebAssembly,在用户设备本地完成,无需安装 Office,也不依赖后端服务,演示文稿不必离开浏览器。
本文介绍两个核心功能点:
有关安装和项目配置,请参考 React 项目中集成 Spire.Presentation for JavaScript。以下示例默认 Spire.Presentation for JavaScript 已安装、WebAssembly 模块已初始化。
在 PowerPoint 中创建 SmartArt 图形
在 PowerPoint 中创建 SmartArt 图形,可以先选定与内容关系相符的布局,再把文字写进节点。布局决定节点的排列方式与连线走向,创建时一次指定,后续只需维护节点文字。图形插入后仍可移动、缩放,与普通形状一样参与页面排版。
| 写法 | 得到的结果 |
|---|---|
slide.Shapes.AppendSmartArt(x, y, width, height, layoutType) |
在指定位置与大小添加指定布局的 SmartArt 图形 |
smartArt.Nodes.Count |
当前图形中的节点总数 |
smartArt.Nodes.RemoveNode({ index: i }) |
删除索引 i 对应的节点 |
smartArt.Nodes.AddNode() |
在节点集合末尾追加一个节点 |
node.TextFrame.Text |
设置或读取节点文字 |
具体操作步骤如下:
- 获取 Spire.Presentation 的 WASM 模块并确认已就绪,将字体文件与演示文稿载入 VFS。
- 创建
Presentation对象并调用LoadFromFile()加载演示文稿,再用Slides.get_Item()取得要放置图形的幻灯片。 - 调用
Shapes.AppendSmartArt()传入位置、大小与SmartArtLayoutType,得到ISmartArt对象。 - 从
Nodes.Count开始倒序遍历,用Nodes.RemoveNode()删除布局自带的占位节点。 - 按顺序调用
Nodes.AddNode()添加节点,并通过TextFrame.Text写入文字。 - 调用
Presentation.SaveToFile()保存结果文件,并用Dispose()释放演示文稿,随后从 VFS 读出文件并触发下载。
在 PowerPoint 中创建 SmartArt 图形的代码如下:
function App() {
const createSmartArt = 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 = 'SmartArt.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);
// 在指定位置与大小添加流程布局的 SmartArt
const smartArt = slide.Shapes.AppendSmartArt(50, 160, 620, 200, pptModule.SmartArtLayoutType.BasicProcess);
// 删除布局自带的占位节点
for (let i = smartArt.Nodes.Count - 1; i >= 0; i--) {
smartArt.Nodes.RemoveNode({ index: i });
}
// 按流程顺序添加节点并写入文字
const steps = ['需求分析', '方案设计', '开发实现', '测试上线'];
for (const text of steps) {
const node = smartArt.Nodes.AddNode();
node.TextFrame.Text = text;
}
// 保存结果文件
const outputFileName = 'CreateSmartArt.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>创建 SmartArt 图形</h1>
<button onClick={createSmartArt}>
创建 SmartArt
</button>
</div>
);
}
export default App;
在 PowerPoint 中创建 SmartArt 图形后的演示文稿:

向 SmartArt 图形添加节点
向 SmartArt 图形添加节点时,可以按层级逐级补充:先添加顶层节点,再在它的子节点集合中添加下属节点,也可以按位置插入,让新节点落在正确的次序上。已有节点的文字与从属关系保持不变,图形按新的节点数量重新排布。
| 写法 | 得到的结果 |
|---|---|
smartArt.Nodes.AddNode() |
在图形最上层添加一个节点 |
node.ChildNodes.AddNode() |
在指定节点下追加一个子节点 |
node.ChildNodes.AddNodeByPosition(position) |
在指定节点的子节点集合中按位置插入一个节点,后续子节点顺次后移 |
node.TextFrame.Text |
设置新节点的文字 |
具体操作步骤如下:
- 获取 Spire.Presentation 的 WASM 模块并确认已就绪,将字体文件与演示文稿载入 VFS。
- 创建
Presentation对象并调用LoadFromFile()加载演示文稿,用Slides.get_Item()取得幻灯片,再用Shapes.AppendSmartArt()添加一个组织架构布局的 SmartArt。 - 倒序遍历节点集合,用
Nodes.RemoveNode()清空布局自带的占位节点。 - 调用
Nodes.AddNode()添加顶层节点,并通过TextFrame.Text写入文字。 - 用顶层节点的
ChildNodes.AddNode()添加下属部门,再调用ChildNodes.AddNodeByPosition()按位置插入一个部门。 - 在部门节点的
ChildNodes中调用AddNode()添加下一级节点。 - 调用
Presentation.SaveToFile()保存结果文件,并用Dispose()释放演示文稿,随后从 VFS 读出文件并触发下载。
向 SmartArt 图形添加节点的代码如下:
function App() {
const addNodes = 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 = 'SmartArt.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);
// 添加组织架构布局的 SmartArt 并清空占位节点
const smartArt = slide.Shapes.AppendSmartArt(50, 160, 620, 200, pptModule.SmartArtLayoutType.OrganizationChart);
for (let i = smartArt.Nodes.Count - 1; i >= 0; i--) {
smartArt.Nodes.RemoveNode({ index: i });
}
// 顶层节点
const root = smartArt.Nodes.AddNode();
root.TextFrame.Text = '总部';
// 在顶层节点下添加部门
const dev = root.ChildNodes.AddNode();
dev.TextFrame.Text = '研发部';
const mkt = root.ChildNodes.AddNode();
mkt.TextFrame.Text = '市场部';
// 在部门之间按位置插入一个部门
const ops = root.ChildNodes.AddNodeByPosition(1);
ops.TextFrame.Text = '运营部';
// 在研发部下添加小组
const team = dev.ChildNodes.AddNode();
team.TextFrame.Text = '前端组';
// 保存结果文件
const outputFileName = 'AddSmartArtNodes.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>添加 SmartArt 节点</h1>
<button onClick={addNodes}>
添加节点
</button>
</div>
);
}
export default App;
向 SmartArt 图形添加节点后的演示文稿:

常见问题
Nodes 与 ChildNodes 有什么区别
原因:Nodes 返回图形中所有层级的节点,ChildNodes 只返回某个节点直接下属的子节点,两个集合的用途不同。
解决:遍历整棵图形时用 Nodes;读取、添加或删除某个节点的直接下属时,用该节点的 ChildNodes:
// 整棵图形的所有节点
for (let i = 0; i < smartArt.Nodes.Count; i++) {
console.log(smartArt.Nodes.get_Item(i).TextFrame.Text);
}
// 某个节点的直接子节点
const root = smartArt.Nodes.get_Item(0);
for (let i = 0; i < root.ChildNodes.Count; i++) {
console.log(root.ChildNodes.get_Item(i).TextFrame.Text);
}
添加子节点后为什么节点跑到了顶层
原因:smartArt.Nodes.AddNode() 在图形的最上层添加节点,不会挂在当前节点下。对组织架构图来说,新节点会成为另一个顶层节点,层级仍为 0。
解决:要把节点加为某个节点的下属,应调用该节点的 ChildNodes.AddNode();需要按位置插入时用 ChildNodes.AddNodeByPosition():
const root = smartArt.Nodes.get_Item(0);
const child = root.ChildNodes.AddNode();
child.TextFrame.Text = '新节点';
获取免费许可证
如果您希望删除结果文档中的评估消息,或者摆脱功能限制,请该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。获取有效期 30 天的临时许可证。







