.NET 9 Maui 如何在颜色属性变化后更新 CollectionView?
结论
可以继续使用 List<CryptoItem>。让 CryptoItem 实现 INotifyPropertyChanged,在颜色设置变化后,由每个需要更新的 CryptoItem 实例发出 ListTextColor 的属性变更通知。
通知必须来自 DataTemplate 当前绑定的条目对象。在页面或页面 ViewModel 上调用 OnPropertyChanged(nameof(ListTextColor)),不会通知绑定到 CryptoItem.ListTextColor 的 Label。
为什么滚动后才显示新颜色
ItemsSource="{Binding Items}" 和 TextColor="{Binding ListTextColor}" 的绑定源不同:前者读取页面绑定上下文中的 Items,后者读取当前条目的 ListTextColor。
OnPropertyChanged("Items") 通知的是列表属性变化,不会通知列表中各个对象的颜色属性变化。即使换成 ObservableCollection<CryptoItem>,条目自身的属性仍需发送通知。ObservableCollection 主要报告集合成员的增删、替换等变化。
滚动离开再回来时,条目视图可能重新绑定并读取颜色。这与缺少属性通知的现象相符。由于原问题没有提供 CryptoItem 的实现,还需要确认 ListTextColor 是计算属性,还是保存颜色值的属性。
如果 ListTextColor 根据偏好设置计算
假设现有的 ListTextColor getter 每次都根据条目状态和当前颜色设置返回结果,可以在现有 CryptoItem 类中加入通知机制。下面省略了已有的 Name 和 ListTextColor 实现,合并代码时需要保留它们:
using System.ComponentModel;
using System.Runtime.CompilerServices;
public class CryptoItem : INotifyPropertyChanged
{
// 保留现有的 Name 和 ListTextColor 属性实现。
public event PropertyChangedEventHandler? PropertyChanged;
protected void OnPropertyChanged(
[CallerMemberName] string? propertyName = null)
{
PropertyChanged?.Invoke(
this,
new PropertyChangedEventArgs(propertyName));
}
public void RefreshListTextColor()
{
OnPropertyChanged(nameof(ListTextColor));
}
}
如果 CryptoItem 已继承提供 INotifyPropertyChanged 和 OnPropertyChanged 的基类,只需添加 RefreshListTextColor(),不要重复声明事件。
保存颜色设置后,通知列表中的相关实例。对于从 Options 页面返回列表页的流程,可以在列表页面的 OnAppearing() 中处理:
protected override void OnAppearing()
{
base.OnAppearing();
if (ItemsList.ItemsSource is IEnumerable<CryptoItem> items)
{
foreach (var item in items)
{
item.RefreshListTextColor();
}
}
}
这段代码使用现有的 ItemsList,遍历它实际绑定的对象。运行时颜色设置应已保存,ListTextColor 的 getter 也要能读取更新后的设置。如果 getter 使用了缓存,需要先更新缓存,再发出通知。
原有 XAML 可以保持不变:
<Label
Text="{Binding Name}"
LineBreakMode="NoWrap"
FontSize="Medium"
FontAttributes="Bold"
HorizontalTextAlignment="Start"
TextColor="{Binding ListTextColor}" />
如果 ListTextColor 保存的是颜色值
如果 ListTextColor 使用字段保存颜色,仅发送通知会让绑定重新读取原来的值。需要先根据最新设置计算颜色,再给属性赋值。
在已经实现上述通知机制的 CryptoItem 类中,可以使用这样的属性:
private Color _listTextColor = Colors.Black;
public Color ListTextColor
{
get => _listTextColor;
set
{
if (Equals(_listTextColor, value))
return;
_listTextColor = value;
OnPropertyChanged();
}
}
此处需要 Microsoft.Maui.Graphics 命名空间。Colors.Black 只是示例初始值,应按应用的默认配色调整。
保存偏好设置后,对受影响的条目重新计算颜色,并执行 item.ListTextColor = 新颜色。setter 会发送通知。原问题没有提供状态字段和设置读取代码,因此这部分应沿用应用已有的颜色判断逻辑。
实现时需要确认的细节
- 发出通知的对象必须是
ItemsSource中的同一实例。修改另一个新建的CryptoItem不会更新当前条目。 - 如果颜色设置在返回页面前已保存,可以在
OnAppearing()中遍历并通知条目,便于接入现有流程。列表较大时,可以只通知颜色受影响的条目。 - 如果通过设置变更事件立即更新颜色,应管理好事件订阅与取消订阅,避免重复处理。
- 如果更新入口来自后台线程,可以用
MainThread.BeginInvokeOnMainThread将颜色赋值和通知操作安排到 UI 线程。
备注:内容仅供参考。
