ไฟล์ Config

เรา แนะนำอย่างยิ่งให้ใช้ไฟล์ uno.config.ts แบบเฉพาะ เพื่อกำหนดค่า UnoCSS ของคุณ เพื่อให้ได้ประสบการณ์ที่ดีที่สุดกับ IDE และการผสานรวมอื่นๆ

ไฟล์ config ที่มีฟีเจอร์ครบถ้วนมีลักษณะดังนี้:

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(),
  ],
})

เมื่อเทียบกับการกำหนดค่าแบบ inline ภายใน vite.config.ts หรือการกำหนดค่าเครื่องมืออื่นๆ ไฟล์ config แบบเฉพาะจะทำงานได้ดีกว่ากับ IDEs และการผสานรวม กับเครื่องมืออื่นๆ เช่น ESLint plugin นอกจากนี้ยังทำให้ HMR ทำงานได้ดีขึ้น

โดยค่าเริ่มต้น UnoCSS จะค้นหา uno.config.{js,ts,mjs,mts} หรือ unocss.config.{js,ts,mjs,mts} โดยอัตโนมัติในไดเรกทอรีรากของโปรเจกต์ของคุณ คุณยังสามารถระบุไฟล์ config ด้วยตนเองได้ ตัวอย่างเช่นใน Vite:

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

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

สำหรับรายการตัวเลือกการกำหนดค่าที่รองรับทั้งหมด โปรดดูที่ เอกสารอ้างอิงการกำหนดค่า