Park-UI中Radio Group组件值无法变更的问题解析

在Park-UI项目中使用Radio Group组件时，开发者可能会遇到一个常见问题：无法通过交互改变Radio Group的值，同时onValueChange事件也不会触发。这个问题不仅出现在Radio Group组件上，同样会影响Radio Button Group和Segment Group组件。

问题现象

当开发者按照官方文档示例代码实现Radio Group组件时，发现以下异常行为：

1. 点击不同的选项无法改变当前选中的值
2. 绑定的事件处理器onValueChange永远不会被触发

根本原因

经过技术分析，这个问题的主要原因是组件实现中缺少了关键的HiddenInput子组件。在Ark-UI框架的设计中，HiddenInput负责维护表单控件的实际值状态，并处理与表单提交相关的逻辑。

解决方案

要解决这个问题，开发者需要在RadioGroup.Item组件中添加HiddenInput子组件。具体实现方式如下：

<RadioGroup.Root>
  <RadioGroup.Item value="react">
    <RadioGroup.ItemControl />
    <RadioGroup.ItemText>React</RadioGroup.ItemText>
    <RadioGroup.ItemHiddenInput />
  </RadioGroup.Item>
  {/* 其他选项 */}
</RadioGroup.Root>

技术背景

在表单组件设计中，HiddenInput扮演着重要角色：

1. 维护实际表单值，确保表单提交时能包含正确的值
2. 处理浏览器原生表单行为
3. 提供无障碍访问支持
4. 保持与标准HTML表单元素的兼容性

临时解决方案

在官方修复之前，开发者可以采用以下临时方案：

1. 降级到@ark-ui/react@3.0.0版本
2. 手动添加HiddenInput组件到每个RadioGroup.Item中

最佳实践

为了避免类似问题，建议开发者在实现表单组件时：

1. 仔细检查组件文档中的完整示例
2. 确保包含所有必要的子组件
3. 测试组件在表单提交场景下的行为
4. 验证事件处理函数是否按预期工作

这个问题已在Park-UI的最新版本中得到修复，开发者更新到最新版本后即可正常使用Radio Group组件及其变体。