.NET MAUI中CollectionView赋值SelectedItem时iOS不显示选中颜色

以下是针对你遇到的问题的具体排查步骤，按优先级尝试：

1. 验证VisualState配置的准确性 #

• 确认SelectionMode设置：确保CollectionView的SelectionMode为Single（默认是Single，但需避免被意外修改）：

  <CollectionView SelectionMode="Single" SelectedItem="{Binding SelectedSavedStore}">
  

• 检查VisualState的作用目标：确保VisualStateGroup附加在ItemTemplate的根布局元素上（如Grid、ContentView），而非内部控件（如Label），iOS对状态触发的目标范围更严格：

  <CollectionView.ItemTemplate>
      <DataTemplate>
          <Grid>
              <VisualStateManager.VisualStateGroups>
                  <VisualStateGroup x:Name="CommonStates">
                      <VisualState x:Name="Normal"/>
                      <VisualState x:Name="Selected">
                          <VisualState.Setters>
                              <Setter Property="BackgroundColor" Value="#E0E0E0"/>
                          </VisualState.Setters>
                      </VisualState>
                  </VisualStateGroup>
              </VisualStateManager.VisualStateGroups>
              <!-- 子控件内容 -->
          </Grid>
      </DataTemplate>
  </CollectionView.ItemTemplate>
  

• 排查样式覆盖：检查iOS项目Resources/Styles/Styles.xaml中是否有全局样式覆盖了CollectionView项的选中状态，可临时注释全局样式测试。

2. 确认ViewModel属性通知与绑定同步 #

• 验证ObservableProperty的正确性：确保SelectedSavedStore使用CommunityToolkit的ObservableProperty标记，自动触发属性变更通知：

  using CommunityToolkit.Mvvm.ComponentModel;
  
  namespace YourNamespace.ViewModels;
  
  public partial class CustomPopupViewModel : ObservableObject
  {
      [ObservableProperty]
      private SavedStoreModel _selectedSavedStore;
  
      // ... 其他逻辑
      public void SelectSavedStoreByName(string name)
      {
          var foundSavedStore = // 你的查找逻辑
          SelectedSavedStore = foundSavedStore;
      }
  }
  

• 监听SelectedItem变更：在CustomPopupContentPage.xaml.cs中添加监听，确认iOS端是否接收到选中项变更：

  using Microsoft.Maui.Controls;
  
  namespace YourNamespace.Pages.Views.Controls.CustomPicker;
  
  public partial class CustomPopupContentPage : ContentPage
  {
      public CustomPopupContentPage(CustomPopupViewModel viewModel)
      {
          InitializeComponent();
          BindingContext = viewModel;
  
          // 添加监听
          MyCollectionView.SelectedItemChanged += (s, e) =>
          {
              System.Diagnostics.Debug.WriteLine($"iOS端SelectedItem更新: {e.SelectedItem}");
          };
      }
  }
  

  如果日志未输出，说明绑定同步存在问题，需检查弹窗显示时机与属性设置的先后顺序。

3. 适配iOS端CollectionView的特殊行为 #

• 延迟设置选中项：iOS弹窗渲染速度慢于Android，尝试在弹窗完全显示后再设置选中项。可在CustomPopupContentPage的OnAppearing方法中触发选择逻辑：

  protected override void OnAppearing()
  {
      base.OnAppearing();
      // 假设需要选中的名称已传入ViewModel
      (BindingContext as CustomPopupViewModel)?.SelectSavedStoreByName(TargetStoreName);
  }
  

• 强制滚动到选中项：设置SelectedSavedStore后，手动调用CollectionView的滚动方法，触发iOS端的状态更新：

  public void SelectSavedStoreByName(string name)
  {
      var foundSavedStore = // 你的查找逻辑
      SelectedSavedStore = foundSavedStore;
  
      // 需通过弱引用或页面传参获取CollectionView实例
      MainThread.BeginInvokeOnMainThread(() =>
      {
          MyCollectionView?.ScrollToItem(foundSavedStore, ScrollToPosition.Center, false);
      });
  }
  

• 确保Item模板元素可交互：检查ItemTemplate根布局的IsEnabled属性是否为true，iOS对禁用元素的状态触发会失效。

4. 排查CustomPopup的兼容性 #

• 测试基础弹窗场景：暂时替换CustomPopup为普通ContentPage测试选中状态是否生效，若普通页面正常，说明问题与CustomPopup在iOS上的生命周期或渲染逻辑相关。
• 尝试版本降级/升级：如果是CommunityToolkit.Maui版本问题，可尝试降级到稳定版本（如5.1.0）或升级到最新预览版测试。

内容的提问来源于stack exchange，提问作者OXO