mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-03-22 10:34:30 +08:00
8fd7e2e952
- 定义了IPageBehavior接口，提供UI页面的生命周期方法如OnEnter、OnExit、OnPause、OnResume等 - 创建了IUiFactory接口用于创建UI页面实例，以及IUiPage接口定义页面基本操作 - 添加了IUiPageEnterParam接口用于定义页面跳转参数数据结构 - 实现了IUiRouter接口提供页面栈管理功能，支持Push、Pop、Replace、Clear等操作 - 创建了UI切换处理器相关接口和实现，包括IUiTransitionHandler和UiTransitionPipeline - 添加了UI切换事件系统，支持BeforeChange和AfterChange两个执行阶段 - 实现了日志记录处理器LoggingTransitionHandler用于记录UI切换信息 - 定义了多种UI切换策略枚举如UiTransitionPolicy、UiTransitionType等 - 提供了UI注册表接口用于管理UI实例的注册和获取功能
64 lines
2.2 KiB
C#
64 lines
2.2 KiB
C#
using GFramework.Core.Abstractions.system;
|
||
using GFramework.Game.Abstractions.enums;
|
||
|
||
namespace GFramework.Game.Abstractions.ui;
|
||
|
||
/// <summary>
|
||
/// UI路由管理器接口，用于管理UI界面的导航和切换操作
|
||
/// </summary>
|
||
public interface IUiRouter : ISystem
|
||
{
|
||
/// <summary>
|
||
/// 绑定UI根节点
|
||
/// </summary>
|
||
/// <param name="root">UI根节点接口实例</param>
|
||
void BindRoot(IUiRoot root);
|
||
|
||
/// <summary>
|
||
/// 将指定的UI界面压入路由栈，显示新的UI界面
|
||
/// </summary>
|
||
/// <param name="uiKey">UI界面的唯一标识符</param>
|
||
/// <param name="param">进入界面的参数，可为空</param>
|
||
/// <param name="policy">界面切换策略，默认为Exclusive（独占）</param>
|
||
void Push(string uiKey, IUiPageEnterParam? param = null, UiTransitionPolicy policy = UiTransitionPolicy.Exclusive);
|
||
|
||
|
||
/// <summary>
|
||
/// 弹出路由栈顶的UI界面，返回到上一个界面
|
||
/// </summary>
|
||
/// <param name="policy">界面弹出策略，默认为Destroy（销毁）</param>
|
||
void Pop(UiPopPolicy policy = UiPopPolicy.Destroy);
|
||
|
||
/// <summary>
|
||
/// 替换当前UI界面为指定的新界面
|
||
/// </summary>
|
||
/// <param name="uiKey">新UI界面的唯一标识符</param>
|
||
/// <param name="param">进入界面的参数，可为空</param>
|
||
/// <param name="popPolicy">界面弹出策略，默认为销毁当前界面</param>
|
||
/// <param name="pushPolicy">界面过渡策略，默认为独占模式</param>
|
||
void Replace(
|
||
string uiKey,
|
||
IUiPageEnterParam? param = null,
|
||
UiPopPolicy popPolicy = UiPopPolicy.Destroy,
|
||
UiTransitionPolicy pushPolicy = UiTransitionPolicy.Exclusive
|
||
);
|
||
|
||
|
||
/// <summary>
|
||
/// 清空所有UI界面，重置路由状态
|
||
/// </summary>
|
||
void Clear();
|
||
|
||
/// <summary>
|
||
/// 注册UI切换处理器
|
||
/// </summary>
|
||
/// <param name="handler">处理器实例</param>
|
||
/// <param name="options">执行选项</param>
|
||
void RegisterHandler(IUiTransitionHandler handler, UiTransitionHandlerOptions? options = null);
|
||
|
||
/// <summary>
|
||
/// 注销UI切换处理器
|
||
/// </summary>
|
||
/// <param name="handler">处理器实例</param>
|
||
void UnregisterHandler(IUiTransitionHandler handler);
|
||
} |