---
{
  "id": "platform.slide.content-elements-and-limits",
  "topic": "slide",
  "title": "Slide 內容版本、元素、主題與限制",
  "locale": "zh-TW",
  "version": "2026-07-25",
  "summary": "Slide 使用有版本的結構化 JSON，限制內容大小與元素數量；deck theme 採嚴格 allowlist，元素擴充 key 則保持向前相容。",
  "content": "投影片 body 是帶頂層 `version` 與 `elements` 的 JSON。runtime 接受 legacy version 1 與 canonical version 2，不存在 version 3；新空白頁使用 version 2 與空陣列。元素類型為 `text`、`image`、`shape`（`rect`/`ellipse`）、`table`。每個元素需有 slide 內唯一的非空 ID，以及有限的 x、y、width、height；width/height 必須為正。各類型欄位另行驗證，圖片規則見專屬卡。\n\n每個 deck 最多 200 slides，每張最多 200 elements，serialized content 最多 256 KiB（262,144 bytes）；這些是行為常數。table 是 rows 陣列，列、欄與 cell text 超限會回 `invalid_arguments`，細節以 runtime error 為準。text 與 speakerNotes 過長也會被拒；長文應拆成多頁或改用 Memo。Action envelope 的最新形狀查 `arinova.action.get_schema`。\n\ndeck theme 是獨立 metadata object，採已知 key 的嚴格 allowlist，且巢狀 JSON value 必須安全；未知 theme key 會被拒絕。預設長寬比僅接受 `16:9` 或 `4:3`。相對地，只要必要 base 與 type-specific 欄位有效，單一 element 內的未知額外 key 會刻意保留，以維持向前相容；read-modify-write 時不要把這些擴充欄位剝除。\n",
  "aliases": [
    "簡報 JSON",
    "內容版本",
    "文字圖形表格",
    "元素上限",
    "簡報主題",
    "長寬比"
  ],
  "tags": [
    "slide",
    "content",
    "elements",
    "limits",
    "theme"
  ],
  "relatedActions": [
    "arinova.slide.create_deck",
    "arinova.slide.get_deck",
    "arinova.slide.add_slide",
    "arinova.slide.update_slide"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/slide/content-elements-and-limits/"
}
---

投影片 body 是帶頂層 `version` 與 `elements` 的 JSON。runtime 接受 legacy version 1 與 canonical version 2，不存在 version 3；新空白頁使用 version 2 與空陣列。元素類型為 `text`、`image`、`shape`（`rect`/`ellipse`）、`table`。每個元素需有 slide 內唯一的非空 ID，以及有限的 x、y、width、height；width/height 必須為正。各類型欄位另行驗證，圖片規則見專屬卡。

每個 deck 最多 200 slides，每張最多 200 elements，serialized content 最多 256 KiB（262,144 bytes）；這些是行為常數。table 是 rows 陣列，列、欄與 cell text 超限會回 `invalid_arguments`，細節以 runtime error 為準。text 與 speakerNotes 過長也會被拒；長文應拆成多頁或改用 Memo。Action envelope 的最新形狀查 `arinova.action.get_schema`。

deck theme 是獨立 metadata object，採已知 key 的嚴格 allowlist，且巢狀 JSON value 必須安全；未知 theme key 會被拒絕。預設長寬比僅接受 `16:9` 或 `4:3`。相對地，只要必要 base 與 type-specific 欄位有效，單一 element 內的未知額外 key 會刻意保留，以維持向前相容；read-modify-write 時不要把這些擴充欄位剝除。