PPTX

SmartArt

创建预定义的 SmartArt 图示,用于流程、层级结构等

使用 smartart 字段添加 SmartArt 图形 — 预定义的图示布局,用于可视化流程、层级结构、关系等。

基本 SmartArt

import { generatePresentation } from "@office-open/pptx";
{
  "slides": [
    {
      "children": [
        {
          "smartart": {
            "x": "1.3cm",
            "y": "1.3cm",
            "width": "21.2cm",
            "height": "9.3cm",
            "layout": "default",
            "style": "simple1",
            "color": "accent1_2",
            "nodes": [{ "text": "Step 1" }, { "text": "Step 2" }, { "text": "Step 3" }]
          }
        }
      ]
    }
  ]
}

嵌套节点

节点支持嵌套 children,用于层级数据:

{
  "slides": [
    {
      "children": [
        {
          "smartart": {
            "x": "1.3cm",
            "y": "1.3cm",
            "width": "21.2cm",
            "height": "10.6cm",
            "layout": "default",
            "nodes": [
              { "text": "Item A", "children": [{ "text": "Sub A1" }, { "text": "Sub A2" }] },
              { "text": "Item B", "children": [{ "text": "Sub B1" }] },
              { "text": "Item C" }
            ]
          }
        }
      ]
    }
  ]
}

SmartArt 样式

控制视觉样式和配色方案:

{
  "slides": [
    {
      "children": [
        {
          "smartart": {
            "x": "1.3cm",
            "y": "1.3cm",
            "width": "21.2cm",
            "height": "9.3cm",
            "layout": "process1",
            "nodes": [{ "text": "Phase 1" }, { "text": "Phase 2" }, { "text": "Phase 3" }],
            "color": "accent2_1",
            "style": "simple1"
          }
        }
      ]
    }
  ]
}

SmartArt 选项

选项类型说明
xnumber | UniversalMeasure水平位置
ynumber | UniversalMeasure垂直位置
widthnumber | UniversalMeasure宽度
heightnumber | UniversalMeasure高度
layoutstring布局 ID(如 "default""process1"
stylestring快速样式 ID(如 "simple1""moderate1"
colorstring配色变换 ID(如 "accent1_2""colorful1"
nodesTreeNode[]{ text, children? } 对象数组
Copyright © 2026