Bruno 项目中 BrnSelectionEntity defaultValue 的正确使用方式

问题背景

在使用 Bruno 组件库中的 BrnSelectionView 组件时，开发者可能会遇到一个常见问题：当为 BrnSelectionEntity 设置了 defaultValue 属性后，UI 界面的切换显示与实际数据状态不一致。具体表现为用户操作后界面没有正确更新，但实际数据已经发生了变化。

问题分析

这个问题的根源在于开发者对 BrnSelectionEntity 组件的使用方式存在误解。许多开发者会尝试通过直接设置 isSelected 属性来控制选项的选中状态，实际上这是不正确的做法。

正确使用方式

1. 避免手动设置 isSelected

BrnSelectionEntity 组件内部已经处理了选中状态的维护逻辑，isSelected 属性是供组件内部使用的。开发者不应该直接设置这个属性，否则会干扰组件自身的状态管理机制。

2. 使用 defaultValue 属性

正确的做法是通过 defaultValue 属性来指定默认选中的值。这个属性会由组件内部自动处理，确保UI状态与实际数据一致。

BrnSelectionEntity(
  title: "排序方式",
  key: "sortOrder",
  type: "radio",
  defaultValue: _filterParams?['sortOrder'] == 'asc' ? 'asc' : 'desc',
  children: [
    BrnSelectionEntity(
      key: "sortOrder",
      title: "从小到大",
      type: "radio",
      value: "asc"),
    BrnSelectionEntity(
      key: "sortOrder",
      title: "从大到小",
      type: "radio",
      value: "desc"),
  ]),

3. 获取选中状态

如果需要获取当前的选中状态，应该通过 onSelectionChanged 回调来获取，而不是尝试通过直接读取 isSelected 属性。

最佳实践

1. 简化数据结构：构建 BrnSelectionEntity 时只需提供基本属性，如 title、key、type 和 value，避免设置内部状态属性。

2. 统一状态管理：通过 defaultValue 来控制初始选中状态，确保UI与数据的一致性。

3. 响应式更新：利用 onSelectionChanged 回调来响应选项变化，而不是尝试直接控制UI状态。

4. 条件默认值：可以根据外部状态动态设置 defaultValue，如上例中根据 _filterParams 的值来决定默认选中项。

总结

在 Bruno 项目中使用 BrnSelectionEntity 组件时，理解其内部状态管理机制非常重要。开发者应该避免直接操作内部属性如 isSelected，而是通过官方提供的接口如 defaultValue 和回调函数来控制组件行为。这种设计模式遵循了良好的组件封装原则，确保了组件的可靠性和可维护性。

通过遵循这些最佳实践，开发者可以避免UI状态与实际数据不一致的问题，构建出更加稳定可靠的筛选界面。