vue开发多页面应用 - hash模式和history模式

我们知道vue可以快速开发web单页应用,而且官方为我们提供了自己的应用脚手架vue-cli,我们只需要下载脚手架,安装依赖后就可以启动vue应用雏形。这得益与webpack的依赖追踪,各种资源后缀的loader,以及相关webpack插件的强大功能。
然而有些时候,我们有多页面的开发需求,在这种情况下,我们可以为多页面构建相应的多个应用,比如通过vue-cli生成多个应用目录,但是这样一方面会多出很多重复的构建代码和样板代码,另外也会破坏应用的统一性,不便于维护。我们可以在vue-cli的基础上通过修改webpack配置来让脚手架具备构建多页应用的能力。
webpack在打包编译vue文件时,最重要的是入口和输出的配置、所以我们会主要修改这两个部分的配置。
我的个人博客就是一个vue多页应用,包含客户端和后台管理两个部分,下面就以它为例子来说明如何实现vue多页应用,整个过程是基于vue-cli2的。

入口配置

入口配置比较简单,打开webpack.base.conf.js,只需要修改entry配置就可以了,修改如下:

entry: {
    client:  ["babel-polyfill", "./src/Client/main.js"],
    manager: ["babel-polyfill", "./src/Manager/main.js"],
},

增加babel-polyfill主要是兼容低版本浏览器,因为Babel默认只转换新的JavaScript句法(syntax),而不转换新的API,比如IteratorGeneratorSetMapsProxyReflectSymbolPromise等全局对象,以及一些定义在全局对象上的方法(比如Object.assign)都不会转码。

输出配置

输出配置要分别配置开发环境以及生产环境的输出,我们先来配置开发环境。打开webpack.dev.conf.js,在plugin配置项中添加以下配置,并删除原来的HtmlWebpackPlugin配置。

new HtmlWebpackPlugin({
      filename: 'client.html',
      template: './tpl/index.html',
      inject: true,
      chunks: ['client'],
}),
new HtmlWebpackPlugin({
      filename: 'manager.html',
      template: './tpl/index.html',
      inject: true,
      chunks: ['manager'],
}),

可以看到,这里使用HtmlWebpackPlugin插件配置了两份html输出,fliename是编译输出的文件名,templatehtml模版,不同页面可以使用相同的模版也可以使用不同的模版。
实际上,开发环境下我们访问的页面资源是被webpack管理在内存中的,webpack-dev-server作为本地服务根据url返回内存资源给浏览器从而呈现页面。但是多页面情况下如何去根据url返回对应的页面呢,答案就是配置devServer下的historyApiFallback,该配置项会传递给connect-history-api-fallback这个中间件,对request请求的url进行重定向,避免开发环境下页面404,配置如下:

historyApiFallback: {
     rewrites: [
        { from: 'index', to: path.posix.join(config.dev.assetsPublicPath, 'index.html') },
        { from: /\/admin/, to: path.posix.join(config.dev.assetsPublicPath, 'admin.html') },
      ],
 },

到这里开发环境的配置就完成了,npm start启动项目后,使用localhost:8080可以看到客户端页面,使用localhost:8080/admin可以看到后台管理页面。
接下来对生产环境进行配置,首先打开config/index.js
build配置项中增加目标html的输出路径及名称。

    index: path.resolve(__dirname, '../server/public/index.html'),
    admin: path.resolve(__dirname, '../server/public/admin.html'),

接下来打开build/webpack.prod.conf.js,在pulgin中添加以下配置:

new HtmlWebpackPlugin({
      filename: config.build.index,
      template: './tpl/index.html',
      inject: true,
      minify: {
        removeComments: true,
        collapseWhitespace: true,
        removeAttributeQuotes: true
      },
      chunksSortMode: 'dependency',
      chunks: ['manifest', 'vendor', 'client']
}),
new HtmlWebpackPlugin({
      filename: config.build.admin,
      template: './tpl/index.html',
      inject: true,
      minify: {
        removeComments: true,
        collapseWhitespace: true,
        removeAttributeQuotes: true
      },
        chunksSortMode: 'dependency',
        chunks: ['manifest', 'vendor', 'manager']
}),

这个地方要特别注意的是一定要配置chunks,否则所有打包后的文件将同时引入admin.htmlindex.html
这样,整个vue多页面配置就完成了。我们可以看到,如果项目中每增加一个一级页面,就需要多处修改webpack配置,很繁琐。为此,更好的方式是基于vue-cli2进行一层封装,这是我写的一个扩展示例multiPage-vue-cli

history模式

有的时候出于强迫症,不能忍受hash模式下的url上存在#符号,或者是出于业务需求,url不能带#号。这个时候要考虑采用vue-routerhistory模式,history模式的前端配置与上文大同小异,但是由于history模式下url路径的跳转是vue-router利用h5history API动态添加的,而手动刷新页面会导致找不到路由从而产生404错误,因此还需要对服务端进行配置,将路由重定向到一级页面。比如可以对nginx作如下配置:

server {
       listen 80;
       location ^~ /api {
          proxy_pass http://127.0.0.1:3000;
       }
       location /admin {
          root  /home/silentport.github.io/nginx/blog/;
          index admin.html;
          try_files $uri $uri/ /admin.html;
       }
       location / {
          root /home/silentport.github.io/nginx/blog;
          index index.html;
          try_files $uri $uri/ /index.html;
       } 
}

其中,
第一个配置是将所有的以/api开头的请求转发到node服务器处理;
第二个配置是将所有/admin开头的请求重定向到admin.html;
第三个配置是将所有的不是以apiadmin开头的请求重定向到index.htmlroot的配置还可以响应页面的静态文件;
这样一来客户端访问就没什么问题了,刷新页面也不会404,一切正常,但是管理端访问依然存在问题,问题是出在当在admin.html中做路由切换,并手动刷新的时候,url中的admin消失,这样一来nginx会将它重定向到客户端的页面。针对这个问题,还需要在admin的页面中对vue-router增加一个base配置项,让路由跳转的时候url始终携带这个base,配置如下:

export default new Router({
  mode: 'history',
  base: '/admin',
  routes: [

  ]
})

经过上述所有的配置以后,history模式就可以正常使用了。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 211,423评论 6 491
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,147评论 2 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,019评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,443评论 1 283
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,535评论 6 385
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,798评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,941评论 3 407
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,704评论 0 266
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,152评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,494评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,629评论 1 340
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,295评论 4 329
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,901评论 3 313
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,742评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,978评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,333评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,499评论 2 348