如何防止MAUI中按钮快速点击时事件重复加载？

方案1：点击后临时禁用按钮 #

这是最直接的处理方式，点击按钮后立即将其设为不可用状态，等页面导航完成或延迟固定时长后恢复，从根源上阻止重复触发。

示例代码：

private async void Button_Clicked(object sender, EventArgs e)
{
    var button = sender as Button;
    if (button == null) return;

    // 立即禁用按钮
    button.IsEnabled = false;

    try
    {
        // 执行页面导航逻辑
        await Navigation.PushAsync(new TargetPage());
    }
    finally
    {
        // 延迟1秒恢复按钮可用（也可在页面导航完成回调中恢复）
        await Task.Delay(1000);
        button.IsEnabled = true;
    }
}

如果使用Shell导航，建议在导航完成后恢复按钮状态，比固定延迟更可靠：

private async void Button_Clicked(object sender, EventArgs e)
{
    var button = sender as Button;
    if (button == null || !button.IsEnabled) return;

    button.IsEnabled = false;

    try
    {
        await Shell.Current.GoToAsync("//TargetPage");
    }
    finally
    {
        button.IsEnabled = true;
    }
}

方案2：实现通用防抖逻辑 #

封装一个防抖工具类，控制指定时间内同一按钮仅触发一次点击事件，适合多按钮复用场景。

先定义防抖工具类：

public static class DebounceHelper
{
    private static readonly Dictionary<string, CancellationTokenSource> _debounceTokens = new();

    public static void Debounce(string key, int delayMs, Action action)
    {
        if (_debounceTokens.TryGetValue(key, out var cts))
        {
            cts.Cancel();
        }

        var newCts = new CancellationTokenSource();
        _debounceTokens[key] = newCts;

        Task.Delay(delayMs, newCts.Token).ContinueWith(task =>
        {
            if (!task.IsCanceled)
            {
                action.Invoke();
            }
            _debounceTokens.Remove(key);
        }, TaskScheduler.FromCurrentSynchronizationContext());
    }
}

按钮点击事件中使用：

private void Button_Clicked(object sender, EventArgs e)
{
    // 用按钮的哈希值作为唯一标识
    var key = (sender as Button)?.GetHashCode().ToString() ?? "default";
    
    DebounceHelper.Debounce(key, 1000, async () =>
    {
        await Navigation.PushAsync(new TargetPage());
    });
}

方案3：通过导航栈状态控制 #

如果目标页面是同一个，可以检查当前导航栈中是否已存在该页面，存在则不再重复打开。

示例代码：

private async void Button_Clicked(object sender, EventArgs e)
{
    // 检查导航栈中是否已有目标页面
    var hasTargetPage = Navigation.NavigationStack.Any(page => page is TargetPage);
    if (hasTargetPage) return;

    await Navigation.PushAsync(new TargetPage());
}

Shell导航场景下，可通过当前路由判断：

private async void Button_Clicked(object sender, EventArgs e)
{
    var currentRoute = Shell.Current.CurrentState.Location.OriginalString;
    if (currentRoute.Contains("//TargetPage")) return;

    await Shell.Current.GoToAsync("//TargetPage");
}

方案4：自定义防抖按钮控件 #

如果项目中有大量按钮需要处理重复点击，可自定义内置防抖逻辑的Button控件，避免重复编写代码。

自定义控件代码：

public class DebounceButton : Button
{
    public static readonly BindableProperty DebounceDelayProperty =
        BindableProperty.Create(nameof(DebounceDelay), typeof(int), typeof(DebounceButton), 1000);

    public int DebounceDelay
    {
        get => (int)GetValue(DebounceDelayProperty);
        set => SetValue(DebounceDelayProperty, value);
    }

    private bool _isDebouncing;

    protected override async void OnClicked()
    {
        if (_isDebouncing) return;

        _isDebouncing = true;
        try
        {
            base.OnClicked();
        }
        finally
        {
            await Task.Delay(DebounceDelay);
            _isDebouncing = false;
        }
    }
}

XAML中直接使用：

<local:DebounceButton Text="打开页面" 
                      DebounceDelay="1000"
                      Clicked="DebounceButton_Clicked"/>

内容的提问来源于stack exchange，提问作者Furkan Hıdır