125 lines
2.7 KiB
TypeScript
125 lines
2.7 KiB
TypeScript
import { Node } from 'cc';
|
|
|
|
/**
|
|
* UI基类
|
|
* 职责:
|
|
* - 定义UI的基础接口和生命周期
|
|
* - 管理UI根节点
|
|
* - 提供显示/隐藏控制
|
|
*
|
|
* 所有UI必须继承此类并实现onGetUrl方法
|
|
*/
|
|
export abstract class UIBase {
|
|
/** UI根节点 */
|
|
protected _node: Node | null = null;
|
|
|
|
/** UI是否已加载 */
|
|
protected _isLoaded: boolean = false;
|
|
|
|
/** UI是否显示中 */
|
|
protected _isShowing: boolean = false;
|
|
|
|
/**
|
|
* 获取UI资源路径 (必须重载)
|
|
* @returns UI预制体路径
|
|
* @example
|
|
* onGetUrl(): string {
|
|
* return 'UI/Login/UILogin';
|
|
* }
|
|
*/
|
|
abstract onGetUrl(): string;
|
|
|
|
/**
|
|
* UI开始时调用 (可选重载)
|
|
* 在UI预制体加载完成后调用
|
|
* 可以在此方法中初始化UI数据、绑定事件等
|
|
* @param params 传入的参数
|
|
* @example
|
|
* onStart(params?: any): void {
|
|
* console.log('UI初始化', params);
|
|
* // 绑定按钮事件
|
|
* this.bindEvents();
|
|
* }
|
|
*/
|
|
onStart?(params?: any): void | Promise<void>;
|
|
|
|
/**
|
|
* UI结束时调用 (可选重载)
|
|
* 在UI被卸载前调用
|
|
* 可以在此方法中清理资源、解绑事件等
|
|
* @example
|
|
* onEnd(): void {
|
|
* console.log('UI清理');
|
|
* // 解绑按钮事件
|
|
* this.unbindEvents();
|
|
* }
|
|
*/
|
|
onEnd?(): void;
|
|
|
|
/**
|
|
* UI更新 (可选重载)
|
|
* 在每帧调用(仅当UI显示时)
|
|
* @param dt 距离上一帧的时间(秒)
|
|
* @example
|
|
* onUpdate(dt: number): void {
|
|
* // 更新倒计时
|
|
* this.updateTimer(dt);
|
|
* }
|
|
*/
|
|
onUpdate?(dt: number): void;
|
|
|
|
/**
|
|
* 设置UI根节点
|
|
* 由UIMgr在加载完成后调用
|
|
* @param node UI根节点
|
|
*/
|
|
setNode(node: Node): void {
|
|
this._node = node;
|
|
this._isLoaded = true;
|
|
}
|
|
|
|
/**
|
|
* 获取UI根节点
|
|
* @returns UI根节点,如果未加载则返回null
|
|
*/
|
|
getNode(): Node | null {
|
|
return this._node;
|
|
}
|
|
|
|
/**
|
|
* 显示UI
|
|
*/
|
|
show(): void {
|
|
if (this._node) {
|
|
this._node.active = true;
|
|
this._isShowing = true;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 隐藏UI
|
|
*/
|
|
hide(): void {
|
|
if (this._node) {
|
|
this._node.active = false;
|
|
this._isShowing = false;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 检查UI是否显示中
|
|
* @returns true表示正在显示,false表示已隐藏
|
|
*/
|
|
isShowing(): boolean {
|
|
return this._isShowing;
|
|
}
|
|
|
|
/**
|
|
* 检查UI是否已加载
|
|
* @returns true表示已加载,false表示未加载
|
|
*/
|
|
isLoaded(): boolean {
|
|
return this._isLoaded;
|
|
}
|
|
}
|