MAUI手势操作通过声明式手势识别器实现，核心是识别意图而非处理底层触摸。常用类型包括Tap、LongPress、Swipe、Pan、Pinch五种，支持XAML绑定命令和代码动态添加，需注意手势冲突与交互启用设置。
MAUI 手势操作不是靠监听原始触摸事件，而是通过内置的 手势识别器（Gesture Recognizers） 声明式添加到控件上，再绑定命令或事件来响应。核心思路是：**识别意图，而非处理底层指针**。它天然支持 MVVM，也兼容代码后台写法，跨平台行为一致。
常用手势识别器有哪些
所有识别器都通过 GestureRecognizers 集合添加到任意 View（如 Label、Image、Frame 等）。主要类型包括：
-
TapGestureRecognizer：单击、双击（设
NumberOfTapsRequired="2"），最常用 -
LongPressGestureRecognizer：长按（可设
DurationMilliseconds，默认 500ms） -
SwipeGestureRecognizer：左右/上下快速滑动，支持
Direction属性 -
PanGestureRecognizer：持续拖拽，提供实时位移（
TotalX/TotalY）和状态（Running/Completed） -
PinchGestureRecognizer：双指缩放，返回缩放比例变化（
Scale）和中心点
怎么用 XAML 绑定点击命令（MVVM 推荐）
以点击一张图片跳转详情页为例，ViewModel 中定义命令，XAML 中绑定：
<Image Source="user.png">
<Image.GestureRecognizers>
<TapGestureRecognizer
Command="{Binding NavigateToProfileCommand}"
CommandParameter="{Binding UserId}" />
</Image.GestureRecognizers>
</Image>
ViewModel 中只需暴露一个 ICommand：
public ICommand NavigateToProfileCommand { get; } = new Command<string>(async (userId) =>
{
await Shell.Current.GoToAsync($"profile/{userId}");
});
这样完全解耦，测试方便，也避免内存泄漏风险。
怎么在代码里动态加手势（比如运行时控制）
适合需要条件启用/禁用、或逻辑较复杂的情况。例如给一个 BoxView 添加拖拽功能：
var pan = new PanGestureRecognizer();
pan.PanUpdated += (s, e) =>
{
if (e.StatusType == GestureStatus.Running)
{
boxView.TranslationX += e.TotalX;
boxView.TranslationY += e.TotalY;
}
else if (e.StatusType == GestureStatus.Completed)
{
// 拖完自动归位或吸附
boxView.TranslateTo(0, 0, 150);
}
};
boxView.GestureRecognizers.Add(pan);
注意：不用时可调用 boxView.GestureRecognizers.Clear() 移除，防止重复注册。
手势冲突怎么处理
同一控件加了多个手势（比如 Tap + Pan），系统默认按添加顺序竞争，但可能误判。关键控制点有两个：
-
CanBePrevented="False"：允许其他手势“抢走”事件（例如设为 false 后，Pan 不会阻止 Tap） -
CanContinueToReceiveTouches="True"：让当前手势持续接收后续触摸（适合需要多阶段响应的场景）
典型做法是：对主交互控件（如地图、画布），优先加 Pan 或 Pinch，再把 Tap 放后面，并设 CanBePrevented="True"，确保滑动时不意外触发点击。
基本上就这些。不复杂但容易忽略的是：手势识别器本身不自动启用交互（比如 Image 默认 InputTransparent="False" 是 OK 的，但 Label 如果父容器拦截了触摸，就得检查层级和透明设置）。
