个人的中小型项目前端架构浅谈

JavaScript/前端
355
0
0
2022-07-16

一、为什么要有一个好的架构

首先明确一点,架构是为需求服务的。前端架构存在的目的,就我个人理解来说,有以下几点:

1. 提高代码的可读性

一个好的架构,代码的可读性一定是很强的。

简单来说,假如有一个新人加入团队,那么他接手这个项目,一定是容易上手的,能简单轻松的了解整个前端部分的相互关系,从而找到自己需要重点关注的点。而不是需要花很多时间去熟悉这个项目的很多细节,才能开始上手做东西。

就文件来说,可以从文件名上,分清哪些是页面、哪些是逻辑、哪些是样式、哪些是可以复用的组件、哪些是图标组、又有哪些是移动端或是PC端专享的样式/逻辑等。

就代码来说,包括统一的命名风格,封装在同一个文件里的代码的相关性足够强等。

2. 提高代码的可维护性

一个好的架构,一定是易于维护的,例如在新增需求、更改需求、修正bug,都不会造成意料之外的变化,比如说修改了一个页面组件的内容,却导致另外一个页面组件发生变化(这也太坑了)。因此,要低耦合,高内聚,以及输入和输出是可预期的。

3. 提高代码的可扩展性

一个好的架构,一定扩展性要强,不能写死。

需求变更太TM正常了,新增需求也太TM正常了。因此好的架构,必须要考虑到这些情况的发生,因为这些是一定会发生的。所以,一定要避免把代码写死。

比如页面组件A里需要有一个日历组件,而这个日历组件引用的是别人的(比如从github上找的)。那么尽量不要直接在页面组件A里面直接引用这个日历组件,而是将写一个日历组件B,在这个日历组件B里封装你引用的日历组件C,然后通过这个日历组件B来进行操作。

原因很简单,假如某天产品经理说,这个日历组件太丑了,我们换一个吧。如果你直接在页面组件A里内嵌这个引用的日历组件C,你很可能就要改很多代码(因为不同日历组件的使用方法和暴露的接口可能不同)。假如你还在其他多个地方引用了这个日历组件,那就更糟糕了!每个地方都要改。

而若是将引用的日历组件C封装到自己写的日历组件B之中,那么你只需要改日历组件B里的相应代码即可,而因为日历组件B暴露的接口是不变的,那么自然不用修改页面中的代码了。

附图,以日历组件为例,是否考虑到扩展性的结果

  • 未考虑到扩展性:

个人的中小型项目前端架构浅谈考虑到扩展性:

个人的中小型项目前端架构浅谈4. 便于协同

包括前端和后端的协同,前端和前端之间的协同。

具体来说,前后端的协同通常是以ajax为交互,那么应至少有一个用于专门封装了所有ajax请求的文件,所有ajax请求都封装在这里。在开发时,这里封装的方法应该可以模拟发送和接收约定好的交互内容,方便开发联调。

而前端和前端的协同,主要体现在同时在更改代码时,不会影响对方代码的正常运行。因此要求封装、解耦以及低干扰度是必须的。

5. 自动化

自动打包,压缩,混淆,如果有必要,再加上自动单元测试。

总结:总结来说,一个好的架构的目的是,让前端写代码写的舒服,让后端联调的舒服,让产品经理改需求改的舒服。

二、我如何设计架构

我不敢说自己的架构是好的架构(显然不是啦),只能分享自己最近做的一个项目,它的架构的如何做的。

首先,确定需求:

1、一个中小型网站,同时面向移动端和PC端(单端大概15个页面,算上弹窗大约20个);

2、预算有限(给的钱少),开发时间有限(一个月);

3、可能存在一定程度上的需求变更(比如增加页面或修改某些页面内容);

4、客户可能不太在乎优化(但是我自己在乎啊);

5、要求兼容IE9以上。

其次开始决定:

1、兼容IE9以上说明可以使用主流框架,而无需必须使用jQuery。因此我采用了vue,版本是2.0;

2、预算有限,时间有限,因此PC端和移动端共html和js,独立css;

3、页面有限,因此无需将架构层级划分的比较细,只需要按其类型划分即可;

4、根据原型图来看,页面复杂程度有限,复用部分不是很多,因此可以确定哪些东西需要封装复用,哪些比较复杂需要独立封装,哪些比较简单为了简化开发难度可以直接耦合;

5、自己比较熟练单页面网站,因此采用以单页面为主,异步加载其他页面的形式。

于是使用相关配套的东西,比如webpack,vue-router等,另外为了开发和生产的方便性,采用以下模式进行开发。

个人的中小型项目前端架构浅谈第三,划分功能:

首先有一个根html,用户需要通过访问它来加载我们的js逻辑,因此js逻辑的代码被写在main.js之中。

在main.js之下,我们的前端代码可以被划分为三部分:

  • 组件树
  • 功能模块
  • 各种资源

如下图:

个人的中小型项目前端架构浅谈功能划分好之后,相同功能的放在同一个文件夹下,命名风格应该类似。

具体来说,组件树相关的东西,通常是以.vue结尾,放置在components文件夹下;资源,有图片或者国际化资源等,以.png或者.js或.json结尾,放置在resources文件夹下;而功能插件、服务等,因为可能被多处引用,因此为了方便引用,放在src文件夹下,并且该文件夹是components文件夹和resources文件夹的上级文件夹。

