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 nextConfignext.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
experimental: {
useLightningcss: true, // 在 webpack 上禁用 PostCSS
},
}
module.exports = nextConfiglightningCssFeatures#
默认情况下,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 nextConfignext.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
experimental: {
useLightningcss: true,
lightningCssFeatures: {
// 始终转换这些特性,即使目标浏览器支持它们
include: ['light-dark', 'oklab-colors'],
// 从不转换这些特性,即使目标浏览器不支持它们
exclude: ['nesting'],
},
},
}
module.exports = nextConfig选项#
| 选项 | 类型 | 描述 |
|---|---|---|
include | string[] | 始终转换的特性,不考虑浏览器目标。 |
exclude | string[] | 从不转换的特性,即使浏览器目标需要它们。 |
可用特性#
各项特性:
| 特性名称 | 描述 |
|---|---|
nesting | CSS Nesting |
not-selector-list | 带多个选择器的 :not |
dir-selector | :dir() 选择器 |
lang-selector-list | 带多种语言的 :lang() |
is-selector | :is() 选择器 |
text-decoration-thickness-percent | text-decoration-thickness 中的百分比值 |
media-interval-syntax | 媒体查询区间语法 |
media-range-syntax | 媒体查询范围语法(width >= 600px) |
custom-media-queries | @custom-media 规则 |
clamp-function | clamp() 函数 |
color-function | color() 函数 |
oklab-colors | oklab() 和 oklch() 颜色 |
lab-colors | lab() 和 lch() 颜色 |
p3-colors | Display P3 颜色 |
hex-alpha-colors | 带 alpha 的 4 位和 8 位十六进制颜色 |
space-separated-color-notation | 空格分隔的颜色表示法(rgb(0 0 0)) |
font-family-system-ui | system-ui 字体族 |
double-position-gradients | 双位置渐变色标 |
vendor-prefixes | 带供应商前缀的属性和值 |
logical-properties | 逻辑属性和值 |
light-dark | light-dark() 颜色函数 |
组合组(用于一次启用多个特性的简写):
| 组名 | 包含 |
|---|---|
selectors | nesting、not-selector-list、dir-selector、lang-selector-list、is-selector |
media-queries | media-interval-syntax、media-range-syntax、custom-media-queries |
colors | color-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.0 | Turbopack 的默认 CSS 处理器从 @swc/css 改为 Lightning CSS。useLightningcss 在 Turbopack 上被忽略,并新增了旧的 experimental.turbo.useSwcCss 选项。 |