配置文件
我們強烈建議使用專用的uno.config.ts
文件來配置您的UnoCSS,以便獲得IDE和其他集成的最佳體驗。
一個完整的配置文件如下所示:
ts
// uno.config.ts
import {
defineConfig,
presetAttributify,
presetIcons,
presetTypography,
presetUno,
presetWebFonts,
transformerDirectives,
transformerVariantGroup
} from 'unocss'
export default defineConfig({
shortcuts: [
// ...
],
theme: {
colors: {
// ...
}
},
presets: [
presetUno(),
presetAttributify(),
presetIcons(),
presetTypography(),
presetWebFonts({
fonts: {
// ...
},
}),
],
transformers: [
transformerDirectives(),
transformerVariantGroup(),
],
})
與`vite.config.ts或其他工具配置中的內聯配置相比,專用配置文件將更好地與IDEs和集成以及ESLint插件等其他工具配合使用,此外還能使HMR更好地工作。
默認情況下,UnoCSS將自動查找uno.config.{js,ts,mjs,mts}
或`unocss.config.{js,ts,mjs,mts}``在項目的根目錄中。您也可以手動指定配置文件,例如在Vite中:
ts
// vite.config.ts
import { defineConfig } from 'vite'
import UnoCSS from 'unocss/vite'
export default defineConfig({
plugins: [
UnoCSS({
configFile: '../my-uno.config.ts',
}),
],
})
有關支持的配置選項的完整列表,請參閱配置參考。