Xamarin.Forms iOS平台下如何自定义TabbedPage的VoiceOver播报文本

Xamarin.Forms 对 iOS 平台 TabbedPage 的底层渲染逻辑中，AutomationProperties.Name 属性是绑定到页面对象本身的，而 iOS 原生的 UITabBarItem 是独立于页面的单独控件，Xamarin.Forms 默认不会将页面配置的自动化属性同步到对应的 Tab 项上。系统自动生成的 VoiceOver 播报文本是直接读取 Tab 的 Title 属性，再拼接系统默认前缀、序号生成，因此你在页面上设置的 AutomationProperties.Name 不会生效。

方案1：自定义TabbedPage渲染器（最稳定，无副作用） #

在iOS平台项目中实现自定义渲染器，手动将子页面的自动化属性同步到原生UITabBarItem上，代码如下：

using UIKit;
using Xamarin.Forms;
using Xamarin.Forms.Platform.iOS;
// 替换为你iOS项目的实际命名空间
namespace YourAppNamespace.iOS
{
    // 此处MainPage替换为你自己的TabbedPage类名
    [assembly: ExportRenderer(typeof(YourAppNamespace.MainPage), typeof(CustomTabbedRenderer))]
    public class CustomTabbedRenderer : TabbedRenderer
    {
        protected override void ViewWillAppear(bool animated)
        {
            base.ViewWillAppear(animated);
            if (TabBar?.Items == null || Element?.Children == null) 
                return;

            for (int i = 0; i < Element.Children.Count && i < TabBar.Items.Length; i++)
            {
                var automationName = AutomationProperties.GetName(Element.Children[i]);
                if (!string.IsNullOrWhiteSpace(automationName))
                {
                    TabBar.Items[i].AccessibilityLabel = automationName;
                }
            }
        }
    }
}

配置完成后不需要修改原有XAML代码，你之前写的AutomationProperties.Name就可以正常生效，VoiceOver会直接播报你设置的内容，不会再拼接系统默认的前缀和序号。

方案2：轻量兼容方案（无需写渲染器） #

如果不想引入自定义渲染器，可以通过平台差异化配置实现：将iOS平台下页面的Title直接设置为你要播报的内容，其他平台保留原有Title，同时保持AutomationProperties.Name的配置，示例XAML如下：

<NavigationPage IconImageSource="icon_1.png" AutomationProperties.Name="Test 1" >
    <NavigationPage.Title>
        <OnPlatform x:TypeArguments="x:String">
            <On Platform="iOS" Value="Test 1" />
            <On Platform="Android" Value="Page 1" />
        </OnPlatform>
    </NavigationPage.Title>
    <x:Arguments>
        <mypages:PageArchive />
    </x:Arguments>
</NavigationPage>

注意：该方案会导致iOS平台下NavigationPage顶部的标题栏也显示为你设置的播报文本，如果需要顶部标题和VoiceOver播报内容不一致，请勿使用该方案

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