Xamarin.Forms如何通过依赖注入实现原生平台无障碍功能

你提到的通过依赖注入调用原生平台无障碍能力的方案是可行的，但Xamarin.Forms生态下更推荐使用自定义渲染器实现，这是修改原生控件属性的标准实现，耦合度更低，维护成本更小。两种方案的实现方式如下：

无需额外引入依赖注入逻辑，直接通过Xamarin.Forms内置的渲染器机制扩展无障碍属性：

• 第一步：在共享项目中定义自定义无障碍附加属性，用于在XAML中传递参数

public static class AccessibilityExtensions
{
    // 自定义无障碍提示附加属性
    public static readonly BindableProperty AccessibilityHintProperty = 
        BindableProperty.CreateAttached("AccessibilityHint", typeof(string), typeof(AccessibilityExtensions), string.Empty);

    public static string GetAccessibilityHint(BindableObject view) => (string)view.GetValue(AccessibilityHintProperty);
    public static void SetAccessibilityHint(BindableObject view, string value) => view.SetValue(AccessibilityHintProperty, value);

    // 自定义无障碍描述附加属性
    public static readonly BindableProperty AccessibilityDescriptionProperty = 
        BindableProperty.CreateAttached("AccessibilityDescription", typeof(string), typeof(AccessibilityExtensions), string.Empty);

    public static string GetAccessibilityDescription(BindableObject view) => (string)view.GetValue(AccessibilityDescriptionProperty);
    public static void SetAccessibilityDescription(BindableObject view, string value) => view.SetValue(AccessibilityDescriptionProperty, value);
}

XAML中使用方式：

<Entry 
    local:AccessibilityExtensions.AccessibilityHint="请输入6位数字验证码"
    local:AccessibilityExtensions.AccessibilityDescription="验证码将发送到您绑定的手机号"
/>
<Label 
    local:AccessibilityExtensions.AccessibilityDescription="当前账户余额显示区域"
    Text="余额：100元"
/>

• 第二步：Android平台实现自定义渲染器

[assembly: ExportRenderer(typeof(Entry), typeof(CustomEntryRenderer))]
namespace YourApp.Droid.Renderers
{
    public class CustomEntryRenderer : EntryRenderer
    {
        public CustomEntryRenderer(Context context) : base(context) { }

        protected override void OnElementChanged(ElementChangedEventArgs<Entry> e)
        {
            base.OnElementChanged(e);
            if (Control == null || Element == null) return;
            
            // 配置Android原生无障碍属性
            Control.Hint = AccessibilityExtensions.GetAccessibilityHint(Element);
            Control.ContentDescription = AccessibilityExtensions.GetAccessibilityDescription(Element);
        }
    }
}

Label的Android渲染器逻辑和Entry完全一致，仅需将绑定的控件类型改为Label，修改对应原生控件的ContentDescription属性即可。

• 第三步：iOS平台实现自定义渲染器

[assembly: ExportRenderer(typeof(Entry), typeof(CustomEntryRenderer))]
namespace YourApp.iOS.Renderers
{
    public class CustomEntryRenderer : EntryRenderer
    {
        protected override void OnElementChanged(ElementChangedEventArgs<Entry> e)
        {
            base.OnElementChanged(e);
            if (Control == null || Element == null) return;
            
            // 配置iOS原生无障碍属性
            Control.AccessibilityHint = AccessibilityExtensions.GetAccessibilityHint(Element);
            Control.AccessibilityLabel = AccessibilityExtensions.GetAccessibilityDescription(Element);
        }
    }
}

Label的iOS渲染器同理，修改对应UILabel的AccessibilityLabel、AccessibilityHint属性即可。

如果你的业务场景需要统一通过服务调用的方式配置无障碍属性，可按以下逻辑实现：

• 第一步：共享项目定义无障碍服务接口

public interface IAccessibilityService
{
    void SetControlAccessibilityAttrs(VisualElement formControl, string hint, string description);
}

• 第二步：分别在Android、iOS平台实现该接口，通过控件映射获取原生实例后配置对应无障碍属性，在App启动时将服务注册到依赖注入容器，在业务层直接注入调用即可。

注：该方案需要自行实现Xamarin.Forms控件到原生控件实例的映射逻辑，开发和维护成本更高，非特殊场景不推荐使用。

所有配置完成后，分别开启Android的TalkBack、iOS的VoiceOver功能进行真机测试，确认读屏内容符合预期即可。

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