如何在 Next.js 中配置 PostCSS
使用你自己的配置扩展 Next.js 添加的 PostCSS 配置和插件。
默认行为#
Next.js 使用 PostCSS 为其内置 CSS 支持编译 CSS。
开箱即用,无需任何配置,Next.js 会使用以下转换来编译 CSS:
- Autoprefixer 会自动为 CSS 规则添加浏览器厂商前缀(可回溯到 IE11)。
- 修正跨浏览器 Flexbox 缺陷,使其行为符合规范。
- 新的 CSS 特性会自动编译,以兼容 Internet Explorer 11:
默认情况下,CSS Grid 和自定义属性(CSS 变量)不会为 IE11 进行编译。
要为 IE11 编译 CSS Grid Layout,你可以在 CSS 文件顶部添加以下注释:
/* autoprefixer grid: autoplace */你还可以通过使用下面(折叠)所示的配置来配置 autoprefixer,从而在整个项目中为 CSS Grid Layout 启用 IE11 支持。 有关更多信息,请参阅下方的“自定义插件”。
<details> <summary>点击查看启用 CSS Grid Layout 的配置</summary>
{
"plugins": [
"postcss-flexbugs-fixes",
[
"postcss-preset-env",
{
"autoprefixer": {
"flexbox": "no-2009",
"grid": "autoplace"
},
"stage": 3,
"features": {
"custom-properties": false
}
}
]
]
}</details>
CSS 变量不会被编译,因为无法安全地做到这一点。 如果必须使用变量,可以考虑使用类似 Sass 变量的方式,它们会被 Sass 编译掉。
自定义目标浏览器#
Next.js 允许你通过 Browserslist 配置目标浏览器(针对 Autoprefixer 和编译后的 css 特性)。
要自定义 browserslist,请在你的 package.json 中创建一个 browserslist 键,如下所示:
{
"browserslist": [">0.3%", "not dead", "not op_mini all"]
}你可以使用 browsersl.ist 工具来查看你所针对的浏览器。
CSS Modules#
支持 CSS Modules 无需任何配置。要为某个文件启用 CSS Modules,请将文件重命名为使用 .module.css 扩展名。
你可以在这里了解更多关于 Next.js 的 CSS Module 支持。
自定义插件#
警告:当你定义自定义 PostCSS 配置文件时,Next.js 会完全禁用默认行为。 请务必手动配置你需要编译的所有特性,包括 Autoprefixer。 你还需要手动安装自定义配置中包含的所有插件,即
npm install postcss-flexbugs-fixes postcss-preset-env。
要自定义 PostCSS 配置,请在项目根目录创建一个 postcss.config.json 文件。
这是 Next.js 使用的默认配置:
{
"plugins": [
"postcss-flexbugs-fixes",
[
"postcss-preset-env",
{
"autoprefixer": {
"flexbox": "no-2009"
},
"stage": 3,
"features": {
"custom-properties": false
}
}
]
]
}小知识:Next.js 还允许将文件命名为
.postcssrc.json,或者从package.json中的postcss键读取配置。
也可以使用 postcss.config.js 文件来配置 PostCSS,当你希望根据环境有条件地包含插件时,这很有用:
module.exports = {
plugins:
process.env.NODE_ENV === 'production'
? [
'postcss-flexbugs-fixes',
[
'postcss-preset-env',
{
autoprefixer: {
flexbox: 'no-2009',
},
stage: 3,
features: {
'custom-properties': false,
},
},
],
]
: [
// 在开发环境中不进行任何转换
],
}小知识:Next.js 还允许将文件命名为
.postcssrc.js。
不要使用 require() 来导入 PostCSS 插件。插件必须以字符串形式提供。
小知识:如果你的
postcss.config.js需要在同一项目中支持其他非 Next.js 工具,则必须改用可互操作的基于对象的格式:jsmodule.exports = { plugins: { 'postcss-flexbugs-fixes': {}, 'postcss-preset-env': { autoprefixer: { flexbox: 'no-2009', }, stage: 3, features: { 'custom-properties': false, }, }, }, }