專案介紹
lion-ui 是一個基於 RBAC 的管理系統前端專案,採用 vue 和 element-ui 前端技術棧,實現了登入許可權驗證,根據許可權動態生成選單等功能。使用 vue-cli4.x 初始化專案。
開發時採用 fastmock 來進行模擬請求資料。
暫時前端專案只有master分支,資料都是mock的,有基本輪廓,可clone下來快速開發。根據需求調整。後端系統將搭配 netcore3.1 敬請期待
個人域名文件教程
文件教程
部落格園文件
文件教程
技術基礎
該系列文章涉及到以下幾個知識點,請先熟悉相關文件
- vue.js 2.x 中文, 優秀的 JS 框架
- vue-router, vue.js 配套的路由
- vuex,vue.js 應用狀態管理庫
- Element UI,餓了麼提供的 UI 框架
開發環境
安裝工具
目前版本基於
webpack 4.0+
和vue-cli 4.x
版本構建,需要 Node.js 8.9 或更高版本(該專案使用的是 12.18.1),相關知識可以自行進官網進行了解. 若有多個 node 版本,可以使用 nvm來進行管理
安裝打包工具 webpack
,-g 表示全域性安裝。
npm install webpack -g
安裝 vue 腳手架專案初始化工具 vue-cli
,-g 表示全域性安裝。
如果你之前都是基於 vue-cli2.X,你需要先解除安裝它:
#若有,則先解除安裝vue-cli
npm uninstall -g vue-cli
#安裝cli4.x
npm i -g @vue/cli
#或者 vue -V 檢視版本是否為4.x
vue --version
Vue CLI >= 3 和舊版使用了相同的 vue 命令,所以 Vue CLI 2 (vue-cli) 被覆蓋了。如果你還是想繼續使用 2.x 搭建專案,你可以全域性安裝一個橋接工具:
npm install -g @vue/cli-init
# 然後你就可以繼續使用vue init了
npm init webpack my-project
有時候 npm 的下載速度比較感人,建議設定淘寶映象
npm config set registry=http://registry.npm.taobao.org -g
#配置後可通過下面方式來驗證是否成功 :
npm config get registry
快速原型開發
tips:適用於開發單頁面宣傳,庫,元件等使用。
使用 vue serve
和 vue build
命令對單個 *.vue
檔案進行快速原型開發,
前提是得安裝一個額外的全域性擴充套件: npm install -g @vue/cli-service-global
在一個空的資料夾中,新建一個 .vue
檔案,執行下面命令就能看到效果
#啟動服務
vue serve test.vue
#打包出生產環境的包
vue build test.vue
建立專案
vue create lion-ui
點選回車後,就會有各種選項,需要進行選擇,步驟以及我的選項如下:
兩個選擇,通過上下鍵操作:
default (babel, eslint)
預設配置 提供 babel 和 eslint 支援Manually select features
自己手動去選擇需要的配置
這裡選擇的是手動去配置的選項。然後需要哪個選項就在哪個選項上按 空格,就能選中/取消。
每一項的功能,做一下簡單闡述:
Babel
主要是對 es6 語法轉換成相容的 js (選上)TypeScript
支援使用 TypeScript 語法來編寫程式碼PWA
PWA 支援Router
支援 vue 路由配置外掛(一般都會選擇)Vuex
支援 vue 程式狀態管理模式 (一般都會選擇)CSS Pre-processors
支援 css 前處理器 (一般都會選擇)Linter / Formatter
支援程式碼風格檢查和格式化 (選上)Unit Testing
單元測試E2E Testing
E2E 測試
一般通用的選擇如下:
當選擇完成後,點選回車,會對每個配置進行個人需要的配置操作,
當前操作配置如下:
-
- 是否採用 history 模式,如果選擇 Y,需要後臺配置具體看 vueRouter 官網解釋,這裡我門選擇 n。
-
- 選擇一種 css 預處理,專案一般採用 scss,選擇第一個。
-
- 選擇格式化程式碼方式,一般選擇
ESlint + Prettier
。
- 選擇格式化程式碼方式,一般選擇
-
- 程式碼規則檢測,一般會選擇儲存就檢測
Lint on save
。
- 程式碼規則檢測,一般會選擇儲存就檢測
-
- 配置 Babel,PostCSS,ESLint 放在哪兒,這裡選擇的是專門的位置。
-
- 是否記錄當前專案配置,以方便下次建立專案可直接使用當前配置。快速建立。
根據提示,執行指令 cd project
然後執行命令npm run serve
啟動專案。
釋出專案為 npm run build
配置相關說明
當需要自定義 webpack 相關配置的時候,需要在專案根目錄中建立vue.config.js
檔案,它會被@vue/cli-server
自動載入,
相關配置內容官網將的很詳細,可以點選檢視
目錄結構
整個專案的目錄結構:
├── public # 靜態資源
│ ├── favicon.ico # favicon圖示
│ └── index.html # html模板
├── src # 原始碼
│ ├── api # 所有請求
│ │ └── modules # 請求介面的各個模組
│ ├── assets # 圖片、字型等靜態資源
│ │ ├──img # 圖片靜態資源
│ │ └──styles # 全域性樣式等靜態資源
│ ├── components # 全域性公用元件
│ ├── layout # 頁面整體佈局盒子
│ ├── plugins # 全域性外掛部分
│ ├── router # 路由
│ ├── store # 全域性store管理
│ │ └── modules # 各個模組狀態管理
│ ├── utils # 全域性公用方法
│ ├── views # views所有頁面
│ ├── App.vue # 入口頁面
│ ├── main.js # 入口檔案 載入元件 初始化等
├── .borwserslistrc # 瀏覽器相容相關
├── .env.xxx # 環境變數配置
├── .eslintrc.js # eslint 配置項
├── .gitignore # git忽略檔案設定
├── .babel.config.js # babel-loader 配置
├── package.json # package.json
└── vue.config.js # vue-cli 配置