Xamarin.Forms如何实现iOS端带UIAccessibilityTrait.Adjustable特性的控件

完全可以实现你需要的效果，通过「共享层自定义控件+iOS端平台渲染器适配」的组合方案即可达成：iOS端支持VoiceOver上下滑动调节数值，Android端保留原有增减按钮的交互逻辑。

1. 共享层自定义控件开发 #

首先在Xamarin.Forms共享项目中创建自定义控件：

• 定义数值绑定属性：Value（当前值）、Minimum（最小值，设为0）、Maximum（最大值，设为10）
• 实现Increment()和Decrement()两个公共方法，用于处理数值增减的逻辑，增加边界判断避免越界
• 控件内容中加入你原有的增减按钮和数值显示Label，通过OnPlatform配置可见性：iOS平台下按钮隐藏，Android平台下按钮正常显示，按钮点击事件直接绑定到上面的两个增减方法即可。

示例共享层C#核心代码：

public class AdjustableNumericControl : ContentView
{
    public static readonly BindableProperty ValueProperty = 
        BindableProperty.Create(nameof(Value), typeof(int), typeof(AdjustableNumericControl), 0);

    public int Value
    {
        get => (int)GetValue(ValueProperty);
        set => SetValue(ValueProperty, value);
    }

    public int Minimum { get; set; } = 0;
    public int Maximum { get; set; } = 10;

    public void Increment()
    {
        if (Value < Maximum) Value++;
    }

    public void Decrement()
    {
        if (Value > Minimum) Value--;
    }

    public AdjustableNumericControl()
    {
        // 布局逻辑省略，加入增减按钮和数值Label，用OnPlatform控制按钮可见性
    }
}

2. iOS端VoiceOver适配 #

在iOS平台项目中添加自定义渲染器，给控件添加可调 accessibility 特性：

• 在OnElementChanged方法中，给原生视图的AccessibilityTraits追加UIAccessibilityTrait.Adjustable枚举值
• 重写AccessibilityIncrement()和AccessibilityDecrement()两个方法，分别调用共享层控件的增减方法，同步更新AccessibilityValue为当前数值的字符串，触发VoiceOver自动播报最新值。

示例iOS渲染器核心代码：

[assembly: ExportRenderer(typeof(AdjustableNumericControl), typeof(AdjustableNumericRenderer))]
namespace YourNamespace.iOS
{
    public class AdjustableNumericRenderer : ViewRenderer<AdjustableNumericControl, UIView>
    {
        protected override void OnElementChanged(ElementChangedEventArgs<AdjustableNumericControl> e)
        {
            base.OnElementChanged(e);
            if (Control == null) SetNativeControl(new UIView());
            if (e.NewElement != null)
            {
                Control.AccessibilityTraits |= UIAccessibilityTrait.Adjustable;
                UpdateAccessibilityValue();
            }
        }

        public override void AccessibilityIncrement()
        {
            Element.Increment();
            UpdateAccessibilityValue();
            base.AccessibilityIncrement();
        }

        public override void AccessibilityDecrement()
        {
            Element.Decrement();
            UpdateAccessibilityValue();
            base.AccessibilityDecrement();
        }

        void UpdateAccessibilityValue()
        {
            Control.AccessibilityValue = Element.Value.ToString();
        }
    }
}

3. Android端兼容处理 #

不需要做额外的平台适配，共享层已经默认在Android端显示增减按钮，原有点击逻辑可以正常运行，系统TalkBack会自动识别按钮的交互属性，不会影响原有使用体验。

额外优化建议 #

• 给自定义控件设置合理的AutomationProperties.Name，比如“数值调节，范围0到10”，方便读屏软件识别控件用途
• 数值变更时可以根据业务需求追加无障碍通知，提醒用户当前边界状态，比如到最大值时播报“已到最大值10”

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