vite使用postcss-px-to-viewport 插件

在 Vite 工程中,你可以使用 postcss-px-to-viewport 插件来自动将 CSS 中的像素单位转换为视口单位(vw、vh 等),从而简化响应式布局的设计。以下是如何在 Vite 工程中配置和使用 postcss-px-to-viewport 插件的步骤:

1. 安装依赖

首先,你需要安装 postcss 和 postcss-px-to-viewport 这两个依赖。你可以使用 npm 或 yarn 来安装它们:

bash 复制代码
npm install postcss postcss-px-to-viewport --save-dev

或

bash 复制代码
yarn add postcss postcss-px-to-viewport --dev

2. 配置 PostCSS

在 Vite 工程中,PostCSS 的配置通常是在 vite.config.js 或 vite.config.ts 文件中进行的。你需要在这个文件中添加 PostCSS 的配置,并引入 postcss-px-to-viewport 插件。

以下是一个示例配置:

javascript 复制代码
//vite.config.js
import { defineConfig } from 'vite';
//引入postcss-px-to-viewport
import postcss from 'postcss';
import pxToViewport from 'postcss-px-to-viewport';

export default defineConfig({
	css: {
		postcss: {
			plugins: [
				pxToViewport({
					unitToConvert: 'px', // 需要转换的单位,默认为'px'
					viewportWidth: 375,  // 基准视口宽度(对应设计稿的宽度)
					viewportHeight: 667, // 视口高度(可选)
					unitPrecision: 5,    // px转换为vw的小数位数(很多情况下用5)
					propList: ['*'],     // 指定需要转换的属性,'*'表示全部转换,'font-size'表示只转换font-size属性
					viewportUnit: 'vmin',  // 指定需要转换成的视口单位,默认vw
					fontViewportUnit: 'vmin', // 字体使用的视口单位,默认vw
					selectorBlackList: [], // 指定不转换为视口单位的类名,用逗号隔开
					minPixelValue: 1,    // 小于或等于1px不转换为视口单位,默认1
					mediaQuery: false,   // 允许在媒体查询中转换px
					replace: true,       // 是否直接替换而不是添加后缀
					exclude: /node_modules/ // 设置忽略文件,用正则表达式匹配路径
				}),
			]
		}
	},
});

3. 编写 CSS

现在,你可以在你的 CSS 文件中使用像素单位了,postcss-px-to-viewport 插件会在构建时自动将它们转换为视口单位。例如:

css 复制代码
/* src/styles/main.css */
body {
  font-size: 16px; /* 这将被转换为vw单位 */
}

.container {
  width: 375px; /* 这将被转换为vw单位,具体数值取决于你的viewportWidth配置 */
}

4. 运行 Vite

最后,你可以运行 Vite 来构建或开发你的项目。Vite 会在构建过程中自动应用 PostCSS 的配置,并转换你的 CSS 文件中的像素单位。

bash 复制代码
npm run dev

或

bash 复制代码
yarn dev

如果你想要构建生产版本的代码,可以使用以下命令:

bash 复制代码
npm run build

或

bash 复制代码
yarn build

现在,你的 Vite 工程应该已经成功配置了 postcss-px-to-viewport 插件,并且可以在 CSS 中使用像素单位,它们会在构建时被自动转换为视口单位。

相关推荐
徐小夕4 分钟前
JitKnow知识库4.8发布:本体+知识图谱检索引擎,让AI回答不再“一本正经地胡说八道”
前端·vue.js·github
智迁4 分钟前
MySQL 到 Kingbase 实时同步:从 Docker 部署到增删改验证
前端·后端
tryCbest32 分钟前
Vue3——第 11 篇:组合式 API(上)——setup 与响应式 API 深度解析
前端·javascript·vue.js
tryCbest1 小时前
Vue3——第 13 篇:计算属性与侦听器——computed 与 watch 的进化
前端·javascript·vue.js
怒放的生命19911 小时前
本地用 pnpm 省磁盘,团队继续用 npm:极简实践
前端·npm·node.js
believed_breadfruit2 小时前
我开源了一个HTML 分页导出工具,解决了复杂页面的内容截断、跨页错乱和长文档白屏问题
前端·javascript·github
福狼2 小时前
从“网墙”到柔性曲面:一次 WebGPU 波浪的逆向分析与重建
前端·逆向
宝哥聊编程2 小时前
主流 Agent 平台对比:Coze、Dify、飞书、扣子、OpenClaw 落地实操手册
前端·人工智能·飞书
时间的情敌2 小时前
Vue3 + Cesium 实战:本地上传 GLB 模型、模型上叠加 GLB、点击控制透明度
前端·vue.js·cesium
拖孩2 小时前
流量主门槛从 500 降到 100,我的小程序上线 18 小时够到了线
前端·后端·微信小程序