使用Nuxt.js改造已有項目

前言

如果我們需要對現有的vue項目進行ssr改造,使用nuxt.js是一個不錯的選擇。這裏用作例子的“現有項目”是一個“高仿”餓了麼外賣APP的spa。不過我沒有把全部功能開發出來(全部做出來就不得了了),只是做出幾個基本界面意思意思
這裏寫圖片描述
下面就以這個demo爲小白鼠進行ssr改造

準備

現有目錄

這裏寫圖片描述
很明顯,這是使用vue-cli搭建的項目
其中prod.server.js是build之後的啓動文件
dataa.json文件是模擬數據,在build/dev-server.js中會用到它

安裝與配置

安裝nuxt

npm install --save-dev nuxt

新建nuxt文件夾
我們需要在根目錄下建立一個nuxt文件夾,該文件夾的內部組織按照nuxt本身的應用目錄架構進行組織(參考
這裏寫圖片描述
注意,在static目錄下有一個logo.png,它將作爲項目圖標,在nuxt.config.js中這張圖片的地址直接寫成/logo.png。下一節會對nuxt文件夾的組織進行詳細說明。

新建並設置nuxt.config.js
當然,我們也需要在根目錄下創建nuxt.config.js文件用於組織Nuxt.js 應用的個性化配置,在這個項目中,需要進行設置的點有:

  1. 源碼目錄路徑
  2. head中的meta以及link(主要是圖標)
  3. 全局的css樣式
  4. 項目中需要使用圖片和字體文件,雖然nuxt默認對其進行配置,但我們需要重新定義部分內容(項目中是擴大limit)
  5. 項目中使用了sass,需要對其進行配置

所以,nuxt.config.js的代碼如下

module.exports = {
    // 設置nuxt源碼目錄路徑
    srcDir: "nuxt/",
    head: {
        title: "sell-nuxt",
        meta: [
            {
                charset: "utf-8"
            },
            {
                name: "viewport",
                content: "width=device-width, initial-scale=1,user-scalable=no,maximum-scale=1.0,minimum-scale=1.0"
            }
        ],
        link: [
            {
                rel: "shortcut icon",
                type: "image/png",
                // 注意圖片的路徑直接指向static下的logo.png
                href: "/logo.png"
            }
        ]
    },
    css: [
        "~assets/reset.css"
    ],
    build: {
        vendor: ['axios'],
        loaders: [
            {
                test: /\.(png|jpe?g|gif|svg)(\?.*)?$/,
                loader: 'url-loader',
                options: {
                  limit: 10000,
                  name: 'img/[name].[hash:7].[ext]'
                }
            },
            {
                test: /\.(woff2?|eot|ttf|otf)(\?.*)?$/,
                loader: 'url-loader',
                options: {
                  limit: 10000,
                  name: 'fonts/[name].[hash:7].[ext]'
                }
            },
            {
                test: /\.scss$/,
                loader: "vue-style-loader!css-loader!sass-loader"
            }
        ]
    }
}

配置package.json
package.json是npm的配置文件,現在,我們需要對script選項進行配置

"scripts": {
   "dev": "nuxt",
   "build": "nuxt build",
   "start": "nuxt start",
   "generate": "nuxt generate",
   "lint": "eslint --ext .js,.vue --ignore-path .gitignore .",
   "precommit": "npm run lint"
 }

可以參考nuxt的命令列表

改造後的目錄

這裏寫圖片描述
其中有個nuxt.api.js,這個文件是爲完成ssr改造後的項目提供api接口的,使用koa,運行在3001端口

nuxt文件夾組織

因爲我們已經把項目代碼開發出來了,所以nuxt文件夾裏面的大部分代碼可以直接從已有代碼中拷貝

layouts

佈局目錄 layouts 用於組織應用的佈局組件,nuxt可通過添加 layouts/default.vue 文件來擴展應用的默認佈局,在layouts下新建default.vue

<template>
  <div id="app">
    <v-header v-bind:seller="seller"></v-header>
    <v-tab></v-tab>
    <nuxt/>
  </div>
</template>

<script>
  import axios from 'axios';
  // 引入組件
  import header from "~/components/header/header.vue";
  import tab from "~/components/tab/tab.vue";
  export default {
    data:function(){
      return {
        seller:{}
      }
    },
    created:function(){
      axios.get("http://localhost:3001/seller").then(res=>{
        console.log(res.data);
        this.seller = res.data.data;
      });
    },
    components:{
      "v-header":header,
      "v-tab":tab
    }
  }
</script>

<style lang="scss" rel="text/css">

</style>

<nuxt/> 組件用於顯示頁面的主體內容,即“商品”、“評論”、“商家”這幾個部分

pages

nuxt依據 pages 目錄結構自動生成 vue-router 模塊的路由配置,這無疑是非常方便的
這裏寫圖片描述
不難看出goods、patings、seller分別對應“商品”、“評論”、“商家”
這樣子設置,則nuxt自動生成的路由配置如下

router: {
  routes: [
    {
      name: 'index',
      path: '/',
      component: 'pages/index.vue'
    },
    {
      name: 'goods',
      path: '/goods',
      component: 'pages/goods/index.vue'
    },
    {
      name: 'patings',
      path: '/patings',
      component: 'pages/patings/index.vue'
    },
    {
      name: 'seller',
      path: '/seller',
      component: 'pages/seller/index.vue'
    }
  ]
}

但我們希望默認進入goods,nuxt官方文檔並沒有說如何設置默認路徑,這就是爲什麼要在pages下面創建一個index.vue

<template>

</template>

<script>
  export default {
    created:function(){
      this.$router.push('/goods'); // 頁面加載時跳轉
    }
  }
</script>

<style lang="scss" rel="text/css">

</style>

對於那些不需要像在pages下的頁面組件那樣有 asyncData 方法的特性的組件,我們可以將他們放到components目錄下

assets

資源目錄 assets 用於組織未編譯的靜態資源如 LESS、SASS 或 JavaScript,這個目錄是我感覺在引用路徑時最坑的一個。
在官方文檔中,每個目錄都有別名,這些別名在nuxt.config.js中配置時是有效的,比如之前配置的css選項,但不代表我們在組件中使用這些別名會有效,在組件中我們最好使用相對路徑,比如在components/header/header.vue中就不能直接寫~assets,而得老老實實寫相對路徑

<style lang="scss" rel="text/css" src="../../assets/base.scss"></style>
<style type="text/css" src="../../assets/style.css"></style>
<style lang="scss" rel="text/css">
    @import "../../assets/mixin.scss";
    @import "./header.scss";
</style>

參考資料

美團點評點餐 Nuxt.js 實戰
使用Nuxt.js改善現有項目
nuxt官方文檔
nuxt/koa使用sass出錯

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章