using System;
using System.Collections.Concurrent;
using System.Collections.Generic;
using System.ComponentModel;
using System.Globalization;
using Avalonia.Data;
using Avalonia.Data.Converters;
using Avalonia.Markup.Xaml;
using Avalonia.Threading;
namespace NewLife.XCoder.Services;
/// <summary>可绑定的译文条目:语言切换时通知界面刷新</summary>
public sealed class LocalizationItem : INotifyPropertyChanged
{
internal LocalizationItem(String key) => Key = key;
/// <summary>词表键(英文原文)</summary>
public String Key { get; }
/// <summary>当前语言译文</summary>
public String Value => LocalizationService.T(Key);
/// <summary>属性变化通知</summary>
public event PropertyChangedEventHandler? PropertyChanged;
internal void RaiseChanged() => PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(nameof(Value)));
}
/// <summary>译文条目缓存:XAML 标记扩展与语言切换通知之间的桥</summary>
public static class LocalizationSource
{
private static readonly ConcurrentDictionary<String, LocalizationItem> _items = new(StringComparer.Ordinal);
/// <summary>取指定键的译文条目</summary>
/// <param name="key">词表键(英文原文)</param>
/// <returns>可绑定的译文条目</returns>
public static LocalizationItem Get(String key) => _items.GetOrAdd(key, k => new LocalizationItem(k));
private static void RaiseChanged()
{
// 控件可能创建在无头/测试会话的专用 UI 线程上,优先使用 Application 的调度器
var dispatcher = Avalonia.Application.Current?.Dispatcher;
if (dispatcher != null)
{
if (!dispatcher.CheckAccess())
{
dispatcher.Post(RaiseChanged);
return;
}
}
else if (!Dispatcher.UIThread.CheckAccess())
{
Dispatcher.UIThread.Post(RaiseChanged);
return;
}
foreach (var item in _items.Values)
{
item.RaiseChanged();
}
}
private static Boolean _subscribed;
/// <summary>确保订阅语言切换通知</summary>
public static void EnsureSubscribed()
{
if (_subscribed) return;
_subscribed = true;
LocalizationService.Changed += _ => RaiseChanged();
}
}
/// <summary>本地化文本转换器:把状态/日志等动态中文文本转换为当前语言</summary>
/// <remarks>只做显示层转换,不修改 ViewModel 中的原始数据;未命中词表时保持原文。</remarks>
public sealed class LocalizedTextConverter : IValueConverter
{
/// <summary>共享实例,供 XAML 通过 <c>{x:Static}</c> 引用</summary>
public static readonly LocalizedTextConverter Instance = new();
/// <summary>转换文本</summary>
/// <param name="value">原始文本</param>
/// <param name="targetType">目标类型</param>
/// <param name="parameter">转换参数</param>
/// <param name="culture">格式化文化</param>
/// <returns>当前语言文本</returns>
public Object? Convert(Object? value, Type targetType, Object? parameter, CultureInfo culture)
=> value is String text ? LocalizationService.Translate(text) : value;
/// <summary>反向转换保持原值,兼容可编辑控件的双向绑定</summary>
/// <param name="value">目标值</param>
/// <param name="targetType">目标类型</param>
/// <param name="parameter">转换参数</param>
/// <param name="culture">格式化文化</param>
/// <returns>原值</returns>
public Object? ConvertBack(Object? value, Type targetType, Object? parameter, CultureInfo culture) => value;
}
/// <summary>本地化格式转换器:把计数套入当前语言格式串</summary>
/// <remarks>格式键通过 <c>ConverterParameter</c> 传入,每次计数变化时按当前语言重新格式化。</remarks>
public sealed class LocalizedFormatConverter : IValueConverter
{
/// <summary>共享实例,供 XAML 通过 <c>{x:Static}</c> 引用</summary>
public static readonly LocalizedFormatConverter Instance = new();
/// <summary>组合计数与格式串</summary>
/// <param name="value">计数值</param>
/// <param name="targetType">目标类型</param>
/// <param name="parameter">格式键,如 <c>{0} services</c></param>
/// <param name="culture">格式化文化</param>
/// <returns>格式化后的文本;缺少格式串时返回计数字符串</returns>
public Object? Convert(Object? value, Type targetType, Object? parameter, CultureInfo culture)
{
var format = parameter as String;
if (format.IsNullOrEmpty()) return value?.ToString() ?? "";
try
{
return String.Format(culture, LocalizationService.T(format), value);
}
catch (FormatException)
{
return format;
}
}
/// <summary>反向转换保持原值</summary>
/// <param name="value">目标值</param>
/// <param name="targetType">目标类型</param>
/// <param name="parameter">转换参数</param>
/// <param name="culture">格式化文化</param>
/// <returns>原值</returns>
public Object? ConvertBack(Object? value, Type targetType, Object? parameter, CultureInfo culture) => value;
}
/// <summary>XAML 译文标记扩展:<c>Text="{loc:Tr Workbench}"</c></summary>
/// <remarks>
/// 返回绑定到 <see cref="LocalizationItem.Value"/> 的反射绑定,
/// 语言切换时由 <see cref="LocalizationSource"/> 统一发出通知,已打开的界面即时刷新。
/// 键含逗号或空格时使用引号:<c>{loc:Tr 'Search tools, features or keywords…'}</c>。
/// </remarks>
public sealed class TrExtension : MarkupExtension
{
/// <summary>词表键(英文原文)</summary>
public String Key { get; set; } = "";
/// <summary>实例化</summary>
public TrExtension() { }
/// <summary>按词表键实例化</summary>
/// <param name="key">词表键(英文原文)</param>
public TrExtension(String key) => Key = key;
/// <summary>提供绑定值</summary>
/// <param name="serviceProvider">XAML 服务提供者</param>
/// <returns>指向译文条目的绑定</returns>
// 运行时绑定依赖反射;桌面版 JIT 发布可用,开启 NativeAOT 时会出现 IL3050 提示
public override Object ProvideValue(IServiceProvider serviceProvider) => new ReflectionBinding(nameof(LocalizationItem.Value))
{
Source = LocalizationSource.Get(Key),
Mode = BindingMode.OneWay,
};
}
|