如何在Roadie/Backstage模板（JSON Schema）中动态填充枚举值

这确实是非常常见的场景——纯静态的JSON Schema没法满足动态枚举的需求，核心问题在于标准JSON Schema本身不支持动态值注入，你得依赖所用的表单渲染工具或模板引擎来实现，以下是几种无需自定义插件的简便方案：

方案1：在代码中动态构建Schema对象 #

如果你的模板是通过代码（比如JavaScript/TypeScript）生成的，直接在构建Schema时替换枚举值即可：

// 假设myEnvironments是已获取的数组，比如 ['dev', 'test', 'stage', 'prod', 'custom']
const dynamicSchema = {
  properties: {
    envs: {
      title: "Select environments",
      type: "array",
      uniqueItems: true,
      "ui:widget": "checkboxes",
      items: {
        type: "string",
        enum: myEnvironments // 直接注入动态数组
      }
    }
  }
};

这种方式最直接，也不会有模板语法兼容问题。

方案2：利用模板引擎的数组序列化能力 #

如果是用YAML/JSON模板文件（比如Jinja2、Handlebars），关键是让模板引擎把myEnvironments数组序列化为符合YAML格式的数组字符串：

以Jinja2为例： #

properties:
  envs:
    title: Select environments
    type: array
    uniqueItems: true
    ui:widget: checkboxes
    items:
      type: string
      enum: {{ myEnvironments | tojson }}

tojson过滤器会把数组转换成标准的JSON/YAML数组格式，渲染后就会替换成动态的环境列表。

以Handlebars为例： #

需要借助JSON序列化能力（可注册助手函数或直接用内置方法）：

properties:
  envs:
    title: Select environments
    type: array
    uniqueItems: true
    ui:widget: checkboxes
    items:
      type: string
      enum: {{ JSON.stringify(myEnvironments) }}

方案3：基于表单库的动态枚举支持 #

如果用的是react-jsonschema-form这类专门的JSON Schema表单库，可以通过uiSchema在渲染层注入动态选项：

import Form from "react-jsonschema-form";

// 渲染表单时传入动态枚举
<Form
  schema={schema}
  uiSchema={{
    envs: {
      "ui:enumOptions": myEnvironments.map(env => ({ label: env, value: env }))
    }
  }}
/>

这种方式不需要修改原始Schema，直接在渲染层替换选项。

你之前尝试的${{myEnvironments}}或{{myEnvironments}}无效，大概率是因为模板引擎无法直接将数组变量转换为YAML数组格式——默认可能输出数组的字符串表示（比如dev,test,stage）而非标准的[dev, test, stage]结构，所以必须用序列化过滤器做格式转换。

内容的提问来源于stack exchange，提问作者cheese-toast