Vite 2.0 搭建 Vue3 移动端项目
一. 涉及技术点
- vite
- vue3
- ts
- router
- vuex
- axios
- vant3
- 移动端适配
- 请求代理
二. 步骤
vite+ts+vue3只需要一行命令
npm init @vitejs/app my-vue-app --template vue-ts
复制代码
初始化项目
npm install
npm run dev
复制代码
安装typescript
- 在项目的根目录创建文件:tsconfig.json
// 指定了用来编译这个项目的根文件和编译选项
// 配置参考https://www.tslang.cn/docs/handbook/tsconfig-json.html
{
"compilerOptions": {
"target": "esnext",
"module": "esnext",
"strict": true, //这样可以对`this`上的数据属性进行严格的推断,否则总是被视为any类型
"jsx": "preserve",
"moduleResolution": "node"
},
"include": [
"src/**/*", "src/main.d.ts" //**/递归匹配任意子目录
],
"exclude": [
"node_modules"
]
}
复制代码
- 修改src/main.js为src/main.ts
- 修改根目录下index.html中引入的main.js为main.ts
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<link rel="icon" href="https://juejin.cn/favicon.ico" />
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Vite App</title>
</head>
<body>
<div id="app"></div>
<!--<script type="module" src="https://juejin.cn/src/main.js"></script>-->
<script type="module" src="https://juejin.cn/src/main.ts"></script>
</body>
复制代码
- 修改项目的入口文件为main.ts,在项目根目录创建文件vue.config.js
module.exports = {
pages: {
index: {
entry: 'src/main.ts'
}
}
};
复制代码
经过以上步骤之后,会发现项目还是可以正常启动的,但是在main.ts中会发现有一个报错
此时是因为使用ts的时候引入.vue
文件的时候会报错,找不到相应的模块,是因为ts只认识以.ts
结尾的文件,并不认识.vue
结尾的文件,以此要在项目的/src
文件下创建一个.d.ts
文件来定义一下.vue
文件:
// 在没用用到需要具体定义的内容的时候,可以只声明一下'*.vue'就可以
// src/main.d.ts
declare module '*.vue' {
/*
import {ComponentOptions} from 'vue';
const componentOptions: ComponentOptions;
export default componentOptions; */
}
复制代码
注意:要给.d.ts文件一个文件名,例如a.d.ts,否则eslint没有办法对其进行格式化;也请不要把入口文件和.d.ts的文件重名,否则.d.ts文件不生效
** 配置路由**
- 安装vue-router的时候一定要带上版本号,否则现在安装的还是3.x的版本
npm install vue-router@4
复制代码
- 在src/新建文件夹router,并在router文件加下新建index.ts文件:
//现在创建router的方式与vue2.x的版本已经很不同了
import {createRouter, createWebHashHistory} from 'vue-router';
const routes = [
{
path: '/',
redirect: '/home',
},
{
path: '/home',
component: () => import('../components/home.vue')
}
];
const router = createRouter({
history: createWebHashHistory(), //替代之前的mode,是必须的
routes
});
export default router;
复制代码
- 修改src/main.ts:
import {createApp} from 'vue';
import App from './App.vue';
import router from './router/index'; //引入vue-router
import './index.css';
const app = createApp(App);
app.use(router); // 挂载到app上
app.mount('#app');
复制代码
配置状态管理vuex(4.x)
- 安装
npm i vuex@next --save
复制代码
- 配置
在src下创建store目录,并在store下创建index.ts
import { createStore } from "vuex";
export default createStore({
state: {
listData:{1:10},
num:10
},
mutations: {
setData(state,value){
state.listData=value
},
addNum(state){
state.num=state.num+10
}
},
actions: {
setData(context,value){
context.commit('setData',value)
},
},
modules: {}
});
复制代码
- 挂载
在main.ts挂载
import { createApp } from 'vue'
import App from './App.vue'
import router from "./router";
import store from "./store";
createApp(App)
.use(router)
.use(store)
.mount('#app')
复制代码
Vant3
- 安装
npm i vant@next -S
复制代码
vite版本不需要配置组件的按需加载,因为Vant 3.0 内部所有模块都是基于 ESM 编写的,天然具备按需引入的能力,但是样式必须全部引入137.2k
- 在main.ts全局引入样式
import { createApp } from 'vue'
import App from './App.vue'
import router from "./router";
import store from "./store";
import vant from 'vant'
import 'vant/lib/index.css'; // 全局引入样式
createApp(App)
.use(router)
.use(store)
.use(vant)
.mount('#app')
复制代码
配置网络请求axios
- 安装
npm i -s axios
复制代码
- 配置axios
在src创建utils文件夹,并在utils下创建request.ts
import axios from "axios";
const service = axios.create({
baseURL,
timeout: 5000 // request timeout
});
// 发起请求之前的拦截器
service.interceptors.request.use(
config => {
// 如果有token 就携带tokon
const token = window.localStorage.getItem("accessToken");
if (token) {
config.headers.common.Authorization = token;
}
return config;
},
error => Promise.reject(error)
);
// 响应拦截器
service.interceptors.response.use(
response => {
const res = response.data;
if (response.status !== 200) {
return Promise.reject(new Error(res.message || "Error"));
} else {
return res;
}
},
error => {
return Promise.reject(error);
}
);
export default service;
复制代码
- 使用
import request from "../utils/request";
request({url: "/profile ",method: "get"})
.then((res)=>{
console.log(res)
})
复制代码
配置请求代理
vite.config.ts
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'
import path from 'path';
// https://vitejs.dev/config/
export default defineConfig({
plugins: [vue()],
base:"./",//打包路径
resolve: {
alias:{
'@': path.resolve(__dirname, './src')//设置别名
}
},
server: {
port:4000,//启动端口
open: true,
proxy: {
// 选项写法
'/api': 'http://123.56.85.24:5000'//代理网址
},
cors:true
}
})
复制代码
移动端适配(postcss-pxtorem)
- 安装postcss-pxtorem
npm install postcss-pxtorem -D
复制代码
- 在根目录下创建postcss.config.js
module.exports = {
"plugins": {
"postcss-pxtorem": {
rootValue: 37.5,
// Vant 官方根字体大小是 37.5
propList: ['*'],
selectorBlackList: ['.norem']
// 过滤掉.norem-开头的class,不进行rem转换
}
}
}
复制代码
- 在根目录src中新建util目录下新建rem.ts等比适配文件
// rem等比适配配置文件
// 基准大小
const baseSize = 37.5
// 注意此值要与 postcss.config.js 文件中的 rootValue保持一致
// 设置 rem 函数
function setRem () {
// 当前页面宽度相对于 375宽的缩放比例,可根据自己需要修改,一般设计稿都是宽750(图方便可以拿到设计图后改过来)。
const scale = document.documentElement.clientWidth / 375
// 设置页面根节点字体大小(“Math.min(scale, 2)” 指最高放大比例为2,可根据实际业务需求调整)
document.documentElement.style.fontSize = baseSize * Math.min(scale, 2) + 'px'
}
// 初始化
setRem()
// 改变窗口大小时重新设置 rem
window.onresize = function () {
console.log("我执行了")
setRem()
}
复制代码
- 在mian.ts引入
import "./utils/rem"
复制代码
以上,一个最基本的移动端开发配置完成。
三. vite对<script setup>
和<style vars>
的支持格外友好
正常写法
<script lang="ts">
import { defineComponent } from "vue";
import { useRouter } from "vue-router";
export default defineComponent({
setup() {
const router = useRouter();
const goLogin = () => {
router.push("/");
};
return { goLogin };
},
});
</script>
复制代码
<script setup>
写法
<script lang="ts" setup="props">
import { useRouter } from "vue-router";
const router = useRouter();
const goLogin = () => {
router.push("/");
};
</script>
复制代码
是不是简洁了很多
<style vars>
如何用?
<script lang="ts" setup="props">
const state = reactive({
color: "#ccc",
});
</script>
复制代码
<style >
.text {
color: v-bind("state.color");
}/
</style>
复制代码
就这么简单!
© 版权声明
文章版权归作者所有,未经允许请勿转载。
THE END