第四,细化功能模块:

功能、组件树以及资源,我们已经明确了有哪些东西,那么接下来,我们要明确这些东西该如何以文件的形式来划分。

如下图:

个人的中小型项目前端架构浅谈1. 项目构建相关
  • 因为要使用vue.js,也要使用es6语法,因此babel是必须的;
  • 又因为要自动化混淆打包,因此webpack也是必须的;
  • 最后因为要方便多人协同,因此npm的package.json的配置,方便不同人可以快速自动化通过npm install来安装依赖,也是必须的。
2. CDN相关

而又因为我们要采用外部字体(需求要求引入非常见字体),因此CDN加速是必须的,该字体文件放在html中来配置引用即可。

3. 配置和插件
  • 我们需要直接引入一些插件和配置文件;
  • 为了使用vue,我们需要一个根组件,那么就是App.vue
  • 使用vue-router,我们需要配置路由文件,因此router-config.js这个路由配置也是必须的;
  • 然后我们还需要以插件形式引入一些功能和服务,因此有了Plugin-开头的若干个vue插件,这些都是根据需要封装好的低耦合高内聚方法;
4. 需要的npm依赖

当然,要使用vue肯定要引入vue.js,类似的还有vue-router.js和各种兼容性polyfill和全局插件。

5. 抽离出的功能模块
  • 除了直接引用的这些插件,我们还有一些和项目高度耦合的功能服务,我认为不能作为插件,但依然需要抽离出来封装好,方便使用和修改;
  • 如封装ajax请求的ajax.js,所有的ajax请求都放置其中,只对外暴露接口,方便管理和使用;
  • 又如实时国际化功能的组件LanguageManager.js,他需要引入国际化资源和管理国际化资源的加载;
  • 又例如实现跨组件通信的event-bus.js;
  • 又比如管理用户信息的user.js。
总结:而这些划分,都体现在上图之中。这就是src目录下的功能模块文件,我们需要的绝大多数功能都可以包括在其中,我们只需要按照实际开发中的需要,将对应的功能写入在这些文件中并引用即可。

第五,组件树:

之前谈了功能模块的划分,接下来是组件树。

因为是中小型页面,因此组件树的层级无需太深,但该抽离出来的依然还是要抽离,尽量保证抽离出来的组件解耦以及一个页面组件的逻辑不要太多。如下图:

个人的中小型项目前端架构浅谈0. 根组件

所有组件最终往上找,都会找到共同的根组件App.vue,根组件只负责管理他的直接子组件。

每个组件都只负责管理自己的直接子组件,不跨级管理,并且不依赖于自己的子组件(否则可能因为子组件的未加载或错误而导致父组件错误),做到解耦和内聚。

1. 弹窗dialog和弹窗tips

因为弹窗dialog和弹窗提示tips可能同时存在,因此将其划分为2个组件,方便管理。

2. 未登录页面和登录页面

因为页面存在登录和未登录状态,而为了加载速度考虑,当未登录时,不加载已登录页面,因此需要划分出来,并进行异步加载处理。

3. 未登录页面

未登录页面又分为三种情况:

  • 初始页面:毫无疑问要直接加载
  • 登录弹窗:点击登录时加载(异步)
  • 注册弹窗:点击注册时加载(异步)

之所以分拆开,是因为根据需求,已登录用户刷新页面,可以直接进入登录后页面,因此无需登录和注册,这种处理可以减少流量消耗,提升加载页面加载速度(特别是注册弹窗需要加载的内容还比较多)。

4. 已登录页面

已登录页面有较多页面,采用默认加载初始页,然后异步加载其他页面(访问时)。

5. 弹窗dialog

由于逻辑较少,代码量不多,因此为了方便管理,统一将其合并在一个vue文件中,共同相同的打开逻辑,根据传递的key决定打开哪一个。这样在新增弹窗时,无需再去写弹窗的打开、关闭逻辑。

假如有较复杂的弹窗,可以以子组件的形式引入到当前vue文件中,如此也方便管理;

6. 国际化管理

和页面高耦合,负责加载对应的国际化资源,并进行切换管理。

7. 页面组件

可能有子页面和复用的组件,按照正常方式引用即可。

8. 样式文件

可以独立写为.css文件,但因为我的公共样式文件比较少,因此我还是将其放在一个.vue文件中,并在App.vue里来引用。

9. 页面组件起名
  • 通常以.vue为结尾,除了国际化LanguageManager.js因为高耦合度,因此以.js结尾并是一个单独的vue实例,表示他更像是一个功能模块,而不是一个vue的页面组件;
  • 基础页面,如登录和未登录页面,公共组件(并且是header和footer这种),以base-开头;
  • 弹窗统一以box-为开头;
  • 可复用的组件以extend-开头;
  • 引入的外部组件以import-开头;
  • 普通页面组件以page-开头(这些页面往往是一个独立的页面,并且挂靠在登录或未登录页面下);
  • 注册弹窗因为逻辑比较复杂,并且同类较多,因此以register-为开头。

通过以文件名来划分,不同的页面组件之间的区分可以说是一目了然,同时也方便管理。

本文来自CSDN博客:
http://blog.csdn.net/qq20004604/article/details/70480932