搭建开发环境
Vue3 + Vant UI_多功能记账本
项目演示
1、创建项目
终端键入以下指令,每一行命令跟一个回车(也可以使用 npm,方法类似)
// 创建 vite-app 项目 yarn create vite-app daily-cost // 定位到 daily-cost 目录 cd daily-cost // 添加依赖 yarn // 启动项目 npm dev
安装路由插件
yarn add vue-router@next • 1
2、配置路由
在 src 目录下创建 router 文件夹,router 文件夹里面创建 index.js 文件,用于路由的配置
./src/router/index.js
// 用的是 hash 路由,不需要后端支持 import { createRouter, createWebHashHistory } from "vue-router"; import Home from '../views/Home.vue' // 创建路由实例 const router = createRouter({ history: createWebHashHistory(), // hash 模式 routes: [ { path: "/", component: Home } ] }) // 抛出路由实例 export default router
在 src 目录下创建 views 文件夹,views 文件夹里面创建 Hello.vue 组件,让路径能渲染出内容
./src/views/Hello.vue
<template> <div>前端杂货铺</div> </template> <script> export default {}; </script>
在 main.js 文件中 导入并使用路由,记得拆分一下源代码,好让 router 被使用
main.js
import { createApp } from 'vue' import App from './App.vue' import router from './router' import './index.css' const app = createApp(App) app.use(router) app.mount('#app')
在 App.vue 组件中导入 Hello.vue 组件,并做出呈现
App.vue
<template> <router-view /> </template> <script> import Home from './views/Home.vue' export default { name: 'App', components: { Home } } </script>
此时,yarn dev,打开浏览器可以看到…
3、添加 Vant UI 组件库
安装 Vant UI 组件库( Vant UI 国内地址)
yarn add vant@3.0.0-beta.8 -S
添加按需引入的插件(减少代码量,加快项目的启动)
yarn add babel-plugin-import -D • 1
在根目录添加 babel.config.js,代码如下
module.exports = { plugins: [ [ "import", { libraryName: "vant", libraryDirectory: "es", style: true, }, "vant", ], ], };
在 main.js 文件中导入样式并按需注册组件
import { createApp } from 'vue' import {Button} from 'vant' import App from './App.vue' import router from './router' import "vant/lib/index.css"; // 全局引入样式 import './index.css' // 创建实例 const app = createApp(App) // 注册组件 => 按需注册 app.use(Button) app.use(router) app.mount('#app')
在 Hello.vue 组件中,随便添加一个组件做测试(中号的警告按钮)
<template> <div>前端杂货铺</div> <van-button type="warning" size="middle">中号按钮</van-button> </template> <script> export default {}; </script>
此时,yarn dev,打开浏览器可以看到…
4、移动端 rem 配置
本项目是一个移动端的项目,需要使用 rem 做不同手机型号的适配
Vant 中的样式默认使用 px 作为单位,如果要使用 rem 单位,可使用以下两个工具
postcss-pxtorem 是一款 postcss 插件,用于将单位转化为 rem(在编译的时候对 px 单位转换为 rem 单位时使用)
lib-flexible 用于设置 rem 基准值(网页做 html 的 font-size 适配用的)
接下来,安装它们
yarn add lib-flexible -S
yarn add postcss-pxtorem -D
在 main.js 引入 lib-flexible
main.js
import { createApp } from 'vue' import {Button} from 'vant' import "lib-flexible/flexible"; import App from './App.vue' import router from './router' import "vant/lib/index.css"; // 全局引入样式 import './index.css' // 创建实例 const app = createApp(App) // 注册组件 => 按需注册 app.use(Button) app.use(router) app.mount('#app')
在根目录声明 postcss.config.js 文件,为 px 单位转 rem 单位做配置
module.exports = { plugins: { "postcss-pxtorem": { rootValue: 37.5, // Vant 官方根字体的大小 propList: ['*'], selectorBlackList: [".norem"] // 过滤掉.norem-开头的 class,不进行 rem 转换 } } }
在 Hello.vue 组件设置一个 div 样式,测试 rem 适配是否成功
Hello.vue
<template> <div class="demo">前端杂货铺</div> <van-button type="warning" size="middle">中号按钮</van-button> </template> <script> export default {}; </script> <style scoped> .demo { width: 100px; height: 100px; background: aquamarine; } </style>
此时,yarn dev,打开浏览器可以看到…
5、添加 iconfont 文字图标库
首先,注册个人账户
之后,新建自己的项目
随便添加一个图标到库
选择项目,添加购物车的图标到项目中
生成 hash 码
生成的 hash码 添加至 index.html 文件(注意:每次新增图标后,都要重新生成新的 css 静态资源,需要在这里替换最新的路径)
index.html
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <link rel="icon" href="/favicon.ico" /> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <link rel="stylesheet" href="//at.alicdn.com/t/c/font_3639381_k7hsr2nrb2j.css"> <title>Vite App</title> </head> <body> <div id="app"></div> <script type="module" src="/src/main.js"></script> </body> </html>
在 Hello.vue 中添加图标,测试是否可以使用
Hello.vue
<template> <div class="demo">前端杂货铺</div> <i class="iconfont icon-bianji"></i> <van-button type="warning" size="middle">中号按钮</van-button> </template> <script> export default {}; </script> <style scoped> .demo { width: 100px; height: 100px; background: aquamarine; } </style>
此时,yarn dev,打开浏览器可以看到图标显示出来…
6、二次封装 Axios 请求库
在 src 目录下创建 utils 文件夹,该文件夹下创建 axios.js 文件
import axios from "axios"; import { Toast } from "vant"; import { useRouter } from "vue-router"; axios.defaults.baseURL = process.env.NODE_ENV == "development" ? "//localhost:3000" : "//192.168.1.6:3000/"; // 根据环境变量切换本地和线上的请求地址 axios.defaults.withCredentials = true; // 允许跨域 axios.defaults.headers["X-Requested-With"] = "XMLHttpRequest"; axios.defaults.headers["token"] = localStorage.getItem("token") || ""; // 本项目采用 token 的用户鉴权方式,在请求头的 headers 内添加 token,每次请求都会验证用户信息 axios.defaults.headers.post["Content-Type"] = "application/json"; axios.interceptors.response.use((res) => { const router = useRouter(); // vue-router 4.x 的实例 if (typeof res.data !== "object") { Toast.fail("服务端异常!"); return Promise.reject(res); } // code 非 200 的情况下为异常情况 if (res.data.code != 200) { if (res.data.msg) Toast.fail(res.data.msg); if (res.data.code == 401) { router.push({ path: "/login" }); } return Promise.reject(res.data); } // 其他情况直接返回 data 数据 return res.data; }); export default axios;
7、添加 Less 预处理器
安装 Less 插件
npm i less less-loader -D
在 src 目录下新建 config 文件夹,在里面新建 custom.less 文件
custom.less
- 先添加一些样式,后续还会更新
@primary: #18b7d3; // 主题色 @danger: #fc3c0c; @primary-bg: #f5f5f5;
写到最后(附源码)
看到这么好的项目,是不是有种想自己做出来的冲动?
如果有,那么说明你非常的想提升自己,想检验自己这段时间的学习成果,这个项目绝对是你的 不二选择
心动不如行动
那么接下来,一起从0搭建,开始我们基于 Vue3.x + Vant UI 的项目之旅吧~