JSON Editor 中 anyOf 切换时保持默认值的解决方案

在 JSON Schema 编辑器的使用过程中，开发者经常会遇到 anyOf 或 oneOf 结构切换时保留原有值的问题。本文将以一个典型场景为例，介绍如何通过配置解决这一问题。

问题场景

假设我们有一个包含 anyOf 结构的 JSON Schema，其中定义了两个不同的对象类型："John Doe Container"和"Jane Doe Container"。每个类型都有自己默认的 name 属性值。

当用户添加新项目时，编辑器会正确使用第一个选项的默认值。但当用户在已存在的项目间切换时，编辑器会保留之前的值，而不是应用新选项的默认值。这与许多实际业务场景中的预期行为不符。

解决方案

JSON Editor 提供了一个配置选项 keep_oneof_values 来控制这种行为。默认情况下，该选项为 true，意味着在切换 anyOf/oneOf 选项时会保留现有值。

要实现在切换时重置为默认值的行为，只需将该选项设置为 false：

{
  keep_oneof_values: false
}

实现原理

当 keep_oneof_values 设置为 false 时，编辑器会在用户切换 anyOf/oneOf 选项时执行以下操作：

1. 完全清除当前对象的所有属性
2. 应用新选中选项的默认值
3. 重新渲染表单控件

这种机制确保了界面与数据模型的一致性，同时也符合用户对"切换选项即重置"的直觉预期。

实际应用

这个配置不仅适用于 anyOf 结构，同样适用于 oneOf 结构。在实际项目中，这种配置特别适用于以下场景：

• 表单中有互斥的选项组
• 不同选项对应完全不同的数据结构
• 需要确保用户选择新选项时从干净状态开始

通过合理使用这个配置，可以显著提升表单编辑体验，减少用户因残留值导致的困惑。