Created By JishuBao on 2019-03-11 12:38:22
Recently revised in 2019-03-13 12:38:22
欢迎大家来到技术宝的掘金世界,您的star是我写文章最大的动力!
这是一篇使用vue+vant+vuex+vue-router实现公司需求的文章,会详细的介绍每个插件的作用等... 感觉不错的小伙伴,点赞star走一波; 感觉文章有误的小伙伴,评论区、走一波; 虚心求教,不胜感激~开篇题外话:
由于技术宝刚到公司,人生地不熟,正式项目还没有启动,暂时负责修改样式,解决同事遇到的技术小bug...,但是今天我接到了我的直接领导给我安排的任务,心情异常激动,说是让准备以下几个功能:
开篇点题:
1.换肤
2.动效
3.div换位置(动态换)(手动换)
今天就来带领大家来跟技术宝一起来学习下这些内容!
一、项目搭建
首先开始页面的开发,了解前端的人都知道,没有项目怎么开始写页面呢?所以我们接下来的任务就是搭建项目!首先将上次我们用webpack4搭建的Vue项目搭建起来,这里我给大家准备了Github地址,大家记得给我点个star哦,不胜感激!
1.下载项目
和使用Npm一样,我们首先确保自己电脑上安装了node,确定可以执行git相关的命令,首先git clone项目到本地,如下图:
2.跑起来
和正常的vue/react项目一样,在文件下执行 yarn install/npm install && yarn start/npm start 运行项目并打开即可看到
$ yarn installyarn install v1.7.0info No lockfile found.[1/4] Resolving packages...[2/4] Fetching packages...info fsevents@1.2.7: The platform "win32" is incompatible with this module.info "fsevents@1.2.7" is an optional dependency and failed compatibility check. Excluding it from installation.[3/4] Linking dependencies...warning " > less-loader@4.1.0" has unmet peer dependency "less@^2.3.1 || ^3.0.0".[4/4] Building fresh packages...success Saved lockfile.Done in 123.95s.复制代码
$ yarn startyarn run v1.7.0$ cross-env webpack-dev-server --config build/webpack.dev.conf.js 98% after emitting DONE Compiled successfully in 3639ms10:43:15 I You application is running here http://localhost:10000 N Some additionnal notes to be displayed unpon successful compilation复制代码
3.安装demo所需依赖
由于此次demo的开发需要依赖于Vant+Vuex+Vue-router+less,所以我们要安装所需的依赖!
执行命令:
yarn add vuex vue-router vant复制代码
安装所需依赖完毕!
yarn add v1.7.0[1/4] Resolving packages...[2/4] Fetching packages...info fsevents@1.2.7: The platform "win32" is incompatible with this module.info "fsevents@1.2.7" is an optional dependency and failed compatibility check. Excluding it from installation.[3/4] Linking dependencies...warning " > less-loader@4.1.0" has unmet peer dependency "less@^2.3.1 || ^3.0.0".[4/4] Building fresh packages...success Saved lockfile.warning Your current version of Yarn is out of date. The latest version is "1.13.0", while you're on "1.7.0".info To upgrade, run the following command:$ curl --compressed -o- -L https://yarnpkg.com/install.sh | bashsuccess Saved 7 new dependencies.info Direct dependencies├─ vant@1.5.9├─ vue-router@3.0.2└─ vuex@3.1.0info All dependencies├─ @babel/runtime@7.3.4├─ @vant/icons@1.0.8├─ @vue/babel-helper-vue-jsx-merge-props@1.0.0-beta.2├─ vant@1.5.9├─ vue-lazyload@1.2.3├─ vue-router@3.0.2└─ vuex@3.1.0Done in 24.50s.复制代码
二、项目页面编写
在上一节中我们搭建好了基本的开发环境,接下来就带大家编写基本的页面,由于样式不在此篇文章的考虑范围之内,所以我们直接采用vant的ui框架进行页面的搭建!
1.新建模糊页面login、home、secord
本文是移动端的一个编写,所以我们采用有赞的vant来编写项目,在src文件夹下新建一个views文件夹,再在views文件夹下新建几个基本页面内容如下:
login//login.vue文件内容复制代码
home//home.vue文件内容复制代码
secord//secord.vue内容复制代码
项目骨架如下图
2.新建路由配置文件
在src文件夹下新建router文件夹,文件夹下新建index.js文件当作路由配置文件
import Vue from 'vue';import VueRouter from 'vue-router';import Home from './../views/home';import Secord from './../views/secord';import UserLogin from './../views/login';import globalStore from './../store/global';Vue.use(VueRouter);const router=new VueRouter({ routes:[ { path:'/', redirect:to=>{ if(localStorage.getItem('token') && globalStore.state.isAuthentication){ return { path:'/home'} }else{ return { path:'/user/login'} } }// /路径下如果持久化存储localStorage下有token并且global.js下的Authentication(是否登陆)为true/false,如果登陆跳转到Home页面,没有的话,就跳转到用户登陆页面。 }, { path:'/user/login', name:'userlogin', component:UserLogin }, { path:'/effects', name:'effects', component:Effects, }, { path:'/home', name:'home', component:Home, }, { path:'/secord', name:'secord', component:Secord } ]});export default router;//index.js文件内容如上!复制代码
3.小试牛刀
import Vue from 'vue';//在import Vue的过程中,Vue主要是在原型上完成方法的挂载,并且初始化了全局的API。import App from './App.vue';//引入主VUE页面import router from './router/index';import './styles/reset.css' /**引入样式重置 */Vue.config.productionTip = false;//阻止启动生产消息,常用作指令new Vue({ el:"#root",//将渲染结果挂在这id为root的html上 router, render:h=>h(App),//render函数是渲染一个视图,然后提供给el挂载,如果没有render那页面什么都不会出来});//index.js文件内容如上!复制代码
在src文件夹下的index.js下引入路由配置文件,如上代码所示
同时修改app.vue(根vue页面)的template标签
复制代码
运行项目你会发现通过对应路径已经有页面展示出来
4.rem实现手机端自适应
因为本文是基于手机端的小demo,所以需要实现手机端屏幕大小自适应!
rem布局的本质是等比缩放,rem是根据根font-size的大小设置的
在src文件夹下新建utils,用来存放工具类函数等...
在utils文件夹下新建Rem.js
const baseSize=32;function setRem(){ const htmlWidth=document.documentElement.clientWidth || document.body.clientWidth; const htmlDom=document.getElementsByTagName('html')[0]; //设置页面根节点字体大小 htmlDom.style.fontSize=htmlWidth/10+'px';}setRem();//Rem.js内容如上复制代码
然后在src文件夹的index.js文件中新增rem设置,即引入
import './styles/reset.css' /**引入样式重置 */复制代码
因为暂时没有在less中发现和scss中类似的写法,故在scss定义一个px转化为rem的方法,在styles文件夹新建common.scss,需要时引入就行
@function pxToRem($px){ @return $px/20px*1rem;}//common.scss内容如下复制代码
5.在项目中引入vuex
虽然咱们只有几个页面,完全没必要引入vuex,使项目看起来变得很复杂,但是这不是为了让大家熟悉vuex嘛,知道如何在项目中使用,首先在src选新建store文件夹,暂且定义三个文件,global.js存放与全局相关的状态,home.js存放home页面相关的状态,secord.js存放secord页面相关的状态。
import Vue from 'vue';import Vuex from 'vuex';import home from './home';import secord from './secord';Vue.use(Vuex);export default new Vuex.Store({ namespaced:true, modules:{ home, secord }, state:{ isAuthentication:false,//是否有权限,是否登陆 }, getters:{ }, actions:{ }, mutations:{ updateState(state,payload){ Object.assign(state,payload); } }});//global.js文件内容如上复制代码
export default { namespaced:true, state:{ }, getters:{ }, actions:{ }, mutations:{ updateState(state,paylaod){ Object.assign(state,payload); } }}//home.js内容如上复制代码
export default { namespaced:true, state:{ }, getters:{ }, actions:{ }, mutations:{ updateState(state,paylaod){ Object.assign(state,payload); } }}//secord.js内容如上复制代码
文件写好后可以在index.js里面引入相关的文件使之初始化
import store from './store/global';new Vue({ el:"#root",//将渲染结果挂在这id为root的html上 router, store,//加载vuex render:h=>h(App),//render函数是渲染一个视图,然后提供给el挂载,如果没有render那页面什么都不会出来});复制代码
vuex核心概念
1.namespaced:也就是标识符,指明在哪个模块之后,vuex中的store分模块管理,需要在store的index.js中引入各个模块,为了解决不同模块命名冲突的问题,将不同模块的namespaced:true,之后在不同页面中引入getter、actions、mutations时,需要加上所属的模块名。
2.modules:Modules:将store分割成不同的模块。
3.state:包含所有应用级别状态的对象。
4.getters: vuex 中的getters 想当于vue中的computed ,getters是vuex 中的计算属性 ,计算属性写起来是方法,但它是个属性。
5.actions:包含异步操作、提交mutaions改变状态。
6.mutations:唯一修改状态的事件的回调函数。
因为我们暂时没有进行业务模块的开发,所以暂时没有定义很多状态等...
6.登陆页面login.vue的布局样式编写
在阅读了的官网后,我们需要现在public文件夹下的index.html文件的head标签内部引入vant样式!
复制代码
在项目中引入babel-plugin-import
PS E:\MyProject\Webpack4OfVueStage> yarn add babel-plugin-import -Dyarn add v1.7.0[1/4] Resolving packages...[2/4] Fetching packages...info fsevents@1.2.7: The platform "win32" is incompatible with this module.info "fsevents@1.2.7" is an optional dependency and failed compatibility check. Excluding it from installation.[3/4] Linking dependencies...warning " > less-loader@4.1.0" has unmet peer dependency "less@^2.3.1 || ^3.0.0".[4/4] Building fresh packages...success Saved lockfile.success Saved 1 new dependency.info Direct dependencies└─ babel-plugin-import@1.11.0info All dependencies└─ babel-plugin-import@1.11.0Done in 7.72s.复制代码
因为项目中使用的是babel7,所以新建babel.config.js
//在编译过程中将import的写法自动转换为按需引入的方式module.exports={ plugins:[ [ 'import',{ libraryName:'vant', libraryDirectory:'es', style:true },'vant' ] ]}复制代码
在index.js文件里面引入所需的大部分组件
import {Dialog,Row,Col,Picker,Field,Cell,CellGroup,Button,Toast,NavBar,Tabbar,TabbarItem,List,Panel,NoticeBar,Tag,Popup} from 'vant';Vue.use(Row).use(Col);Vue.use(Field);Vue.use(Cell).use(CellGroup);Vue.use(Button);Vue.use(Toast);Vue.use(NavBar);Vue.use(Tabbar).use(TabbarItem);Vue.use(Panel);Vue.use(List);Vue.use(NoticeBar);Vue.use(Tag);Vue.use(CircleButton);Vue.use(Popup);Vue.use(Picker);Vue.use(Dialog);复制代码
//以上为login.vue的内容(只关注样式部分,逻辑部分可以暂时忽略)复制代码确定
效果图如下(很丑,粗略设计):
接下来我就通过login.vue文件带领大家领略vuex的用法
复制代码 确定
通过vue的**@click绑定一个点击事件handleLogin**,在methods里面定义一个方法handleLogin
handleLogin(){ if(!this.username || !this.password){ this.$toast({ message:'请将信息填写完整' }); }else{ this.$store.dispatch('login',{ password:this.password, username:this.username, }); this.$router.push({ name:'home'}) } }复制代码
输入框输入账号密码,通过v-model指令将输入框的内容与data里面定义的username和password绑定,当账号为空或者密码为空时,调用vant的toast(弹出框:将信息填写完整),当账号密码都不为空时,通过this.$store.dispatch请求login方法,值得注意的是dispatch触发的是vuex模块的actions(常用于异步操作),让我们看看global的actions中的login方法,localStorage是一种浏览器存储数据的方式。
async login({commit},payload){ if(payload.password && payload.username){ localStorage.setItem('token','AUTHENTION'); commit('updateState',{ isAuthentication:true }) }else{ }}复制代码
当账号密码存在时,commit触发updateState方法,值得注意的是commit提交触发的是mutations方法:
updateState(state,payload){ Object.assign(state,payload);}复制代码
Object.assign()方法用于将多个对象合并为一个对象,上面的updateState方法可以将isAuthentication设置为true。
import Vue from 'vue';import Vuex from 'vuex';import home from './home';import secord from './secord';Vue.use(Vuex);export default new Vuex.Store({ namespaced:true, modules:{ home, secord }, state:{ isAuthentication:false, }, getters:{ }, actions:{ async login({commit},payload){ if(payload.password && payload.username){ localStorage.setItem('token','AUTHENTION'); commit('updateState',{ isAuthentication:true }) }else{ } } }, mutations:{ updateState(state,payload){ Object.assign(state,payload); } }});//global.js完整代码复制代码
7.home页面(换肤)的编写
由上面的login.vue所写,当填写账号密码后:
this.$router.push({ name:'home'})复制代码
这是vue-router的方法,目的是跳转到home页面,此时url为home。
话不多说,先把代码展示出来,再展示逻辑部分。
//home.vue的内容复制代码
其中我们自定义了一个组件tabbar,因为组件中每个页面都用到了这个组件,所以我们把它抽象成一个组件,这样我们就不需要重复写代码了,每个页面直接引用就可以了,当然页面也不是很多,我们完全可以每个页面都写一个,但是这不是为了让大家都了解组件的用法嘛!!!
新建components文件夹,在components文件夹下新建common文件夹,在common文件夹下新建Tabbar.vue文件。
//tabbar.vue的内容复制代码 换肤 动效 切换
其中props定义的是父组件传来的值,类型是number,默认值是0。
引入组件并注册组件
components:{ CommonTabbar},复制代码
computed中可以获取vuex home模块定义的state
computed:mapState({ formVisible:state=>state.home.formVisible,}),复制代码
当点击换肤的时候,触发changeSkin方法:
changeSkin(){ //点击换肤弹出皮肤选择框 this.$store.commit('home/updateState',{ formVisible:true })},复制代码
触发commit,即home模块里面的mutations里面的updateState方法,使formVisible设置为true,formVisible与v-model绑定,通过true/false来控制popup显示/隐藏。
点击换肤让popup弹窗显示出来,popup里面有picker的column绑定了columns,即各种皮肤颜色。
复制代码
当点击取消时设置formVisible为false时,弹框即消失。
当点击确定选择颜色时,触发handleSubmitSelect方法,此时我再此介绍一个枚举类形式的函数,此函数的目的是通过一个英文值含义或者中文值含义来返回对应的值。
function getThemeValue(value){ console.log('a'); if(!value){ return ''; } if(value === "少女粉"){ return 'girl'; } if(value === "天空蓝"){ return 'blue'; } if(value === "茄子紫"){ return 'purple'; } if(value === '清新绿'){ return 'green'; } if(value === '警告色'){ return 'warning'; } if(value === '危险红'){ return 'danger'; }}export default { getThemeValue,}//SkinTypeEnum.js定义复制代码
直接引入调用,把中文值转化为对应的英文。
handleSubmitSelect(value,index){ //点击确定 let colorValue=SkinTypeEnum.getThemeValue(value); document.getElementById('app').className=`${colorValue}Theme`; this.$store.commit('home/updateState',{ formVisible:false, }); localStorage.setItem('app_theme',document.getElementById('app').className)}//改变肤色的重要方法复制代码
接下来就是整个功能的重中之重了!!请祥听
8.编写less文件实现换肤
1.在styles文件夹下新建theme.less
.theme(@background){ .change{ background-color:@background; }}//theme.less内容复制代码
2.在styles文件夹下新建color.less
@import "./theme.less";@girlPink:#FC9F9F;//少女粉@skyBlue:#1890FF;//天空蓝@eggplantPurple:purple;//茄子紫@freshGreen:#09C160;//清新绿@warningColor:#FF976A;@dangerRed:#FF4D4F;//危险红.girlTheme{ .theme(@girlPink);}.blueTheme{ .theme(@skyBlue);}.purpleTheme{ .theme(@eggplantPurple);}.greenTheme{ .theme(@freshGreen);}.warningTheme{ .theme(@warningColor);}.dangerTheme{ .theme(@dangerRed);}//color.less内容复制代码
熟悉Less的小伙伴们应该看到以后就大致明白了,通过color.less引入theme.less,可以使change类名下的背景颜色改为相对应类目不一样的颜色
3.在需要改变肤色的页面引入color.less,并将需要修改的div类目设置为change
因为我们的项目是单页(SPA)应用,所有的vue页面都是在根div下,所以设置根目录下的class类名就可以改变vue页面class类名为change的div背景色。所以我们把想要更换div背景色套上change类名就行了!其实我们之前写的页面都已经套上change了哦!不知道大家有没有发现!
4.持久化改变肤色
其实这里还是有一个Bug的,就是每当重启服务浏览器的时候,所有的类名初始化,之前的颜色将会消失,所以我们这里将皮肤主题保存进localStorage(如果不手动清楚浏览器缓存,它就始终不会消失!)
localStorage.setItem('app_theme',document.getElementById('app').className)复制代码
在根vue app.vue里面的生命周期函数中设置存下来的肤色,一切万事OK!
复制代码
大致效果就如下图所示,下一个需求是动态更改div位置,希望大家可以期待哦!
如果你觉得我的文章还不错的话,可以给个star哦~,