Skip to content

保存

设计器提供保存按钮。点击保存时会对当前表单配置执行校验,通过后方会向父级发送配置数据;若存在错误则阻止保存,需先修正再保存。

保存前检查

保存时会依次进行以下检查:

类型说明
错误存在则禁止保存。例如:组件缺少 key、输入型组件缺少 field、表单设置配置错误等。
警告仅提示,不阻止保存。例如:field 仍为默认生成值,可能尚未改为实际业务字段名。

仅当不存在任何错误时,保存才会成功并触发后续消息。

保存成功后的行为

校验通过后,设计器会向父级窗口发送 designer-save 消息,父级可通过监听该消息获取:

  • 事件名:designer-save
  • data:当前表单的完整配置文档数据(即设计器产出的 JSON 配置)

父窗口接收到该消息后, 必须发送 designer-save-successdesigner-save-failed 事件来告知设计器是否成功保存到业务项目。

父级可根据该数据做持久化、提交接口或二次处理。

错误时如何处理

若保存被拦截,界面会提示具体错误项。请根据提示修正(如补全 keyfield 或修正表单设置),修正后再次点击保存即可。