Konfigurationsfil

Vi rekommenderar starkt att använda en dedikerad uno.config.ts-fil för att konfigurera din UnoCSS, för att få den bästa upplevelsen med IDE:n och andra integrationer.

En fullfjädrad konfigurationsfil ser ut så här:

import {
  defineConfig,
  presetAttributify,
  presetIcons,
  presetTypography,
  presetWebFonts,
  presetWind3,
  transformerDirectives,
  transformerVariantGroup
} from 'unocss'

export default defineConfig({
  shortcuts: [
    // ...
  ],
  theme: {
    colors: {
      // ...
    }
  },
  presets: [
    presetWind3(),
    presetAttributify(),
    presetIcons(),
    presetTypography(),
    presetWebFonts({
      fonts: {
        // ...
      },
    }),
  ],
  transformers: [
    transformerDirectives(),
    transformerVariantGroup(),
  ],
})

Jämfört med inline-konfiguration i din vite.config.ts eller andra verktygskonfigurationer, kommer den dedikerade konfigurationsfilen att fungera bättre med IDE:n och integrationer, med andra verktyg som ESLint-plugin, dessutom fungerar HMR bättre.

Som standard kommer UnoCSS automatiskt att leta efter uno.config.{js,ts,mjs,mts} eller unocss.config.{js,ts,mjs,mts} i rotkatalogen för ditt projekt. Du kan också ange konfigurationsfilen manuellt, till exempel i Vite:

import UnoCSS from 'unocss/vite'
import { defineConfig } from 'vite'

export default defineConfig({
  plugins: [
    UnoCSS({
      configFile: '../my-uno.config.ts',
    }),
  ],
})

För en fullständig lista över konfigurationsalternativ, se Konfigurationsreferens.

Konfigurationsfil ​

Konfigurationsfil