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

xiaok2024-04-09 18:01

使用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 单位进行适配，推荐使用以下两个工具：

postcss-pxtorem 是一款 PostCSS 插件，用于将 px 单位转化为 rem 单位
lib-flexible 用于设置 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" />