Elux项目中的Component与View设计指南

2025-06-24 07:41:10作者：翟江哲Frasier

引言

在现代前端开发中，组件化设计已经成为构建复杂应用的基础。Elux项目作为一款优秀的前端框架，对组件(Component)和视图(View)有着清晰而实用的设计理念。本文将深入探讨Elux中Component与View的区别、创建方式以及最佳实践。

Component基础概念

在Elux中，Component(组件)是最基础的UI构建块，与主流前端框架中的组件概念基本一致：

纯UI展示：Component主要负责UI渲染，不包含业务逻辑
可复用性：设计良好的Component可以在不同场景下复用
无状态或有状态：可以根据需要设计为无状态函数组件或有状态类组件

创建Elux Component与创建普通React/Vue组件没有区别，完全遵循对应框架的组件开发规范。

View的进阶理解

View是Elux中一个重要的概念升级，可以理解为：

业务组件：View是包含具体业务逻辑的Component
状态感知：View可以直接访问和响应Store中的状态变化
模块化：View通常与特定业务模块相关联

View的创建方式

在React中创建View

import {connectStore} from '@elux/react-web';
import {APPState} from '@/Global';

interface StoreProps {
    currentView?: CurrentView;
    itemDetail?: ItemDetail;
}

function mapStateToProps(appState: APPState): StoreProps {
    const {currentView, itemDetail} = appState.article!;
    return {currentView, itemDetail};
}

const ArticleView: FC<StoreProps> = ({currentView, itemDetail}) => {
    // 业务逻辑和UI渲染
    return (
        <div>
            {/* 视图内容 */}
        </div>
    );
}

export default connectStore(mapStateToProps)(ArticleView);

在Vue中创建View

import {connectStore} from '@elux/vue-web';
import {APPState} from '@/Global';

interface StoreProps {
    currentView?: CurrentView;
    itemDetail?: ItemDetail;
}

function mapStateToProps(appState: APPState): StoreProps {
    const {currentView, itemDetail} = appState.article!;
    return {currentView, itemDetail};
}

const ArticleView = defineComponent({
    name: 'ArticleView',
    setup() {
        const storeProps = connectStore(mapStateToProps);
        
        return () => (
            <div>
                {/* 使用storeProps中的数据渲染 */}
            </div>
        );
    },
});

export default exportView(ArticleView);

组件导出机制

Elux提供了灵活的组件导出方式，满足不同场景需求：

常规导出

在模块的index.ts文件中，使用exportModule统一导出：

import {exportModule} from '@elux/react-web';
import {Model} from './model';
import main from './views/Main';

export default exportModule('article', Model, {main});

异步组件导出

对于大型组件，推荐使用异步导出优化性能：

export default exportModule('article', Model, {
    main: () => import('./views/Main')
});

组件使用实践

普通Component的使用

普通Component的使用没有任何特殊要求，像常规React/Vue组件一样导入和使用即可。

View的特殊使用流程

由于View可能依赖ModuleState，使用前需要确保相关Model已初始化。Elux提供了LoadComponent方法封装了这一复杂流程：

import {LoadComponent} from '@/Global';

const Article = LoadComponent('article', 'main');
const UserProfile = LoadComponent('user', 'profile');

LoadComponent的完整签名如下：

type LoadComponent = (
    moduleName: string,
    componentName: string,
    options?: {
        onError: Component<{message: string}>;
        onLoading: Component<{}>;
    }
) => EluxComponent

仅获取组件引用

如果只需要获取组件引用而不立即渲染，可以使用GetComponent：

import {GetComponent} from '@/Global';

const getArticleComponent = async () => {
    const Article = await GetComponent('article', 'main');
    // 可以延迟渲染或在特定条件下渲染
};

Elux内置组件详解

Elux提供了多个实用内置组件，极大提高了开发效率：

1. Switch组件

条件渲染组件，只渲染第一个非空子元素：

<Switch elseView={<NotFound />}>
    {mode === 'edit' && <EditForm />}
    {mode === 'view' && <ViewMode />}
</Switch>

2. Else组件

渲染所有非空子元素：

<Else elseView={<EmptyData />}>
    {showHeader && <PageHeader />}
    <MainContent />
    {showFooter && <PageFooter />}
</Else>

3. Link组件

增强的路由链接组件，支持多种路由操作：

<Link 
    to="/user/profile"
    action="push"
    target="window"
    disabled={isCurrentPage}
    className="nav-link"
>
    个人资料
</Link>

支持的属性包括：

to: 目标路由
action: 路由动作(push/replace/relaunch/back)
target: 目标历史栈
disabled: 是否禁用
其他HTML属性

4. DocumentHead组件

动态管理文档头部信息，特别适合SSR场景：

<DocumentHead
    title="商品详情页"
    html='
        <meta name="keywords" content="电商,购物,在线商店">
        <meta name="description" content="商品详细信息页面">
    '
/>