使用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" />