Method createComponent

packages/fairygui/src/ecs/FGUIComponent.ts:295–331

* Create component from loaded package * 从已加载的包创建组件 * * Note: Disposes existing component before creating new one to avoid visual overlap * 注意：创建新组件前会先销毁已有组件，避免视觉叠加

(componentName?: string)

     * 注意：创建新组件前会先销毁已有组件，避免视觉叠加
     */
    public createComponent(componentName?: string): GObject | null {
        const name = componentName || this.componentName;
        if (!this._package) {
            return null;
        }
        if (!name) {
            return null;
        }

        // Dispose existing component before creating new one
        // 创建新组件前先销毁已有组件
        if (this._component) {
            if (this._root) {
                this._root.removeChild(this._component);
            }
            this._component.dispose();
            this._component = null;
        }

        try {
            this._component = this._package.createObject(name);

            if (this._component && this._root) {
                this.syncProperties();
                this._root.addChild(this._component);
            }

            this._version++;
            this._onStateChange?.('updated');
            return this._component;
        } catch (e) {
            // Log full error with stack trace for debugging
            console.error(`[FGUIComponent] Error creating component "${name}":`, e);
            this._error = e instanceof Error ? e.message : String(e);
            return null;
        }
    }

    /**
     * Get child by name from the component