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

效果图

图片1 图片2
图片1 图片2

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

  1. 项目创建
pnpm create vite vue3-vant4-vite-pinia-pro-h5

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

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

注意: 具体的一些配置这里就不介绍了,可以去 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. assets 文件目录【存放项目中的一些静态文件: icon、svg等】
  2. components 文件目录【存放项目中的组件】
    在这里插入图片描述

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

  1. 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;

  • 具体使用 【可以去本项目的 src/views/mine/index.vue 文件查看】
 <SvgIcon v-rotate icon-class="loading" />
  1. 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 };
}

  • 具体使用 【可以去本项目的 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. router 文件目录 【存放页面的路由】
  2. 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. styles 文件目录【这里存放的项目中一些初始化css样式、组件库统一css样式修改、全局css变量等样式】
  2. utils 文件目录 【存放一写工具函数:request.js 请求封装、wxJssdkTools.js 微信jssdk封装等】
  3. views 文件目录【存放页面的文件】
  4. .env .env.development .env.production 【三个项目配置文件:主要用于全局的配置,以及打包环境的配置】
  5. postcss.config.cjs 文件【PostCSS 示例配置】
  6. README.md 文件 【项目搭建过程中一些常用组件、方法的简单说明和使用】
  7. vite.config.js 文件【vite的一些相关配置】

源码地址和下载

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

  • Gitee 远程仓库下载链接
https://gitee.com/junfeng535/vue3-vant4-vite-pinia-pro-h5.git
  • Github 远程仓库下载链接
https://github.com/junfeng-git/vue3-vant4-vite-pinia-pro-h5.git

其他一些页面截图

请添加图片描述

请添加图片描述
请添加图片描述

相关推荐

  1. vue3+vant自动导入+pina+vite+js+pnpm项目框架

    2024-05-12 03:06:01       35 阅读
  2. Vue3+Ts+Vite2+Pinia 开发框架

    2024-05-12 03:06:01       46 阅读

最近更新

  1. docker php8.1+nginx base 镜像 dockerfile 配置

    2024-05-12 03:06:01       94 阅读
  2. Could not load dynamic library ‘cudart64_100.dll‘

    2024-05-12 03:06:01       100 阅读
  3. 在Django里面运行非项目文件

    2024-05-12 03:06:01       82 阅读
  4. Python语言-面向对象

    2024-05-12 03:06:01       91 阅读

热门阅读

  1. 线段树(以区间和为例)

    2024-05-12 03:06:01       36 阅读
  2. python的deap库使用记录

    2024-05-12 03:06:01       31 阅读
  3. AI绘画已如此厉害,为何我们仍需学习绘画?

    2024-05-12 03:06:01       35 阅读
  4. 相机标定详解

    2024-05-12 03:06:01       30 阅读
  5. C++面向对象

    2024-05-12 03:06:01       33 阅读
  6. spring-boot-starter-validation校验框架

    2024-05-12 03:06:01       32 阅读