React中通过Props传入JSON配置实现表单动态渲染,核心是将字段类型、校验、布局等逻辑外置,组件仅负责解析执行;JSON需含name、label、type等字段,支持扩展自定义type及visibleWhen等动态行为,最终封装为可复用的SchemaForm组件。

用 Props 传入 JSON 配置,让表单组件根据结构自动渲染字段,是 React 中轻量级配置化开发的常用方式。核心在于把表单逻辑从组件内部抽离,交由外部 JSON 定义字段类型、校验、布局等,组件只负责“解释”和“执行”。
JSON 配置设计:定义字段元信息
一份可驱动表单的 JSON 至少需包含 字段名(name)、标签(label)、类型(type) 和可选的 校验规则(rules)、默认值(value)、是否禁用(disabled) 等。例如:
{
"fields": [
{
"name": "username",
"label": "用户名",
"type": "input",
"rules": [{ "required": true, "message": "请输入用户名" }]
},
{
"name": "gender",
"label": "性别",
"type": "select",
"options": [
{ "value": "male", "label": "男" },
{ "value": "female", "label": "女" }
]
}
]
}
注意 type 不必严格对应 HTML 原生类型(如 "input"、"select"、"textarea"),可扩展为 "date-picker"、"upload" 等自定义组件标识,只要渲染层能识别即可。
Props 接收与结构解析
表单组件通过 Props 接收该 JSON 配置对象(常命名为 schema 或 formConfig),并在 render 或 JSX 中遍历 fields 数组。关键点:
- 每个字段生成独立子组件,用
name作为 key 和受控值绑定依据 - 根据
type动态选择渲染组件:type === 'select' ? <select></select> : type === 'input' ? <input> : null - 将
label、rules、options等透传给对应子组件作为 Props - 配合
useState或表单库(如 Formik、Ant Design Form)管理整体数据流
支持动态行为:联动、显隐与校验
纯静态字段不够用,真实场景需要条件控制。可在 JSON 中增加 dependencies 或 visibleWhen 字段,例如:
{
"name": "idCard",
"label": "身份证号",
"type": "input",
"visibleWhen": { "field": "isChinese", "value": true }
}
组件内部监听依赖字段变化,实时计算当前字段是否应显示。校验也可在 JSON 中声明异步规则(如调用接口查重),由父组件或自定义 Hook 封装请求逻辑并注入。
封装可复用的 SchemaForm 组件
把上述逻辑收敛成一个通用组件,如 <schemaform schema="{config}" onchange="{handleDataChange}"></schemaform>。它不关心业务含义,只做三件事:
- 解析 schema,生成字段映射和初始值
- 为每个字段创建受控输入,并聚合提交数据
- 暴露统一事件(如 onChange、onSubmit、onValidate)供业务层处理
后续新增表单只需维护 JSON 配置,无需改动组件代码,也便于对接低代码平台或后端动态下发表单结构。



















