一个vue全家桶搭建的SPA应用框架
前段时间vue3推出了bata版本,但是离正式版还有段时间,今天给搭建提供一个由# vue-cli4 + vue2.6 + vuex + vue-router + axios + element-ui搭建的框架,让大家能快速开发,跳过复杂的项目创建与配置过程。
项目已经封装好了请求和工具,指令和常用函数:
配置
项目截图:
web端
移动端
vue-cli 脚手架
Vue 是一套用于构建用户界面的渐进式框架。与其它大型框架不同的是, Vue 被设计为可以自底向上逐层应用。Vue 的核心库只关注视图层,不仅易于上手,还便于与第三方库或既有项目整合。 另一方面,当与现代化的工具链以及各种支持类库结合使用时,Vue 也完全能够为复杂的单页应用提供驱动。
安装
在已经安装了node和npm的前提下,只需要一行命令就能安装。
npm install -g @vue/cli
创建项目:
vue create project-name
# (project-name是你的项目名字)
默认情况下,会安装vue-router,vuex,axios,eslint,typescript,babel等常用工具的,也可以手动选择性的安装。这里不做赘述,因为我们的框架已经搭建好了,该框架是基于 vue-cli4 来搭建的,相对前面的 vue-cli2,和 vue-cli3 上都有了大量的优化。
vue-router 路由工具
vue-router 是 Vue.js 官方的路由插件,它和 vue.js 是深度集成的,适合用于构建单页面应用。vue 的单页面应用是基于路由和组件的,路由用于设定访问路径,并将路径和组件映射起来。传统的页面应用,是用一些超链接来实现页面切换和跳转的。在 vue-router 单页面应用中,则是路径之间的切换,也就是组件的切换。路由模块的本质 就是建立起 url 和页面之间的映射关系。
本框架中已经实现了路由拦截,动态路由等配置。
路由拦截:
//路由拦截
router.beforeEach((to, from, next) => { //路由跳转时,添加进度条
//处理页面位置
if(to.fullPath === '/'){
router.push('/baseStudy')
}
// if(to.name != 'login' && !commonUtil.getCookie('login')){
// // Vue.showAlert('未登录,已经调整到首页')
// router.push('/login')
// return
// }
NProgress.start(); //顶部进度条
next()
});
路由配置与动态路由
const baseRoute = [
{
name: 'layout',
path: '/',
component: layout,
// 子路由
children: arr
}
]
//利用vue-router2.2.0新增特性addRoutes实现路由动态加载,菜单动态加载,运用于后台管理系统,路由数据取自数据库
router.addRoutes(baseRoute)
export default router
vuex 状态管理
Vuex 是一个专为 Vue.js 应用程序开发的状态管理模式。它采用集中式存储管理应用的所有组件的状态,并以相应的规则保证状态以一种可预测的方式发生变化。Vuex 的目的是为了管理共享状态,为了达到这个目的,它制定了一系列的规则,比如修改数据源 state、触发 actions 等等,都需要遵循它的规则,以此来达到让项目结构更加清晰且易于维护的目的。每一个 Vuex 应用的核心就是 store(仓库)。store 基本上就是一个容器,它包含着你的应用中大部分的状态 (state)。大型项目中,vuex 是必不可少的。
定义 state 和 mutations
const state = {
isLoading: false,
menuPosition: '1-0',
isMobile: false,
isShowMenu: false
}
const mutations = {
setShowLoading(state, val) {
state.isLoading = val;
},
引入 vuex 和 VuexPersistence 来缓存状态
import VuexPersistence from 'vuex-persist'
import {state,mutations} from './mutations.js'
//这个插件是为了让vuex和localStorage结合,正常情况下,刷新页面,vuex的状态都会被情况,结合插件后,状态不会被清空
const vuexLocal = new VuexPersistence({
storage: window.localStorage,
reducer: state => ({
menuPosition: state.menuPosition //这里把菜单位置加入缓存,防止用户刷新浏览器后,菜单指向不对
}),
filter: (mutations) => (
mutations.type === 'setMenuPosition' ||
mutations.type === 'setArbitration'
)
})
Vue.use(Vuex)
export default new Vuex.Store({
state,
mutations,
plugins: [vuexLocal.plugin]
})
引入 axios,请求工具
首先要明白的是axios 是什么:axios 是基于 promise(诺言)用于浏览器和 node.js 是 http 客户端。其特点是:支持浏览器和 node.js,支持 promise,能拦截请求和响应,能转换请求和响应数据,能取消请求,自动转换 JSON 数据,浏览器支持防止 CSRF(跨站请求伪造)。任何一个非静态项目都离不开请求工具。
axios 引入与配置
import axios from 'axios'
axios.defaults.baseURL = baseURL
axios 请求拦截
// 添加请求拦截器
axios.interceptors.request.use(function (config) {
// 请求之前的拦截
//请求之前获取cookie,查看是否登录
// if(config.url.indexOf('/login') < 0 && !commonUtil.getCookie('login')){
// // Vue.showAlert('未登录,已经跳转到首页')
// router.push('/login')
// return
// }
store.commit('setShowLoading',true)
if (config.method === 'post') { //post请求进行添加分页参数
if (!config.data) {
config.data = {}
}
let params = {
PageNo:baseConfig.pageNo,
PageSize:baseConfig.pageSize
}
config.data = Object.assign(params, config.data);
}
// 在发送请求之前做些什么
return config;
}, function (error) {
store.commit('setShowLoading',false)
// 对请求错误做些什么
return Promise.reject(error);
});
axios.interceptors.response.use((response) => {
// 返回数据的拦截
store.commit('setShowLoading',false)
return response
},(err)=>{
store.commit('setShowLoading',false)
return Promise.reject(err)
});
axios requestFul 请求封装
//patch请求
Vue.prototype.$patch = function (url, parmas, successCallBack, errorCallBack) {
this.$axios.patch(url, parmas).then(res => {
successCallBack(res.data)
}).catch(err => {
(errorCallBack && errorCallBack()) || this.showAlert('error', err)
})
}
//delete请求
Vue.prototype.$del = function (url, parmas, successCallBack, errorCallBack) {
console.log(parmas, 'params')
this.$axios.delete(url, {data: parmas}).then(res => {
successCallBack(res.data)
}).catch(err => {
(errorCallBack && errorCallBack()) || this.showAlert('error', err)
})
}
//put请求
Vue.prototype.$put = function (url, parmas, successCallBack, errorCallBack) {
this.$axios.put(url, parmas).then(res => {
successCallBack(res.data)
}).catch(err => {
(errorCallBack && errorCallBack()) || this.showAlert('error', err)
})
}
//post请求
Vue.prototype.$post = function (url, parmas, successCallBack, errorCallBack) {
this.$axios.post(url, parmas).then(res => {
successCallBack(res.data)
}).catch(err => {
(errorCallBack && errorCallBack()) || this.showAlert('error', err)
})
}
//get请求
Vue.prototype.$get = function (url, parmas, successCallBack, errorCallBack) {
parmas = Object.assign(defaultParams,parmas)
this.$axios.get(url, parmas).then(res => {
successCallBack(res.data)
}).catch(err => {
(errorCallBack && errorCallBack()) || this.showAlert('error', err)
})
}
element-ui ui 库
本框架采用element-ui作为组件库,该框架由饿了么公司提供开源框架,其组件丰富,同时还有reace,angular版本,其被广泛用于 web 端项目中。
移动端适配
该框架采用px2rem,lib-flexible的适配方案来做移动端适配,原理是基于 rem 来实现的,能自动将样式中写的px转换为rem。并且在 web 端不会转换。
框架本身
主要功能:
采用了 vue-cli4 搭建
使用了 vue-router 来实现路由,实现单页面应用
使用 vuex 做状态管理工具
axios 做请求工具
element-ui 做 ui 框架。
项目实现了动态路由,跨域配置,请求拦截,路由拦截,状态本地存储等。
项目加入了px2rem,lib-flexible实现的移动端适配方案
本人写的大部分源码都在github中。
框架下载地址:地址
线上访问地址:地址
个人博客:地址
学习如逆水行舟,不进则退,前端技术飞速发展,如果每天不坚持学习,就会跟不上,我会陪着大家,每天坚持推送博文,跟大家一同进步,希望大家能关注我,第一时间收到最新文章。
公众号:
公众号
发表评论 (审核通过后显示评论):