NNext.js 中文网 GitHub

useLightningcss

experimental

启用对 Lightning CSS 的实验性支持。

在 webpack 中使用 Lightning CSS 的实验性支持。Lightning CSS 是一个用 Rust 编写的快速 CSS 转换器和压缩器。

如果未设置此选项,webpack 上的 Next.js 默认使用 PostCSS 和 postcss-preset-env。

自 Next 14.2 起,Turbopack 默认使用 Lightning CSS。此配置选项对 Turbopack 没有影响。Turbopack 始终使用 Lightning CSS。

next.config.ts
import type { NextConfig } from 'next'

const nextConfig: NextConfig = {
  experimental: {
    useLightningcss: false, // 默认值,在 Turbopack 上被忽略
  },
}

export default nextConfig
next.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
  experimental: {
    useLightningcss: true, // 在 webpack 上禁用 PostCSS
  },
}

module.exports = nextConfig

lightningCssFeatures#

默认情况下,Lightning CSS 根据你的 browserslist 目标决定转换哪些 CSS 特性。lightningCssFeatures 选项允许你覆盖这一行为,强制某些特性始终转换(include)或从不转换(exclude),而不考虑浏览器支持情况。

这同时适用于 webpack(当启用 useLightningcss 时)和 Turbopack。

next.config.ts
import type { NextConfig } from 'next'

const nextConfig: NextConfig = {
  experimental: {
    useLightningcss: true,
    lightningCssFeatures: {
      // 始终转换这些特性,即使目标浏览器支持它们
      include: ['light-dark', 'oklab-colors'],
      // 从不转换这些特性,即使目标浏览器不支持它们
      exclude: ['nesting'],
    },
  },
}

export default nextConfig
next.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
  experimental: {
    useLightningcss: true,
    lightningCssFeatures: {
      // 始终转换这些特性,即使目标浏览器支持它们
      include: ['light-dark', 'oklab-colors'],
      // 从不转换这些特性,即使目标浏览器不支持它们
      exclude: ['nesting'],
    },
  },
}

module.exports = nextConfig

选项#

选项类型描述
includestring[]始终转换的特性,不考虑浏览器目标。
excludestring[]从不转换的特性,即使浏览器目标需要它们。

可用特性#

各项特性:

特性名称描述
nestingCSS Nesting
not-selector-list带多个选择器的 :not
dir-selector:dir() 选择器
lang-selector-list带多种语言的 :lang()
is-selector:is() 选择器
text-decoration-thickness-percenttext-decoration-thickness 中的百分比值
media-interval-syntax媒体查询区间语法
media-range-syntax媒体查询范围语法(width >= 600px)
custom-media-queries@custom-media 规则
clamp-functionclamp() 函数
color-functioncolor() 函数
oklab-colorsoklab() 和 oklch() 颜色
lab-colorslab() 和 lch() 颜色
p3-colorsDisplay P3 颜色
hex-alpha-colors带 alpha 的 4 位和 8 位十六进制颜色
space-separated-color-notation空格分隔的颜色表示法(rgb(0 0 0))
font-family-system-uisystem-ui 字体族
double-position-gradients双位置渐变色标
vendor-prefixes带供应商前缀的属性和值
logical-properties逻辑属性和值
light-darklight-dark() 颜色函数

组合组(用于一次启用多个特性的简写):

组名包含
selectorsnesting、not-selector-list、dir-selector、lang-selector-list、is-selector
media-queriesmedia-interval-syntax、media-range-syntax、custom-media-queries
colorscolor-function、oklab-colors、lab-colors、p3-colors、hex-alpha-colors、space-separated-color-notation、light-dark

版本历史#

版本变更
16.2.0新增 lightningCssFeatures。
15.1.0移除了对 Turbopack 中 useSwcCss 的支持。
14.2.0Turbopack 的默认 CSS 处理器从 @swc/css 改为 Lightning CSS。useLightningcss 在 Turbopack 上被忽略,并新增了旧的 experimental.turbo.useSwcCss 选项。
Next.js 中文网