Xamarin.Forms中Image的TapGestureRecognizer点击事件不生效问题

Xamarin.Forms 4.8.0.1821 对应已知缺陷说明 #

该版本确实存在3类会导致Image绑定的Tap手势完全不触发的已上报问题：

• Android平台渲染器输入判定bug：未显式标记IsEnabled的Image组件，Tap事件会被系统输入链路直接丢弃，该问题在4.8.0.1821的后续SR补丁版本中完成修复
• 触摸命中区域计算bug：当Image仅设置宽高请求、未设置任何背景属性时，平台会将Image的可视范围判定为无输入响应区域，触摸事件会直接穿透到下层布局
• OnIdiom尺寸计算延迟bug：通过OnIdiom给Image赋值宽高时，首次渲染阶段存在尺寸计算延迟，若组件实际命中区域为0，所有Tap事件都会被系统吞掉

实操解决方法 #

• 给返回Image补全输入响应属性：添加IsEnabled="True"和BackgroundColor="Transparent"，强制系统为Image生成完整的触摸命中区域，避免因无背景被判定为可穿透组件，修改后的XAML代码：

<Image 
  Style="{StaticResource HeaderImageStyle}" 
  Source="ic_back_arrow_xx.png"
  IsEnabled="True"
  BackgroundColor="Transparent">
  <Image.GestureRecognizers>
    <TapGestureRecognizer
        Tapped="SigninPage"
        NumberOfTapsRequired="1">
    </TapGestureRecognizer>
 </Image.GestureRecognizers>
</Image>

• 给HeaderImageStyle补充最小尺寸约束：规避OnIdiom计算延迟导致的命中区域为0问题，在样式中新增最小宽高的Setter：

<Style x:Key="HeaderImageStyle" TargetType="Image">
    <Setter Property="Margin" Value="3" />
    <Setter Property="MinimumWidthRequest" Value="25" />
    <Setter Property="MinimumHeightRequest" Value="25" />
    <Setter Property="WidthRequest">
        <OnIdiom
            x:TypeArguments="x:Double"
            Phone="25"
            Tablet="37"
            Desktop="25"/>
    </Setter>
    <Setter Property="HeightRequest">
        <OnIdiom
            x:TypeArguments="x:Double"
            Phone="25"
            Tablet="37"
            Desktop="25"/>
    </Setter>
</Style>

• 排查上层布局的事件拦截：若返回Image放置在自定义Header布局内，确认上层Grid/StackLayout的InputTransparent属性设置正确，不存在更高ZIndex的透明遮罩拦截触摸事件
• 验证事件触发链路：在SigninPage方法第一行添加调试输出System.Diagnostics.Debug.WriteLine("返回按钮点击已触发")，确认是Tap事件完全没触发，还是事件触发后因为当前页面是普通导航栈（非模态弹出页），调用PopModalAsync()没有实际返回效果，被误判为手势失效。

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