# 基于vite+vue3+vant4的移动端H5应用

**Repository Path**: ls-long/weg-vant-h5

## Basic Information

- **Project Name**: 基于vite+vue3+vant4的移动端H5应用
- **Description**: 基于vite+vue3+vant4的移动端H5应用
- **Primary Language**: TypeScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 6
- **Created**: 2024-07-16
- **Last Updated**: 2024-07-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

   # Vue 3 + TypeScript + Vite + pinia + Vant4 : SPA

This template should help get you started developing with Vue 3 and TypeScript in Vite. The template uses Vue 3 `<script setup>` SFCs, check out the [script setup docs](https://v3.vuejs.org/api/sfc-script-setup.html#sfc-script-setup) to learn more.

## 本多页应用使用到的技术:
- vite 4.x：vue作者研发并推荐的开箱即用构建工具，同时为项目提供超快热重启开发环境；相对于webpack，Vite更加轻量，并且构建速度足够快。
- typescript：javascript的超集，es-next一指努力追求的最终形态语法标准。
- vue 3.x：vue3最新版本。
- vue-router 4.x：vue3下最新的路由。
- pinia 2.x：轻量级状态管理库，vue官方认证取代vuex：完整的 TypeScript 支持，更加轻量体积。
- vant 4.x：有赞的轻量、可定制的移动端组件库最新版。
- Nodejs 版本要求：16+

### 在main.ts中，手动于入口处引用vant中以函数形式提供的组件的样式，根据项目实际可注释掉部分全局引入
- import 'vant/es/toast/style'  //toast
- import 'vant/es/dialog/style'  //dialog
- import 'vant/es/notify/style'  //notify  
- import 'vant/es/image-preview/style' //imagePreview

### 更换颜色样式,一共两处地方，直接修改颜色即可
- src/assets/global.css： 修改自定义变量、vant4指定变量的值，即可实现全局修改
- src/assets/scss/theme.scss： 修改定义全局的scss使用的$样式变量，以便让系统同时支持var(--*)和$**两种写法

### 注意
每一个路由views的模板template，都必须放在一个根节点内，否则将影响路由切换动画效果

### 读取/写入登录token方法：
src/store/user.ts中的getToken、setToken、resetToken ，内部实现可根据实际项目改写

### 本项目中所有typescript数据结构定义，均保存在：
src/types/index.ts

## Recommended IDE Setup

- [VS Code](https://code.visualstudio.com/) + [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) (and disable Vetur) + [TypeScript Vue Plugin (Volar)](https://marketplace.visualstudio.com/items?itemName=Vue.vscode-typescript-vue-plugin).

## Type Support For `.vue` Imports in TS

TypeScript cannot handle type information for `.vue` imports by default, so we replace the `tsc` CLI with `vue-tsc` for type checking. In editors, we need [TypeScript Vue Plugin (Volar)](https://marketplace.visualstudio.com/items?itemName=Vue.vscode-typescript-vue-plugin) to make the TypeScript language service aware of `.vue` types.

If the standalone TypeScript plugin doesn't feel fast enough to you, Volar has also implemented a [Take Over Mode](https://github.com/johnsoncodehk/volar/discussions/471#discussioncomment-1361669) that is more performant. You can enable it by the following steps:

1. Disable the built-in TypeScript Extension
   1. Run `Extensions: Show Built-in Extensions` from VSCode's command palette
   2. Find `TypeScript and JavaScript Language Features`, right click and select `Disable (Workspace)`
2. Reload the VSCode window by running `Developer: Reload Window` from the command palette.