.NET MAUI应用中SearchBar取消按钮的多语言切换实现问题

在我的.NET MAUI应用中，我实现了内部语言切换功能，但不知道如何修改SearchBar的取消按钮文本。我尝试了自定义SearchBarHandler、配置MauiProgram以及自定义Mapper，但始终无法获取到SearchBar的取消按钮，也不确定这些方法是否可行。我的需求是：当应用内部切换语言后，下次显示SearchBar取消按钮时，文本能同步更新。

请问如何解决这个问题？如何获取并修改取消按钮文本？该方案能否同时兼容Android和iOS？

自定义SearchBarHandler（初始版本） #

public class SearchBarHandler : Microsoft.Maui.Handlers.SearchBarHandler
{
    protected override void ConnectHandler(MauiSearchBar platformView)
    {
        base.ConnectHandler(platformView);

        ...
    }
}

MauiProgram.cs 配置 #

...
var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    ...
    .ConfigureMauiHandlers(handlers =>
    {
        //仅在iOS平台启用该Handler
#if IOS
        handlers.AddHandler<SearchBar, SearchBarHandler>();
#endif
    });
...

自定义Mapper尝试 #

Microsoft.Maui.Handlers.SearchBarHandler.Mapper.AppendToMapping("CancelButton", (handler, view) =>
{     
    if (view is Button btn)
    {
        btn.Text = "Hello World";
    }
});

SearchBarHandler实现代码（更新版） #

public class SearchBarHandler : Microsoft.Maui.Handlers.SearchBarHandler
{
    public LanguageResourceManager LanguageResourceManager { get; }

    public SearchBarHandler()
    {
        LanguageResourceManager = LanguageResourceManager.Instance;
        WeakReferenceMessenger.Default.Register<LocalizationChangedMessage>(this, HandleLocalizationChangedMessage);
    }

    private void HandleLocalizationChangedMessage(object recipient, LocalizationChangedMessage message)
    {
        UpdateCancelButtonText(base.PlatformView);
    }

    protected override void ConnectHandler(MauiSearchBar platformView)
    {
        base.ConnectHandler(platformView);

        UpdateCancelButtonText(platformView);
    }

    private void UpdateCancelButtonText(MauiSearchBar platformView)
    {
        var cancelButtonText = Translate("CancelButtonText");
        platformView.SetValueForKey(NSObject.FromObject(cancelButtonText), new NSString("cancelButtonText"));
    }

    private string Translate(string resourceString, object parameter = null)
    {
        if (parameter == null)
        {
            return $"{LanguageResourceManager[resourceString]}";
        }

        return string.Format(LanguageResourceManager[resourceString].ToString(), parameter);
    }
}

MauiProgram.cs 配置代码（更新版） #

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    ...
    .ConfigureMauiHandlers(handlers =>
    {
        //仅在iOS平台启用该Handler
#if IOS
        handlers.AddHandler<SearchBar, SearchBarHandler>();
#endif
    });

iOS 端（优化现有实现） #

你当前的iOS实现思路是可行的，通过platformView.SetValueForKey设置cancelButtonText可以修改取消按钮文本。补充两个优化点：

1. 若SearchBar处于激活状态（已弹出键盘），修改文本后调用platformView.ReloadInputViews()可立即更新UI
2. 确保LocalizationChangedMessage在语言切换时正确发送，保证Handler能收到通知触发更新

Android 端实现 #

Android的SearchBar对应原生SearchView，取消按钮默认是图标，可通过以下两种方式处理：

方式1：修改按钮内容描述（适用于保留图标+显示文本提示）

#if ANDROID
public class AndroidSearchBarHandler : Microsoft.Maui.Handlers.SearchBarHandler
{
    private LanguageResourceManager _languageResourceManager;

    public AndroidSearchBarHandler()
    {
        _languageResourceManager = LanguageResourceManager.Instance;
        WeakReferenceMessenger.Default.Register<LocalizationChangedMessage>(this, HandleLocalizationChangedMessage);
    }

    private void HandleLocalizationChangedMessage(object recipient, LocalizationChangedMessage message)
    {
        UpdateCancelButtonText(PlatformView);
    }

    protected override void ConnectHandler(AndroidX.AppCompat.Widget.SearchView platformView)
    {
        base.ConnectHandler(platformView);
        UpdateCancelButtonText(platformView);
    }

    private void UpdateCancelButtonText(AndroidX.AppCompat.Widget.SearchView platformView)
    {
        var cancelText = _languageResourceManager["CancelButtonText"];
        // 获取关闭按钮
        var closeButton = platformView.FindViewById(AndroidX.AppCompat.R.id.search_close_btn);
        if (closeButton is ImageView imageView)
        {
            // 设置内容描述，点击时会显示文本提示
            imageView.ContentDescription = cancelText;
            // 强制刷新UI
            platformView.Invalidate();
        }
    }
}
#endif

方式2：替换为带文本的按钮（完全显示文本）

如果需要直接显示文本而非图标，可以移除默认图标按钮，添加自定义文本按钮并绑定关闭逻辑：

private void UpdateCancelButtonText(AndroidX.AppCompat.Widget.SearchView platformView)
{
    var cancelText = _languageResourceManager["CancelButtonText"];
    var closeButton = platformView.FindViewById(AndroidX.AppCompat.R.id.search_close_btn);
    if (closeButton != null)
    {
        platformView.RemoveView(closeButton);
    }

    // 创建自定义文本按钮
    var cancelBtn = new TextView(Context)
    {
        Text = cancelText,
        TextColor = Android.Graphics.Color.ParseColor("#007AFF"),
        Padding = new Android.Graphics.Insets(16, 8, 16, 8)
    };
    // 绑定关闭搜索的逻辑
    cancelBtn.Click += (s, e) =>
    {
        platformView.SetQuery(string.Empty, false);
        platformView.ClearFocus();
    };
    platformView.AddView(cancelBtn);
}

注册跨平台Handler #

在MauiProgram中同时注册iOS和Android的Handler：

.ConfigureMauiHandlers(handlers =>
{
#if IOS
    handlers.AddHandler<SearchBar, SearchBarHandler>();
#elif ANDROID
    handlers.AddHandler<SearchBar, AndroidSearchBarHandler>();
#endif
});

语言切换同步要点 #

• 语言切换时必须确保LocalizationChangedMessage正确发送，所有注册的Handler会自动触发文本更新
• 对于已显示的SearchBar，更新文本后需调用平台特定的UI刷新方法（iOS用ReloadInputViews()，Android用Invalidate()）
• 确保LanguageResourceManager能正确加载当前语言的资源文本

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