---
title: .spg SuperPage 页面元数据
description: .spg SuperPage 页面文件阅读入口，指向任意低代码页面、PC/移动端页面、组件树、动作和资源引用的 DTS 说明
navTitle: .spg
---
# .spg SuperPage 页面元数据

SuperPage 是最通用的低代码页面形态，可以制作数据查询页面、信息展示页面、业务办理页、表单入口、对话框页面、侧边栏页面，甚至报告型页面和普通网页。它既可以显示在 PC 端，也可以适用于移动端；通常通过数据集、组件、布局、事件动作和程序流，把数据展示、表单录入、按钮操作、页面跳转和组件联动组织成一个可运行的交互界面。

当你要搭建门户首页、业务办理页、详情页、数据查询页、信息展示页、管理控制台、弹窗/侧栏承载页或多个组件协作的复合页面时，应优先考虑 SuperPage。如果页面主要是中国式报表、复杂报表或 Excel 风格的固定版式输出，通常用报表（rpt）；主要是数据可视化分析，通常用仪表板（dash）；主要是周期填报、提交、锁定和审批，通常用报表填报应用（fapp）。

spg 文件遵守 SuccApp Super JSON 规范，参数、数据集、表体、组件树、交互动作、页面设置、内部资源和资源引用等共同结构由页面基础类型承接；具体组件、数据集、布局和动作分支继续按对应 DTS 阅读。

第一次直接编辑 `.spg` 文件时，先阅读 [SuccApp Super JSON](../../rules/super-json.md) 中的[编辑 .spg 文件](../../rules/super-json.md#edit-spg)，再打开 DTS 理解页面主体、数据集、组件树和动态分支。

## 示例文件{#examples}

- [概览.spg](https://demo.succbi.com/v5/DEMO/app/whats-new.app/概览.spg) - SuperPage 概览页面
- [index.spg](https://demo.succbi.com/v5/DEMO/app/Course.app/index.spg) - 课程应用首页
- [打开链接\_基本功能.spg](https://demo.succbi.com/v5/DEMO/app/afl.app/节点/打开链接/打开链接_基本功能.spg) - 页面事件调用程序流示例

## DTS 入口{#types}

- 根结构：[`types/meta/file-types/spg.d.ts`](../../../../../dev-types/types/meta/file-types/spg.d.ts)
- 页面基础结构：[`types/meta/visual-page/visualpage.d.ts`](../../../../../dev-types/types/meta/visual-page/visualpage.d.ts)
- 组件类型：[`types/meta/component/index.d.ts`](../../../../../dev-types/types/meta/component/index.d.ts)
- 数据集类型：[`types/meta/dataset/index.d.ts`](../../../../../dev-types/types/meta/dataset/index.d.ts)
- 动作节点：[`types/meta/actionComponent/index.d.ts`](../../../../../dev-types/types/meta/actionComponent/index.d.ts)
- 布局类型：[`types/meta/componentLayout/index.d.ts`](../../../../../dev-types/types/meta/componentLayout/index.d.ts)
- 原始 BO 类型：[`types/api/succ.bo.d.ts`](../../../../../dev-types/types/api/succ.bo.d.ts)