搭建一个vue3+vant4+vite4+pinia 的移动端h5模板_vue3+vant4开源模板

效果图

项目的创建和组件库的安装

1. 项目创建

pnpm create vite vue3-vant4-vite-pinia-pro-h5
1

注意： node版本控制在 18+， 可以通过nvm来管理本地的node版本，具体可以看这篇文章 nvm的简单使用

2. vant-ui库的安装【这里安装的是 ^4.6.0 版本的】

pnpm add vant
1

注意: 具体的一些配置这里就不介绍了，可以去 vant-ui官网 查看详细的安装和配置

项目目录预览

就按上面的项目目录 对主要的文件就行简单说明。

1. api 文件目录 【存放项目中所有的接口】

import request from "@/utils/request";

// banner 列表
export const getBannerList = (params) => request.get(`/goodsBanner/list`, { params });
// 菜单列表
export const getMenuList = (params) => request.get(`/homeMenu/getList`, { params });
1
2
3
4
5
6

2. assets 文件目录【存放项目中的一些静态文件: icon、svg等】
3. components 文件目录【存放项目中的组件】
   

简要说明：
globalComponents ： 全局组件，已经全局注册 【页面使用不需要引入】（一般很常用的组件放这里）
localComponents ： 本地组件， 没有全局注册 【页面使用需要手动引入】（一般不常用的可以放这里）
registerGlobComp： 组件注册文件，注册全局组件和vant-ui组件【vant-ui组件我这里用的是按需引入，需要手动引入】，如何想全局引入vant-ui组件，可以去 vant-ui官网 查看

4. directives文件目录【存放自定义的vue指定】，以下是一个自定义的旋转指令（v-rotate）

• 代码

const rotateDirective = {
  /**
   * mounted 钩子函数，在绑定元素的父组件及他自己的所有子节点都挂载完成后调用
   * el: 指令绑定到的元素。这可以用于直接操作 DOM。
   * value: 传给指令的值，也就是我们要 copy 的值
   */
  mounted(el, { value }) {
    // console.log("value==:", value, typeof value);
    el.$value = value; // 用一个全局属性来存传进来的值，因为这个值在别的钩子函数里还会用到
    // el.className = 'v-rotate'
    el.classList.add("v-rotate");
    if (typeof value === "undefined") return;
    el.style.display = value ? "block" : "none";
  },
  // 在绑定元素的父组件及他自己的所有子节点都更新后调用
  updated(el, { value }) {
    // console.log("更新触发", value);
    if (typeof value === "undefined") return;
    el.style.display = value ? "block" : "none";
  },
  // 指令与元素解绑后，移除事件绑定
  unmounted(el) {
    el.classList.remove("v-rotate");
  },
};

export function setupRotateDirective(app) {
  app.directive("rotate", rotateDirective);
}

export default rotateDirective;

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

• 具体使用 【可以去本项目的 src/views/mine/index.vue 文件查看】

 <SvgIcon v-rotate icon-class="loading" />
1

5. hooks文件目录 【钩子函数】，以下是封装的是一个loading 钩子

• 代码

import { showLoadingToast } from "vant";
import { onBeforeUnmount } from "vue";

export function useLoading() {
  let toast = null;
  const startLoading = () => {
    toast = showLoadingToast({
      duration: 0,
      forbidClick: true,
      message: "加载中...",
      overlay: true,
    });
  };
  const stopLoading = () => {
    toast && toast.close();
  };

  onBeforeUnmount(stopLoading);

  return { startLoading, stopLoading };
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

• 具体使用 【可以去本项目的 src/views/index/index.vue 文件查看】

// 引入
import { useLoading } from '@/hooks/useLoading'
// 导出
const { startLoading, stopLoading } = useLoading()
 //  接口调用
  startLoading()
  getBannerList().then((res) => {
	    stopLoading()
	    console.log("数据：", res);
	    const list = res.result || [];
	    list.map(
	    (v) => (v.url = v.url.includes("http") ? v.url : `http://${v.url}`)
	  );
  	bannerList.value = list;
  });
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

6. router 文件目录 【存放页面的路由】
7. store 文件目录【这里是项目的全局存储-用的pinia】

import { createPinia, defineStore } from "pinia";
// 引入持久化插件
import piniaPluginPersistedstate from "pinia-plugin-persistedstate";
// 实例化pinia
export const store = createPinia();
// 使用持久化存储插件
store.use(piniaPluginPersistedstate);

// 系统统一存储
export const useAppStore = defineStore("app", {
  state: () => ({
    appName: "我是app名称",
  }),
  actions: {
    // 设置app名称
    setAppName(data) {
      this.appName = data;
    },
  },
  persist: {
		storage: localStorage, //default localStorage
	},
});
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

8. styles 文件目录【这里存放的项目中一些初始化css样式、组件库统一css样式修改、全局css变量等样式】
9. utils 文件目录 【存放一写工具函数：request.js 请求封装、wxJssdkTools.js 微信jssdk封装等】
10. views 文件目录【存放页面的文件】
11. .env .env.development .env.production 【三个项目配置文件：主要用于全局的配置，以及打包环境的配置】
12. postcss.config.cjs 文件【PostCSS 示例配置】
13. README.md 文件 【项目搭建过程中一些常用组件、方法的简单说明和使用】
14. vite.config.js 文件【vite的一些相关配置】

源码地址和下载

代码仓库地址： Gitee | Github 或者直接复制下面的链接 直接下载代码

• Gitee 远程仓库下载链接

https://gitee.com/junfeng535/vue3-vant4-vite-pinia-pro-h5.git
1

• Github 远程仓库下载链接

https://github.com/junfeng-git/vue3-vant4-vite-pinia-pro-h5.git
1

其他一些页面截图