实现自定义DoubleTap/双击行为时UI可点击项不显示，求修复方案

我正在尝试在应用中实现双击（DoubleTap）行为，但使用当前方法后，本该可点击的项无法在UI中正常响应，请求帮忙排查修复。目前只试过这一种实现方式，不清楚问题根源，相关代码如下：

XML代码 #

<CollectionView.ItemTemplate>
    <DataTemplate>
        <!-- Wrap content in a Border with the gesture recognizer -->
        <Border Margin="10,5,10,5" Stroke="Transparent"
                InputTransparent="False">
            <StackLayout>
                <StackLayout.Behaviors>
                    <behaviors:DoubleTapBehavior 
            Command="{Binding Source={RelativeSource AncestorType={x:Type viewModels:ContactsViewModel}}, 
                     Path=EditContactCommand}"/>
                </StackLayout.Behaviors>


                <!-- Your contact content -->
                <HorizontalStackLayout Margin="10,0,0,2">
                    <Label Text="Name: " FontSize="16" FontAttributes="Bold" /> 
                    <Label Text="{Binding Name}" FontSize="16" FontAttributes="Bold" Margin="3,0,0,2"/>
                </HorizontalStackLayout>
                <HorizontalStackLayout Margin="10,0,0,2">
                    <Label Text="Phone: " FontSize="16" FontAttributes="Bold" />
                    <Label Text="{Binding Phone}" FontSize="14" Margin="3,2.5,0,2" />
                </HorizontalStackLayout>
                <HorizontalStackLayout Margin="10,0,0,2">
                    <Label Text="Address: " FontSize="16" FontAttributes="Bold" />
                    <Label Text="{Binding Address}" FontSize="14" Margin="3,2.5,0,2"/>
                </HorizontalStackLayout>
            </StackLayout>
        </Border>
    </DataTemplate>
</CollectionView.ItemTemplate>

ViewModel相关代码 #

[RelayCommand]
private async Task EditContact(object tappedItem)
{
    if (tappedItem is null) return;

    // Debounce to prevent accidental double-taps
    await Task.Delay(300); 

    // Navigate based on type
    switch (tappedItem)
    {
        case Employee employee:
            await Shell.Current.Navigation.PushAsync(new EditEmployeePage(employee));
            break;
        case Client client:
            await Shell.Current.Navigation.PushAsync(new EditClientPage(client));
            break;
    }
}

DoubleTapBehavior C#类代码 #

public class DoubleTapBehavior : Behavior<View>
{
    public static readonly BindableProperty CommandProperty =
        BindableProperty.Create(
            nameof(Command), 
            typeof(ICommand), 
            typeof(DoubleTapBehavior));

    public ICommand Command
    {
        get => (ICommand)GetValue(CommandProperty);
        set => SetValue(CommandProperty, value);
    }

    protected override void OnAttachedTo(View bindable)
    {
        base.OnAttachedTo(bindable);
        AttachGesture(bindable);
    }

    private void AttachGesture(View view)
    {
        var tapGesture = new TapGestureRecognizer 
        { 
            NumberOfTapsRequired = 2,
            Buttons = ButtonsMask.Primary // Support mouse left-click
        };
        tapGesture.Tapped += OnDoubleTapped;
        view.GestureRecognizers.Add(tapGesture);
    }

    private void OnDoubleTapped(object sender, EventArgs e)
    {
        if (Command?.CanExecute(null) == true && sender is View view)
        {
            Command.Execute(view.BindingContext); // Pass the tapped item
        }
    }

    protected override void OnDetachingFrom(View bindable)
    {
        base.OnDetachingFrom(bindable);
        if (bindable.GestureRecognizers.FirstOrDefault(x => x is TapGestureRecognizer tgr && tgr.NumberOfTapsRequired == 2) 
            is TapGestureRecognizer tapGesture)
        {
            tapGesture.Tapped -= OnDoubleTapped;
        }
    }
}

排查修复步骤 #

1. 调整Behavior的附加位置 #

将DoubleTapBehavior从内部StackLayout移到外层Border上，确保整个列表项区域都能响应双击，避免内部布局的手势遮挡问题：

<Border Margin="10,5,10,5" Stroke="Transparent" InputTransparent="False">
    <Border.Behaviors>
        <behaviors:DoubleTapBehavior 
            Command="{Binding Source={RelativeSource AncestorType={x:Type viewModels:ContactsViewModel}}, 
                     Path=EditContactCommand}"/>
    </Border.Behaviors>
    <StackLayout>
        <!-- 联系人内容保持不变 -->
    </StackLayout>
</Border>

2. 修正Command的CanExecute判断逻辑 #

在OnDoubleTapped方法中，将CanExecute(null)改为CanExecute(view.BindingContext)，确保参数一致，避免因CanExecute逻辑依赖参数导致命令无法触发：

private void OnDoubleTapped(object sender, EventArgs e)
{
    if (sender is View view)
    {
        var item = view.BindingContext;
        if (Command?.CanExecute(item) == true)
        {
            Command.Execute(item);
        }
    }
}

3. 移除不必要的防抖延迟 #

ViewModel中的Task.Delay(300)会导致双击响应延迟，甚至影响UI体验，直接移除即可——双击手势本身已经通过NumberOfTapsRequired=2区分单双击，无需额外防抖：

[RelayCommand]
private async Task EditContact(object tappedItem)
{
    if (tappedItem is null) return;

    // Navigate based on type
    switch (tappedItem)
    {
        case Employee employee:
            await Shell.Current.Navigation.PushAsync(new EditEmployeePage(employee));
            break;
        case Client client:
            await Shell.Current.Navigation.PushAsync(new EditClientPage(client));
            break;
    }
}

4. 完善GestureRecognizer的清理逻辑 #

在OnDetachingFrom方法中，不仅要移除事件绑定，还要将手势从视图的GestureRecognizers集合中移除，避免内存泄漏：

protected override void OnDetachingFrom(View bindable)
{
    base.OnDetachingFrom(bindable);
    var tapGestures = bindable.GestureRecognizers.OfType<TapGestureRecognizer>()
        .Where(tgr => tgr.NumberOfTapsRequired == 2).ToList();
    foreach (var tapGesture in tapGestures)
    {
        tapGesture.Tapped -= OnDoubleTapped;
        bindable.GestureRecognizers.Remove(tapGesture);
    }
}

5. 验证XAML命名空间 #

确保XAML头部已经正确声明viewModels和behaviors的命名空间，例如：

xmlns:viewModels="clr-namespace:YourAppName.ViewModels"
xmlns:behaviors="clr-namespace:YourAppName.Behaviors"

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