NNext.js 中文网 GitHub

如何在 Next.js 中配置 PostCSS

使用你自己的配置扩展 Next.js 添加的 PostCSS 配置和插件。

默认行为#

Next.js 使用 PostCSS 为其内置 CSS 支持编译 CSS。

开箱即用,无需任何配置,Next.js 会使用以下转换来编译 CSS:

默认情况下,CSS Grid 和自定义属性(CSS 变量)不会为 IE11 进行编译。

要为 IE11 编译 CSS Grid Layout,你可以在 CSS 文件顶部添加以下注释:

css
/* autoprefixer grid: autoplace */

你还可以通过使用下面(折叠)所示的配置来配置 autoprefixer,从而在整个项目中为 CSS Grid Layout 启用 IE11 支持。 有关更多信息,请参阅下方的“自定义插件”。

<details> <summary>点击查看启用 CSS Grid Layout 的配置</summary>

postcss.config.json
{
  "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 键,如下所示:

package.json
{
  "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 使用的默认配置:

postcss.config.json
{
  "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,当你希望根据环境有条件地包含插件时,这很有用:

postcss.config.js
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 工具,则必须改用可互操作的基于对象的格式:

js
module.exports = {
  plugins: {
    'postcss-flexbugs-fixes': {},
    'postcss-preset-env': {
      autoprefixer: {
        flexbox: 'no-2009',
      },
      stage: 3,
      features: {
        'custom-properties': false,
      },
    },
  },
}
Next.js 中文网