MAUI怎么用RadioButton实现单选列表项 CollectionView单选

MAUI中RadioButton无法直接用于CollectionView单选,需通过绑定SelectedItem+ViewModel逻辑实现;推荐用SelectedItem绑定配合IsSelected属性模拟单选,避免GroupName复用问题。

在 MAUI 中,RadioButton 本身不支持直接绑定到 CollectionView 的每个项来实现“单选列表”,因为 RadioButton 默认是按 GroupName 分组的控件,而 CollectionView 是动态生成模板的,每个项的 RadioButton 若没统一管理,就无法互斥。但可以通过绑定 + ViewModel 逻辑 + 命令配合,模拟出“单选列表”的效果。

用绑定 + SelectedItem 实现逻辑单选(推荐)

不依赖 RadioButton 的原生分组机制,而是用 CollectionViewSelectedItem 绑定 + 模板中显示选中状态,更简洁、可控、符合 MVVM。

  • ViewModel 中定义 public ObservableCollection Items { get; }public ListItem? SelectedItem { get; set; }
  • CollectionView 设置 SelectedItem="{Binding SelectedItem}",并启用 SelectionMode="Single"
  • 数据模板中用 RadioButtonCheckBox(视觉上设为 IsChecked="{Binding IsSelected, Mode=TwoWay}"),但关键:它的 IsChecked 绑定到一个计算属性(如 IsSelected => this == ViewModel.SelectedItem),点击时触发命令更新 SelectedItem
  • 为避免模板内逻辑复杂,建议在 ListItem 类中加一个 bool IsSelected 属性,并在 SelectedItem 改变时同步刷新所有项的 IsSelected

用 RadioButton + GroupName + Command 手动控制(需注意坑)

如果坚持用原生 RadioButton,必须确保所有项的 GroupName 相同(例如固定写死为 "ListSelection"),并在点击时手动清除其他项状态。

  • CollectionViewDataTemplate 中放 RadioButton,设置 GroupName="ListSelection"(不能绑定,必须静态字符串)
  • 绑定 CommandCheckedChanged 或用 TapGestureRecognizer 触发命令,传入当前项(CommandParameter="{Binding}"
  • 命令中:先清空所有项的选中状态(比如遍历 ItemsIsSelected = false),再设当前项 IsSelected = true,最后更新 SelectedItem
  • ⚠️ 注意:RadioButtonCollectionView 中复用时可能残留状态,务必在 ListItemOnPropertyChanged 中确保 IsSelected 变化能正确刷新 UI

UI 层小技巧:让 RadioButton 看起来像列表项

默认 RadioButton 样式较简陋,可嵌套在 HorizontalStackLayoutGrid 中,搭配 Label 和间距优化体验:

  • VerticalOptions="Center" 对齐文字
  • 设置 Margin 避免贴边,比如 Margin="12,8"
  • 若想点击整行都响应,把 RadioButton 包在 FrameBorder 内,加 GestureRecognizers,再把命令绑定到容器上
  • 选中状态可用 VisualStateManager 定义不同背景色,提升反馈感

绑定示例片段(XAML)

简化版模板参考:


  
    
      
        
        
    
  

基本上就这些。核心是别被 RadioButton 的“原生单选”带偏——在动态列表里,用 ViewModel 管理选中状态才是稳定可靠的做法。