跳到内容

Schema 参考

Toolpad Studio 文件格式的详尽参考。

文件

以下是 toolpad 支持的各种文件。

应用程序

对象
定义此对象的版本。用于确定 Toolpad Studio “应用程序”对象之间的兼容性。
apiVersion: "v1"
描述此 Toolpad Studio “应用程序”对象的性质。
kind: "application"
定义此“应用程序”对象的形状
spec: 对象
此应用程序的计划。
计划: "free" | "pro"
此应用程序的身份验证配置。
身份验证: 对象
要使用的身份验证提供程序。
提供程序: array of object
此身份验证提供程序的唯一标识符。
提供程序: "github" | "google" | "azure-ad" | "credentials"
此身份验证提供程序的角色映射定义。
角色: array of object
要从中映射的身份验证提供程序角色。
: array of string
要映射到的 Toolpad Studio 角色。
目标: string

已验证用户的有效电子邮件模式。
restrictedDomains: array of string

此应用程序的授权配置。
授权: 对象
此应用程序的可用角色。这些角色可以分配给用户。
角色: array of any of
  • string
  • 对象
    角色的名称。
    名称: string
    角色的描述。
    描述: string

页面

对象
定义此对象的版本。用于确定 Toolpad Studio “页面”对象之间的兼容性。
apiVersion: "v1"
描述此 Toolpad Studio “页面”对象的性质。
kind: "page"
定义此“页面”对象的形状
spec: 对象
要在 UI 中显示的页面名称。
显示名称: string
用作页面的规范 ID。已弃用:请改用别名。
id: string
页面名称别名。
别名: array of string
此页面的标题。
标题: string
页面的参数。这些可以在 url 查询字符串中设置。
参数: array of NameStringValuePair
页面使用的查询。这些将在页面打开时加载数据。
查询: array of object
查询的名称
名称: string
激活或停用查询。停用后,页面打开时不会加载数据。
已启用: 任何一个
要传递给此查询的参数。
参数: 数组
名称/值对。
对象
名称
名称: string
: 任何一个

如何获取此查询。
模式: 任何一个
  • 页面打开时自动获取
    "query"
  • 仅在手动操作时获取
    "mutation"

查询定义
查询: 任何一个

要在响应上运行的转换
转换: string
启用转换
启用转换: boolean
重新运行此查询的间隔
重新获取间隔: number
重新获取前要缓存的时间
缓存时间: number

页面的内容。这定义了 UI。
内容: array of Element
此页面的授权配置。
授权: 对象
允许所有用户访问此页面。
允许所有: boolean
允许访问此页面的角色。
允许的角色: array of string

页面的显示模式。也可以在运行时使用 toolpad-display 查询参数设置
显示: 任何一个
  • 隐藏 Toolpad Studio chrome,仅显示页面内容
    "standalone"
  • 显示 Toolpad Studio 标头和导航。
    "shell"

页面的顶层元素。
maxWidth: "xs" | "sm" | "md" | "lg" | "xl" | "none"

主题

对象
定义此对象的版本。用于确定 Toolpad Studio “主题”对象之间的兼容性。
apiVersion: "v1"
描述此 Toolpad Studio “主题”对象的性质。
kind: "theme"
定义此“主题”对象的形状
spec: 对象
ThemeOptions 对象,它被馈送到 MUI 的 createTheme 函数中。
选项: 对象

定义

这些是在整个 Toolpad Studio 文件中使用的共享定义。

JsExpressionBinding

一个绑定,用于评估表达式并返回结果。

对象
要评估的表达式。
$$jsExpression: string

EnvBinding

一个环境变量。

对象
环境变量的名称。
$$env: string

JsExpressionAction

触发此操作时要执行的 javascript 表达式。

对象
要执行的代码。
$$jsExpressionAction: string

NavigationAction

从一个页面导航到另一个页面,可以选择将参数传递到下一个页面。

对象
$$navigationAction: 对象
要导航到的页面
页面: string
导航到此页面时要传递的参数
参数: 对象

BindableProp

元素

组件的实例。用于在页面中构建用户界面。

对象
此元素所基于的组件。
组件: string
此组件的名称,用于在绑定中引用它。
名称: string
此元素的布局属性。
布局: 对象
沿水平轴布局元素。
水平对齐: string
沿垂直轴布局元素。
垂直对齐: string
此元素占用的宽度,以页面上的列表示。
列大小: number
此元素占用的高度,以像素为单位。
高度: number

此元素的子元素。
子元素: array of Element
用于配置此组件实例的属性。
属性: 对象

模板

描述 Toolpad Studio 元素的片段,用作模板。

对象
子树,描述要由模板渲染的 UI。
$$template: array of Element

NameStringValuePair

具有字符串值的名称/值对。

对象
名称
名称: string
: string

BindableNameStringValue

名称/值对,其中值可以动态绑定到字符串。

对象
名称
名称: string
: 任何一个

SimplePaletteColorOptions

对象
main: string
light: string
dark: string
contrastText: string