---
title: .tpg 超级模板页面元数据
description: .tpg 超级模板页面文件阅读入口，指向模板页面、节点、数据集、模板选项和资源引用的 DTS 说明
navTitle: .tpg
---
# .tpg 超级模板页面元数据

超级模板页面面向门户、站点、专题页面和由模板扩展驱动的首页，适合让模板扩展控制渲染方式。它通常把页面骨架、节点类型、渲染行为和可配置项交给模板管理，文件内主要记录模板选择、页面节点、数据集和模板选项。

当多个门户、专题或站点页面需要共享一致的信息架构和视觉框架，只允许配置节点内容而不希望自由拖拽组件时，应优先考虑超级模板页面。如果需要完全自由的低代码页面编排，通常使用 SuperPage（spg）。

tpg 文件遵守 SuccApp Super JSON 规范，版本、设置、数据集和资源引用等共同结构由页面基础类型承接；领域主体由 `PageSettingsMetaInfo.template` 指向的超级模板、`nodes` 节点树和模板扩展定义的节点属性承接。

第一次直接编辑 `.tpg` 文件时，先阅读 [SuccApp Super JSON](../../rules/super-json.md)，再结合 DTS 和模板扩展配置确认页面主体、节点结构、数据集和资源引用。

## 示例文件{#examples}

- [index.tpg](https://demo.succbi.com/v5/DEMO/app/服饰销售驾驶舱.app/index.tpg) - 驾驶舱门户模板页面示例
- [DEMO/index.tpg](https://demo.succbi.com/v5/DEMO/app/DEMO.app/index.tpg) - DEMO 应用入口模板页面示例

## DTS 入口{#types}

- 根结构：[`types/meta/file-types/tpg.d.ts`](../../../../../dev-types/types/meta/file-types/tpg.d.ts)
- 数据集类型：[`types/meta/dataset/index.d.ts`](../../../../../dev-types/types/meta/dataset/index.d.ts)
- 引用资源：[`types/meta/superjson/referenceResources.d.ts`](../../../../../dev-types/types/meta/superjson/referenceResources.d.ts)