vite+vant4+vue3搭建一个移动端h5项目并进行rem适配

使用vite新建vue项目

sql 复制代码
npm create vite@latest

通过 npm 安装 vant

在现有项目中使用 Vant 时,可以通过 npm 进行安装:

css 复制代码
# Vue 3 项目,安装最新版 Vant
npm i vant

# Vue 2 项目,安装 Vant 2
npm i vant@latest-v2

常规用法

1、引入vant

javascript 复制代码
import { createApp } from 'vue';
// 1. 引入你需要的组件
import { Button } from 'vant';
// 2. 引入组件样式
import 'vant/lib/index.css';

const app = createApp();

// 3. 注册你需要的组件
app.use(Button);

2、使用vant组件和 API

完成以上步骤,就可以直接在模板中使用 Vant 组件了

xml 复制代码
<template>
  <van-button type="primary" />
</template>

不同手机机型的适配

这里我们采用 "Rem布局适配"

官方文档:vant-contrib.gitee.io/vant/#/zh-C...

如果需要使用 rem 单位进行适配,推荐使用以下两个工具:

css 复制代码
npm install postcss postcss-pxtorem --save-dev
css 复制代码
npm i -S amfe-flexible

PostCSS 示例配置(在项目根目录下新建一个postcss.config.cjs)

下面提供了一份基本的 PostCSS 示例配置,可以在此配置的基础上根据项目需求进行修改。

java 复制代码
// postcss.config.cjs
module.exports = {
  plugins: {
    'postcss-pxtorem': {
      rootValue: 37.5,
      propList: ['*'],
    },
  },
};

Tips: 在配置 postcss-pxtorem 时,同样应避免 ignore node_modules 目录,否则会导致 Vant 样式无法被编译。

其他设计稿尺寸

如果设计稿的尺寸不是 375,而是 750 或其他大小,可以将 rootValue 配置调整为:

javascript 复制代码
// postcss.config.cjs
module.exports = {
  plugins: {
    // postcss-pxtorem 插件的版本需要 >= 5.0.0
    'postcss-pxtorem': {
      rootValue({ file }) {
        return file.indexOf('vant') !== -1 ? 37.5 : 75;
      },
      propList: ['*'],
    },
  },
};

main.js中引入amfe-flexible

arduino 复制代码
import 'amfe-flexible'

在index.html中加上视口标签

ini 复制代码
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0, viewport-fit=cover" />
相关推荐
suedar6 分钟前
React 16 + TDesign Table 卡死问题深度复盘
前端
浩星44 分钟前
「Vue3 + Cesium 最佳实践」完整工程化方案
前端·javascript·vue.js
小李子呢02111 小时前
前端八股Vue(5)---v-if和v-show
前端·javascript·vue.js
yuki_uix1 小时前
跨域与安全:CORS、HTTPS 与浏览器安全机制
前端·面试
用户3153247795451 小时前
React19项目中 FormEdit / FormEditModal 组件封装设计说明
前端·react.js
陆枫Larry1 小时前
Git 合并冲突实战:`git pull` 失败与 `pull.ff=only` 的那些事
前端
江南月1 小时前
让智能体边想边做:从 0 理解 ReActAgent 的工作方式
前端·人工智能
袋鱼不重1 小时前
Hermes Agent 安装与实战:从安装到与 OpenClaw 全方位对比
前端·后端·ai编程
汉秋1 小时前
iOS 自定义 UICollectionView 拼图布局 + 布局切换动画实践
前端