旧版兼容预设

旧版兼容性工具集合。

此预设不包含任何规则，它会对其他预设生成的 CSS 进行后处理。

默认情况下，所有选项均未启用，您需要显式地逐个启用它们。

源代码

安装

pnpm

pnpm add -D @unocss/preset-legacy-compat

yarn

yarn add -D @unocss/preset-legacy-compat

npm

npm install -D @unocss/preset-legacy-compat

bun

bun add -D @unocss/preset-legacy-compat

uno.config.ts

import presetLegacyCompat from '@unocss/preset-legacy-compat'
import { defineConfig } from 'unocss'

export default defineConfig({
  presets: [
    // ...other presets
    presetLegacyCompat({
      // options
      commaStyleColorFunction: true,
      legacyColorSpace: true
    }),
  ],
})

选项

commaStyleColorFunction

• 类型: boolean
• 默认值: false

将颜色函数（rgb() 和 hsl()）从空格分隔转换为逗号分隔，以提高与旧版浏览器的兼容性。恢复 UnoCSS v0.57.0 之前的旧行为，该版本在 #3221 中为了与 Tailwind CSS 保持一致而将其改为空格分隔。

示例如下：

• rgb(255 0 0) -> rgb(255, 0, 0)
• rgb(255 0 0 / 50%) -> rgba(255, 0, 0, 50%)
• hsl(0 100% 50% / 50%) -> hsla(0, 100%, 50%, 50%)

legacyColorSpace

• 类型: boolean
• 默认值: false

从生成的样式中移除 in oklch 和 in oklab 等颜色空间关键字。这有助于确保与不支持这些现代颜色空间的旧版浏览器兼容。

要启用此功能，请将 legacyColorSpace 选项设置为 true。