vue3+vite项目h5/web配置浏览器自适应适配（postcss-px-to-viewport-8-plugin）

注意，项目中不要写行内样式
vue3+vite项目配置适配H5主要安装一下两个插件：

1. amfe-flexible（主要用于动态设置根元素字体大小(rem)，以根据屏幕尺寸进行自适应布局）
2. postcss-px-to-viewport-8-plugin（将px单位转换为rem）

开始配置：
第一步、安装amfe-flexible插件

cnpm install amfe-flexible --save

第二步、在main.js中导入

import { createApp } from 'vue'
import './style.css'
import App from './App.vue'

import 'amfe-flexible'

createApp(App).mount('#app')

第三步、安装postcss-px-to-viewport-8-plus

cnpm install postcss-px-to-viewport-8-plugin --save // 测试不支持配置include

支持配置include

cnpm install postcss-px-to-viewport-8-with-include -S // 亲测可用

第四步、配置vite.config.ts文件

......
import postcsspxtoviewport from 'postcss-px-to-viewport-8-plugin'
......

export default defineConfig({
  plugins: [vue()],
  css: {
    postcss: {
      plugins: [
        postcsspxtoviewport({
          unitToConvert: 'px', // 需要转换的单位，默认为"px"，将 px 单位转换为视口单位的 (vw, vh, vmin, vmax)
          viewportWidth: file => {
            let num = 750; // 公司设计稿宽度
            // van组件是375
            if (file.indexOf('van') > 0) {
              num = 375;
            }
            return num;
          },
          // viewportWidth: 375, // 设计稿的视口宽度
          unitPrecision: 5, // 单位转换后保留的精度
          propList: ['*'], // 能转化为vw的属性列表
          viewportUnit: 'vw', // 希望使用的视口单位
          fontViewportUnit: 'vw', // 字体使用的视口单位
          selectorBlackList: ['ignore-'], // 需要忽略的CSS选择器，不会转为视口单位，使用原有的px等单位。
          minPixelValue: 1, // 设置最小的转换数值，如果为1的话，只有大于1的值会被转换
          mediaQuery: true, // 媒体查询里的单位是否需要转换单位
          replace: true, //  是否直接更换属性值，而不添加备用属性
          exclude: undefined, // 忽略某些文件夹下的文件或特定文件，例如 'node_modules' 下的文件
          include: undefined, // 如果设置了include，那将只有匹配到的文件才会被转换
          landscape: false, // 是否添加根据 landscapeWidth 生成的媒体查询条件 @media (orientation: landscape)
          landscapeUnit: 'vw', // 横屏时使用的单位
          landscapeWidth: 1920 // 横屏时使用的视口宽度
        })
      ]
    }
  }
})

本文参与了SegmentFault 思否写作挑战赛活动，欢迎正在阅读的你也加入。