記一次基於vue的spa多頁簽實踐經驗
前言
最近收到一個這樣的需求,要求做一個基於 vue 和 element-ui 的通用後臺框架頁,具體要求如下:
-
要求通用性高,需要在後期四十多個子項目中使用，所以大部分地方都做成可配置的.
-
要求做成腳手架的形式.可以 npm 安裝
-
要求實現多頁簽,並且可以通過瀏覽器 url 回顯多頁簽.而且頁簽內要維護一個歷史記錄，可以後退
-
組件要求異步加載,減少首屏加載時間.
很明顯,這就是一個 類 ERP 的應用. 做過 JSP 等後臺的同學,對多頁簽應該都很熟悉吧.
那接下來我們就來談談實現.
通用性高
這點其實沒啥難點,無非就是麻煩了點,把所有的數據,都提取出來,放在一個 config
做成腳手架形式
起初產品對這個的需求使做成組件的形式，然後發布 npm 包，方便後期更新的時候，只需更新一下 npm 就可以了，無需每個項目去復制粘貼替換，但是基於這是一個框架頁，而且可配置項非常多，還要實現 tab 多頁簽等多方面的考慮，最終選擇了腳手架的方案，即便這樣後期升級會稍微麻煩一點(起初的方案是框架頁放在一個文件夾裏，到時候直接替換該文件夾)，但相對於組件來說，還是更好維護的，況且後期可以再寫一個更新的腳手架，畢竟現在發布一個 npm 工具的成本實在是太低了。
第一次開發腳手架，看了很多社區的帖子，發現目前大部分腳手架，一般都基於2種形式，一種基於文件復制的形式，另一種基於 git-clone 的形式，經過對比，我覺得文件復制的有點復雜了，我其實只是需要一個能一鍵安裝的工具而已，所以 git-clone 的形式還是比較適合我。
以下就是腳手架的代碼，雖然只是簡單的五六十行代碼，不過查資料＋趟坑，也花了我一個上午的時間。
#!/usr/bin/env nodeconst shell = require(‘shelljs‘);const program = require(‘commander‘);const inquirer = require(‘inquirer‘);const ora = require(‘ora‘);const fs = require(‘fs‘);const path = require(‘path‘);const spinner = ora();const gitClone = require(‘git-clone‘)const chalk = require(‘chalk‘)program .version(‘1.0.0‘, ‘-v, --version‘)
.parse(process.argv);const questions = [{
type: ‘input‘,
name: ‘name‘,
message: ‘請輸入項目名稱‘,
default: ‘my-project‘,
validate: (name)=>{
if(/^[a-z]+/.test(name)){
return true;
}else{
return ‘項目名稱必須以小寫字母開頭‘;
}
}}]inquirer.prompt(questions).then((dir)=>{
downloadTemplate(dir.name);})function downloadTemplate(dir){
// 判斷目錄是否已存在
let isHasDir = fs.existsSync(path.resolve(dir));
if(isHasDir){
spinner.fail(‘當前目錄已存在!‘);
return false;
}
spinner.start(`您選擇的目錄是: ${chalk.red(dir)}, 數據加載中,請稍後...`);
// 克隆 模板文件
gitClone(`https://github.com/noahlam/vue-multi-tab.git`, dir , null, function(err) {
// 移除無用的文件
shell.rm(‘-rf‘, `${dir}/.git`)
spinner.succeed(‘項目初始化成功!‘)
// 運行常用命令
shell.cd(dir)
spinner.start(`正在幫您安裝依賴...`);
shell.exec(‘npm i‘)
spinner.succeed(‘依賴安裝成功!‘)
shell.exec(‘npm run dev‘)
})}
如果你這個腳手架有疑問或者興趣，可以直接訪問 github 上的代碼 tab-cli
實現多頁簽
要想實現多頁簽，那麽 vue-router 基本算是廢了，為什麽？ vue-router 是根據 url 來切換單個組件的，而頁簽則需要再組件內部同時存在多個子組件的，所以路由無法勝任（至少我是這麽認為的，如果你有更好的方案，懇請不吝賜教）。
多個頁簽的顯示，其實不難， element 有現成的 tab 組件，於是老夫寫代碼就是一把梭，擼起袖子就是幹，劈裏啪啦一頓寫，寫完一測，沒有任何問題，實在是不要太簡單，丟給產品預覽：
-
復制瀏覽器地址到別的地方粘貼，tab 不能正確回顯
-
tab 內需要實現跳轉，而且要能返回。
第一個問題比較簡單，自己手寫一個基於 hash 的 偽路由 把當前 tab 的 id 放到 url 上去，然後回顯的時候，根據 url 打開對應的 tab.
tip: 關於如何實現路由，請看我另外一篇博客 自己動手實現一個前端路由
第二個問題，大概就是本文的重點了，這裏詳細說明一下需求，每個 tab 都可以在 tab 內部 跳轉 ,這裏的跳轉，要做的跟 vue-router 的有大體上差不多，要能 push, replace, back,還能帶參數。
那麽怎麽實現呢？ 首先維護一個打開的 tab 列表，然後每個列表裏面再維護一個用過的組件列表(包含參數),這樣大概就能實現了嗎？當然不是，組件的跳轉，參數的傳遞，不可能讓使用者自己去實現這些方法吧，我選擇把封裝一個公共對象，然後掛載在 vue.prototype上。然後類似 vue.$router.xxxx 一樣(我的命名是 vue.$tab)可以在頁面的任何地方使用，如果你對具體的實現方法有興趣，歡迎點擊本文結尾的鏈接，去我的Github倉庫上查看。
組件異步加載
之前只用過基於 vue-router 的異步加載方法，然而這個項目裏面並沒有使用 vue-router,怎麽異步呢？ 翻了一下 vue 的官方文檔是這麽寫的：
Vue.component(
‘async-webpack-example‘,
// 這個 `import` 函數會返回一個 `Promise` 對象。
() => import(‘./my-async-component‘))
然而我試了一下，發現報錯了，import 不能在這裏使用，換了 require 也不行，不知道上我哪裏沒弄好，如果你剛好知道又剛好有空，請告訴我，謝謝！後面在 segmentfault 上 看到 這一篇, 使用 webpack 的 require.ensure 可以實現
// 第一個字符串是 組件名，第二個是 組件路徑，第三個是 chunkName (如果不指定則以1.js,2.js....n.js命名)vue.component(‘home‘, (resolve) => {require.ensure([], ()=>resolve(require(‘@/Views/index.vue‘)), ‘home‘)})
順便還要在 webpack 裏面的 output 下面配置一下 chunkFilename: ‘[name].js‘,, 當然文件名格式可以按你項目的需求來，我這邊就按最簡單的
結束語
首先，當然上獻上該項目的 github地址 咯
其次是本文的的地址 個人技術帖合集
以上項目 歡迎隨意 star 和 follow, 和不隨意的 issue
記一次基於vue的spa多頁簽實踐經驗