Vue.js 創建多人共享博客
多人共享博客
上一個項目:仿 CNODE 社區 剛完成,感覺有點意猶未盡,對於 登錄 這一塊老師並沒有展開,我先是用了 localStorage 自己瞎搞,跑通之後想了下,vuex 不是專門做全局狀態管理的麽?那麽用 vuex 做登錄是最合適不過的呀。於是又搜了些別人用 vuex 做登錄狀態管理的案例,算是搞明白了。
現在選擇了若愚老師的這個項目,主要是鞏固一下對 vue 的認識,同時對 vuex 做個更詳細的了解。
本項目做一款多人共享博客,包含首頁、用戶文章列表、登錄、註冊、個人管理、編輯、發布等功能。
測試賬號: hunger10086
測試密碼: 123456
項目鏈接:GitHub
預覽鏈接:Git Pages
實現功能:
- 用戶的登錄、註冊、註銷
- 首頁多人博客展示
- 用戶博文展示
- 我的頁面博文展示及管理
- 博文的創建、編輯、刪除、發布
使用 Vue.js 技術棧:vue-cli / vue2 / axios / vue-router /vuex / es6 / webpack / element-ui
博客主要記錄項目完成過程中學習到的知識點,其他的就一筆帶過了。
項目初始化
老套路了..使用 vue-cli 創建項目骨架
創建路由
在 vue 項目中使用 less: <style scoped lang=‘less‘></style>
如果要在某個組件中引入 less 文件,則在 style 中寫入 @import ‘../assets/base.less‘;
ElementUI 的使用
ElementUI 的有很詳細的安裝使用文檔
主要步驟:
1.安裝 cnpm i element-ui
2.引入
import ElementUI from ‘element-ui‘;
import ‘element-ui/lib/theme-chalk/index.css‘;
3.掛載到 Vue Vue.use(ElementUI)
然後就可以在組件中使用 element-ui 了。
數據請求接口封裝
另外,若愚老師前期還對 axios 底層請求做了進一步的定制和封裝,其中一些技巧很值得學習。
1.先把 axios 請求封裝成了輸入參數更簡潔明了、報錯信息更「人性化」的 Promise 對象。
// /helpers/request.js
axios.defaults.headers.post[‘Content-Type‘] = ‘application/x-www-form-urlencoded‘
axios.defaults.baseURL = ‘http://blog-server.hunger-valley.com‘
axios.defaults.withCredentials = true
export default function request(url, type = ‘GET‘, data = {}) {
return new Promise((resolve, reject) => {
let option = {
url,
method: type
}
if(type.toLowerCase() === ‘get‘) {
option.params = data
}else {
option.data = data
}
axios(option).then(res => {
console.log(res.data)
if(res.data.status === ‘ok‘) {
resolve(res.data)
}else{
Message.error(res.data.msg)
reject(res.data)
}
}).catch(err => {
Message.error(‘網絡異常‘)
reject({ msg: ‘網絡異常‘ })
})
})
}
2.再把獲取數據的 API 進行封裝,使其更易用:
import request from ‘@/helpers/request‘
const URL = {
REGISTER: ‘/auth/register‘,
LOGIN: ‘/auth/login‘,
LOGOUT: ‘/auth/logout‘,
GET_INFO: ‘/auth‘
}
export default {
// 註冊
register({username, password}) {
return request(URL.REGISTER, ‘POST‘, { username, password })
},
// 登錄
login({username, password}) {
return request(URL.LOGIN, ‘POST‘, { username, password })
},
// 登出
logout() {
return request(URL.LOGOUT)
},
// 獲取信息
getInfo() {
return request(URL.GET_INFO)
}
}
這樣子處理的話,登錄請求就可以不使用 axios(‘http://blog-server.hunger-valley.com/auth/login‘,‘POST‘,{username,password})
那麽繁瑣了,直接 auth.login({username,password})
就完事了~
可以查看此 commit
grid
使用 grid 進行布局。
關於 grid 布局之前有了解過,grid 通過在頁面上劃分 columns 和 rows ,然後把內容分別放進不同區域來建立布局,也寫過 demo,但真正在項目中使用還是第一次。關於 grid 的教程可以參考這裏
如在項目中的使用:
#app {
display: grid;
// 分成三列,左右列寬度分別是頁面的12%,中間內容寬度自適應
grid-template-columns: 12% auto 12%;
// 分成三行,上下行高度自適應,中間內容占滿剩余寬度
grid-template-rows: auto 1fr auto;
// 劃分區域
grid-template-areas: "header header header"
". main . "
"footer footer footer";
#header{
grid-area: header;
padding-left: 12%;
padding-right: 12%;
}
#main{
grid-area: main;
}
#footer{
grid-area: footer;
padding-left: 12%;
padding-right: 12%;
}
}
可以查看此 commit
async/await
在完成項目的過程中接觸到了 async/await :
async/await 是異步編程的一種解決方案。
async 聲明一個函數為異步函數,這個函數返回的是一個 Promise 對象;
await 用於等待一個 async 函數的返回值(註意到 await 不僅僅用於等 Promise 對象,它可以等任意表達式的結果,所以,await 後面實際是可以接普通函數調用或者直接量的。)
以項目中用戶註冊為例:
// 聲明 register 為一個異步函數,他會返回一個 Promise 對象
async register({commit},{username,password}){
// 用戶註冊成功後後會返回的一個 Promise 對象,其中包含了用戶的信息,let res 就是異步 auth.register 獲取的結果
let res = await auth.register({username,password})
commit(‘setUser‘,{user:res.data})
commit(‘setLogin‘,{isLogin:true})
// 把 res.data 返回出去,使用 register() 後就可以用 then 來處理這個結果
return res.data
},
對於 async/await,我參考了 邊城 在 segmentfault 中的這邊文章。
Vuex
如何在項目中使用 vuex 管理狀態?(以登錄為例)
- 1.創建store,定義 state/getters/mutations/actions
由於使用單一狀態樹,應用的所有狀態會集中到一個比較大的對象。當應用變得非常復雜時,store 對象就有可能變得相當臃腫。
為了解決以上問題,Vuex 允許我們將 store 分割成模塊(module)。每個模塊擁有自己的 state、mutation、action、getter、甚至是嵌套子模塊——從上至下進行同樣方式的分割
在這裏針對不同的內容狀態管理劃分到不同的文件,保持可讀性:
store
|
│ index.js // 引入子模塊
│
└─modules
auth.js // 負責用戶註冊、登錄狀態
blog.js // 負責用戶獲取、發布、修改博客等
把負責用戶註冊登錄的 state 寫在了 auth.js:
// auth.js
import auth from ‘@/api/auth‘
const state = {
// 先定義一個默認的用戶狀態
user:null,
//登錄狀態
isLogin:false
}
const getters = {
// 獲取 state 數據
user:state => state.user,
isLogin:state => state.isLogin
}
const mutations = {
// 更新用戶數據
setUser(state,payload){
state.user = payload.user
},
// 更新用戶登錄狀態
setLogin(state,payload){
state.isLogin = payload.isLogin
}
}
const actions = {
...
// 檢測用戶是否登錄
async checkLogin({commit,state}){
// 先從本地store的state去看用戶是否登錄,如果登錄了 就返回true
if(state.isLogin) return true
let res = await auth.getInfo()
commit(‘setLogin‘,{isLogin:res.isLogin})
// 如果本地沒有這個狀態,就發ajax請求去服務器,服務器會返回一個isLogin的響應,根據這個值來確定是否登錄
if(!res.isLogin) return false
commit(‘setUser‘,{user:res.data})
// 最後的 return true 是為了在實例中then拿到這個true,方便做下一步處理
return true
},
// 用戶登錄 {commit} 是默認參數,相當於 context.commit,使用了 ES6 的參數結構
login({commit},{username,password}){
// 調用底層接口,返回的是一個 Promise 對象
return auth.login({username,password})
.then(res => {
// 把通過 axios 獲取回來的用戶數據提交 mutation,更新到 state: commit -> setUser -> state
commit(‘setUser‘,{user:res.data})
commit(‘setLogin‘,{isLogin:true})
})
},
...
}
export default {
state,
getters,
mutations,
actions
}
- 2.在 /store/index.js 把模塊引入進來:
// index.js
import Vue from ‘vue‘
import Vuex from ‘vuex‘
import auth from ‘./modules/auth‘
Vue.use(Vuex)
export default new Vuex.Store({
modules:{
auth,
}
})
- 3.在相關組件中映射屬性,commit 更新
在 Login.vue 中,我們要做的事情就是:點擊按鈕後,調用 auth.js 中的 login()
方法,完成登錄,更新 state 中的數據,並給需要的組件更新狀態(如 header.vue)
首先映射 login 方法到此組件,這樣此組件就可以通過 this.login
來調用這個 auth.js 中的方法了:
//Login.vue
import {mapActions} from ‘vuex‘
export default {
name:‘Login‘,
methods:{
...mapActions([
‘login‘
]),
},
}
接著設置點擊事件,點擊按鈕會執行 onLogin,調用 this.login ,發送 axios 請求 auth.login({username,password})
,成功註冊後 commit mutation,更新 state 數據,跳轉到首頁:
<el-button size="medium" @click="onLogin">立即登錄</el-button>
//Login.vue
methods:{
...mapActions([
‘login‘
]),
onLogin(){
this.login({username:this.username,password:this.password})
.then(()=>{
console.log(`${this.username},${this.password}`)
this.$router.push({path:‘/‘})
})
}
},
- 4.在相關組件中關聯 state 數據,實現狀態切換
在 Header 中,登錄和未登錄,他的樣式在兩種狀態下是不一樣的:
未登錄的時候,header 會顯示提示登錄和註冊的按鈕;登錄之後,header 會顯示用戶頭像及其他操作選項。
而這兩種狀態的切換,就要依靠我們的 state 了,首先引入映射 {mapGetters,mapActions}
,在頁面還未渲染的時候檢查 state 中用戶登錄狀態,用戶已登錄,則返回 isLogin = true
,獲取用戶信息,渲染到頁面上;用戶未登錄,則返回 isLogin = false
。
<header :class="{login:isLogin,‘no-login‘:!isLogin}">
// Header.vue
import {mapGetters,mapActions} from ‘vuex‘
export default {
name:‘Header‘,
// 把 store 中 getter 屬性映射到此組件
computed:{
...mapGetters([
‘isLogin‘,
‘user‘
])
},
//在頁面沒有渲染之前檢查用戶是否登錄
created(){
this.checkLogin()
},
methods:{
// 把 auth.js 中的 checkLogin 方法映射到此組件
...mapActions([
‘checkLogin‘
]),
},
這就是 vuex 在在項目中管理登錄狀態了。
完善路由
添加路由元信息。
項目中有一些頁面,比如添加文章、編輯文章等等,都需要先確認用戶是否登錄才能操作,否則將會自動跳轉到登錄頁。
路由元信息做的就是這樣一件事情,我們給某段路由添加一個 meta 字段 meta:{ requiresAuth:true }
,這段路由路由匹配到的所有路由記錄會暴露為 $route 對象 (還有在導航守衛中的路由對象) 的 $route.matched 數組。通過遍歷 $route.matched 來檢查路由記錄中的 meta 字段,對訪問的路徑做一個狀態檢查,從而確定是否允許訪問。
const router = new Router({
routes: [
...
{
path: ‘/Create‘,
component: () =>import (‘@/pages/Create/Create‘),
// 路由添加 meta 字段
meta:{ requiresAuth:true }
},
...
]
})
router.beforeEach((to, from, next) => {
if (to.matched.some(record => record.meta.requiresAuth)) {
// 如果 store.dispatch(‘checkLogin‘) 返回的結果 isLogin 為 false,則說明用戶沒有登錄,就會跳轉到 /login
store.dispatch(‘checkLogin‘).then(isLogin=>{
if (!isLogin) {
next({
path: ‘/login‘,
query: { redirect: to.fullPath }
})
} else {
next()
}
})
} else {
next() // 確保一定要調用 next()
}
})
懶加載
小技巧 - 按需加載,節約性能:
按需加載的適用場景,比如說「訪問某個路由的時候再去加載對應的組件」,用戶不一定會訪問所有的路由,所以沒必要把所有路由對應的組件都先在開始的加載完;更典型的例子是「某些用戶他們的權限只能訪問某些頁面」,所以沒必要把他們沒權限訪問的頁面的代碼也加載。
// before
import Index from ‘@/pages/Index/Index‘
const router = new Router({
routes: [
{
path: ‘/‘,
component: Index
},
...
]
})
// after
const router = new Router({
routes: [
{
path: ‘/‘,
component: () =>import (‘@/pages/Index/Index‘)
},
...
]
})
marked
使用 marked.js 對 markdown 內容進行轉換:
文章詳情頁(Detail)中,通過服務器返回的文章內容是 markdown 格式的,先用 marked.js 庫處理一下,再使用 v-html 渲染到頁面中。
1.安裝 cnpm install marked
2.在組件中引入 import marked from ‘marked‘
3.把內容進行轉換:
computed:{
markdown(){
return marked(this.rawContent) //this.rawContent 是從服務器獲取的文章正文
}
},
4.在頁面中引入: <section class="article" v-html=‘markdown‘></section>
vue-devTools
最後介紹一款小插件,可以在使用 vue 開發的時候更好地調試和 debug。
vue-devtools是一款基於chrome遊覽器的插件,用於調試vue應用,這可以極大地提高我們的調試效率。
GitHub 文檔:vue-devtools
Chrome 插件下載地址:Get the Chrome Extension
當我們添加完vue-devtools擴展程序之後,我們在調試vue應用的時候,chrome開發者工具中會看一個vue的一欄,點擊之後就可以看見當前頁面vue對象的一些信息。vue-devtools使用起來還是比較簡單的,上手非常的容易,這裏就細講其使用說明了。
Vue.js 創建多人共享博客