Appearance
保存
设计器提供保存按钮。点击保存时会对当前表单配置执行校验,通过后方会向父级发送配置数据;若存在错误则阻止保存,需先修正再保存。
保存前检查
保存时会依次进行以下检查:
| 类型 | 说明 |
|---|---|
| 错误 | 存在则禁止保存。例如:组件缺少 key、输入型组件缺少 field、表单设置配置错误等。 |
| 警告 | 仅提示,不阻止保存。例如:field 仍为默认生成值,可能尚未改为实际业务字段名。 |
仅当不存在任何错误时,保存才会成功并触发后续消息。
保存成功后的行为
校验通过后,设计器会向父级窗口发送 designer-save 消息,父级可通过监听该消息获取:
- 事件名:
designer-save - data:当前表单的完整配置文档数据(即设计器产出的 JSON 配置)
父窗口接收到该消息后, 必须发送 designer-save-success 或 designer-save-failed 事件来告知设计器是否成功保存到业务项目。
父级可根据该数据做持久化、提交接口或二次处理。
错误时如何处理
若保存被拦截,界面会提示具体错误项。请根据提示修正(如补全 key、field 或修正表单设置),修正后再次点击保存即可。