搭建一个多页面的无依赖的工程化项目

5,318 阅读5分钟

最近金拱门比较火,我们先戳开它的官网看看。

看完后,如果你老板要是让你做这么一个网站,一定要seo,一定要兼容IE,你会怎么去做呢?

用vue/react吧,单页应用满足不了seo,而且IE兼容性不好。上node中间层做服务端渲染又把事情搞麻烦了。只能用JQuery干,但是又该怎么做工程化呢?好像也不是很容易。因为目前大家的工程化方案多是一整套单页应用全家桶,如vue-cli的webpack模板。

而前端到如今这个阶段,再让大家接手一个没有工程化的项目,肯定内心非常抵触了。试想这么一个项目,手动link资源,不能写less/sass,不能写ES6,不能依赖管理,不能编译打包...,哦天,想都不敢想。可是工程化这事在实际业务中却没有大家想象中的那么顺利。比如刚刚金拱门的官网,页面很多,要求满足SEO,IE兼容。而且遇到这些项目,往往还会有这些问题:

  1. 由于页面是后端渲染,需要部署后端程序(php,java之类),各种环境配置相当麻烦。
  2. 前端的html代码依托于服务端,导致前端做工程化时,很难对接前后端项目。

也就是说,我们需要做一个非单页应用的工程化项目。这个项目在线上时是前后端耦合的,但是在开发时,我们又不想前后端耦合。再整理一下,我们需要解决的问题有:

  1. 前后端分离,前端开发不能依赖于后端环境。
  2. 前端工程化。诸如静态资源的打包编译、依赖的管理、组件化等等。

明确了要解决的问题后,我们就可以开始了。我们可以用webpack搭建一个项目,帮我们做一些打包、编译、文件处理这些工程化工作。webpack从零配置比较繁琐,我们可以选择修改一个轮子,比如把vue-cli的webpack模板改造一下,删了没必要的vue-loader,给它增加一下多页面入口就好了。

修改轮子

第一步:理解 vuejs-templates/webpack

npm install -g vue-cli

vue init webpack my-project

既然要改人家的模板,先得理解人家都做了什么。这里就不带大家读代码了,根据package.json的命令一个个文件的代码看过去就知道了,很直接很暴力。

第二步:删

既然我们不需要用vue,那么对于vue文件处理的相关逻辑我们就不需要了。根据刚刚对这个模板的了解,我们知道vue-loadervue-style-loader是不需要的。所以删除对应的代码跟package.json里面的包就好了。

多提一点的是,vue-style-loader虽然不需要,style-loader还是需要的,所以需要用后者替换前者。

第三步:加

做减法容易,做加法就没这么轻松了。根据我们刚刚的需求,我们应该给它加个多页面入口。网上有非常多的webpack多入口配置教程。然而他们不一定就能满足我们的需求。他们普遍存在如下问题:

  1. 入口文件需要自己配置。在一个页面较多的项目中,入口文件应当从约定的目录中自动读取,也更符合约定优于配置。
  2. 多入口是针对js的。由于业界普遍是在用单页应用,页面由js生成,故多页面只要多个js入口就好,不需要直接写html。而我的需求不是,我希望的多入口是针对html文件而言的。

不过当我们解决了上述两个问题后,我们还会有一个新的问题。我们不同的html文件,其实又是有公共的部分的。比如都有 header,footer。也就是说,我们需要给这些html文件增加一个模板。我们可以通过webpack的loader来实现,但是没有现成的loader可以比较好的解决。那怎么办呢?可以参考我另外一篇文章。编写自己的Webpack Loader

静态资源的版本控制

上述问题解决后,我们的工作并未完成。现在这个项目的静态资源是以文件哈希值来控制的。可惜有的项目的静态资源是要后端来更新时间戳控制的。虽然这不是个好方案,但有些工程却依旧是这样。没办法,为了适应他们,我们必须得去掉哈希值。可是这样的话,当我们想更新css内引用的图片时又没辙了,因为css内链的图片后端没法控制版本。

这个该怎么解决呢?感谢webpack,我们可以通过如下的配置来实现:

{
  test: /\.(png|jpe?g|gif|svg)(\?.*)?$/,
  oneOf: [
    {
      issuer: /\.html$/,
      loader: 'url-loader',
      options: {
        limit: 10000,
        name: utils.assetsPath('img/[name].[ext]',)
      }
    },
    {
      issuer: /\.(css|less)$/,
      loader: 'url-loader',
      options: {
        limit: 10000,
        name: utils.assetsPath('img/[name].[hash:7].[ext]')
      }
    }
  ]
}

意思就是如果图片是在html中引用的则不加哈希值,在css文件中引入的则加上。

完工

这样我们就完成了一个简单的项目架构。它能帮助我们实现文件的打包、编译,html的模板控制等功能。最终能build出一份html+静态资源的web页面直接发布cdn。当然也可以把它们直接扔给后端。

不过这个架子还不是非常的完善,应用场景也有限,比较适用于一些交互较少、页面较多、看重seo或者传统后端套页面的网站。另外,作为工程化中非常重要的组件化与测试,由于没有任何框架的引入,这点也需要使用者自己再去摸索。

另外,如果还是想用vue,react或angular,又不想搞他们的服务端渲染,可以尝试下变相的服务端渲染系统

最后,如果这个架子对您有用,欢迎戳开github

--阅读原文 --转载请先经过本人授权-丁香园F2E @相学长