Skip to content

Tema

UnoCSS podpira tudi sistem tem, s katerim ste morda seznanjeni v Tailwind CSS / Windi CSS. Na ravni uporabnika lahko določite lastnost theme v vaši konfiguraciji in bo globoko združena s privzeto temo.

Uporaba

ts
theme: {
  // ...
  colors: {
    veryCool: '#0000ff', // class="text-very-cool"
    brand: {
      primary: 'hsl(var(--hue, 217) 78% 51%)', //class="bg-brand-primary"
      DEFAULT: '#942192' //class="bg-brand"
    },
  },
}

TIP

Med procesom parsiranja bo theme vedno obstajal v context.

Uporaba v rules

Za uporabo teme v pravilih:

ts
rules: [
  [/^text-(.*)$/, ([, c], { theme }) => {
    if (theme.colors[c])
      return { color: theme.colors[c] }
  }],
]

Uporaba v variants

Za uporabo teme v variantah:

ts
variants: [
  {
    name: 'variant-name',
    match(matcher, { theme }) {
      // ...
    },
  },
]

Uporaba v shortcuts

Za uporabo teme v dinamičnih bližnjicah:

ts
shortcuts: [
  [/^badge-(.*)$/, ([, c], { theme }) => {
    if (Object.keys(theme.colors).includes(c))
      return `bg-${c}4:10 text-${c}5 rounded`
  }],
]

Prelomne točke

WARNING

Ko je podan prilagojen predmet breakpoints, bo privzeti prepisan namesto združevanja.

Z naslednjim primerom boste lahko uporabili le varianti prelomnih točk sm: in md::

ts
theme: {
  // ...
  breakpoints: {
    sm: '320px',
    md: '640px',
  },
}

Če želite podedovati original temo prelomnih točk, lahko uporabite extendTheme:

ts
extendTheme: (theme) => {
  return {
    ...theme,
    breakpoints: {
      ...theme.breakpoints,
      sm: '320px',
      md: '640px',
    },
  }
}

INFO

verticalBreakpoints je enako kot breakpoints, vendar za navpično postavitev.

Poleg tega bomo razvrstili točke zaslona po velikosti (ista enota). Za točke zaslona v različnih enotah, da se izognete napakam, uporabite enotne enote v konfiguraciji.

ts
theme: {
  // ...
  breakpoints: {
    sm: '320px',
    // Ker uno ne podpira primerjalnega razvrščanja različnih velikosti enot, pretvorite v isto enoto.
    // md: '40rem',
    md: `${40 * 16}px`,
    lg: '960px',
  },
}

ExtendTheme

ExtendTheme vam omogoča urejanje globoko združene teme za pridobitev popolnega predmeta teme.

Prilagojene funkcije mutirajo predmet teme.

ts
extendTheme: (theme) => {
  theme.colors.veryCool = '#0000ff' // class="text-very-cool"
  theme.colors.brand = {
    primary: 'hsl(var(--hue, 217) 78% 51%)', // class="bg-brand-primary"
  }
}

Mogoče je tudi vrniti nov predmet teme za popolno zamenjavo izvirnika.

ts
extendTheme: (theme) => {
  return {
    ...theme,
    colors: {
      ...theme.colors,
      veryCool: '#0000ff', // class="text-very-cool"
      brand: {
        primary: 'hsl(var(--hue, 217) 78% 51%)', // class="bg-brand-primary"
      },
    },
  }
}

Released under the MIT License.