118 lines
6.0 KiB
C#
118 lines
6.0 KiB
C#
using Cysharp.Threading.Tasks;
|
||
using UnityEngine;
|
||
using UnityEngine.UI;
|
||
using PhxhSDK;
|
||
|
||
/*
|
||
╔═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════╗
|
||
║ UIWindow 默认Back按钮处理模块 (Default Back Button) ║
|
||
╠═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════╣
|
||
║ ║
|
||
║ 【功能说明】 ║
|
||
║ 处理UIWindow的默认"返回"按钮的自动绑定和点击逻辑。 ║
|
||
║ 通过约定节点名（BtnBack、BackButton、BtnReturn），框架自动识别并绑定按钮。 ║
|
||
║ ║
|
||
║ 【使用方式】 ║
|
||
║ 1. 默认使用：在预制体中创建约定名称的按钮，无需代码 ║
|
||
║ 2. 自定义节点名：重写 DefaultBackButtonNames 虚属性 ║
|
||
║ 3. 自定义行为：重写 OnBack() 虚方法（在 UIWindow.Lifecycle.cs 中定义） ║
|
||
║ ║
|
||
║ 【默认行为】 ║
|
||
║ 点击返回按钮 → 调用 Back() → 触发 OnBack() → 使用 BackStrategy ║
|
||
║ 与Android返回键/ESC键行为完全一致 ║
|
||
║ ║
|
||
╚═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════╝
|
||
*/
|
||
|
||
/// <summary>
|
||
/// UI窗口基类 - 默认Back按钮处理部分
|
||
/// 负责自动识别和绑定预制体中的"返回"按钮
|
||
/// </summary>
|
||
public abstract partial class UIWindow
|
||
{
|
||
#region Default Back Button - 默认返回按钮自动绑定
|
||
|
||
/// <summary>
|
||
/// 默认返回按钮的节点名配置（子类可重写）
|
||
/// 默认支持：BtnBack、BackButton、BtnReturn
|
||
/// </summary>
|
||
protected virtual string[] DefaultBackButtonNames => new[] { "BtnBack", "BackButton", "BtnReturn" };
|
||
|
||
/// <summary>
|
||
/// 绑定所有配置的默认返回按钮
|
||
/// 在 DoInit() 阶段自动调用
|
||
/// 返回按钮会调用 Back() 方法，触发 OnBack() 虚方法
|
||
/// </summary>
|
||
private void BindDefaultBackButtons()
|
||
{
|
||
foreach (var buttonName in DefaultBackButtonNames)
|
||
{
|
||
TryBindBackButton(buttonName);
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// 尝试绑定返回按钮（节点不存在时静默跳过）
|
||
/// 绑定后，点击按钮会调用 Back() 方法，触发 OnBack() 虚方法
|
||
/// </summary>
|
||
private void TryBindBackButton(string nodeName)
|
||
{
|
||
var trans = transform.Find(nodeName);
|
||
if (trans)
|
||
{
|
||
var btn = trans.GetComponent<Button>();
|
||
if (btn)
|
||
{
|
||
// 绑定到 Back() 方法，会触发 OnBack() 虚方法
|
||
BindButton(btn, () => Back().Forget());
|
||
DebugUtil.Log("✅ 已自动绑定返回按钮: {0} -> {1} -> Back()", WindowName, nodeName);
|
||
}
|
||
}
|
||
}
|
||
|
||
#endregion
|
||
|
||
#region Back Logic - 返回逻辑处理
|
||
|
||
/// <summary>
|
||
/// 处理返回键（公共接口，不可重写）
|
||
/// 框架会按照从上到下的顺序调用所有可见窗口的Back()方法，
|
||
/// 直到某个窗口处理并返回true为止
|
||
/// </summary>
|
||
/// <returns>是否成功处理返回键（true表示已处理，false表示未处理，继续向下传递）</returns>
|
||
public async UniTask<bool> Back()
|
||
{
|
||
try
|
||
{
|
||
return await OnBack();
|
||
}
|
||
catch (System.Exception e)
|
||
{
|
||
DebugUtil.LogError("window : {0} back error: {1}\n===Stack===\n{2}\n======", WindowName, e.Message, e.StackTrace);
|
||
return false;
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// 返回键处理（虚方法，子类可重写）
|
||
/// 默认通过返回策略模式处理
|
||
/// </summary>
|
||
/// <returns>是否成功处理返回键（true表示已处理，false表示未处理，继续向下传递）</returns>
|
||
protected virtual async Cysharp.Threading.Tasks.UniTask<bool> OnBack()
|
||
{
|
||
if (!GraphicRaycasterManager.IsEnableGraphicRaycaster)
|
||
return true;
|
||
|
||
// 使用策略模式处理返回键
|
||
if (BackStrategy != null)
|
||
{
|
||
return await BackStrategy.HandleBack(this);
|
||
}
|
||
|
||
return false;
|
||
}
|
||
|
||
#endregion
|
||
}
|
||
|