Дока · Темизация

Тема в три уровня

Все значения дизайн-токенов живут в CSS-переменных --sk-*. Утилитарные классы компонентов ссылаются на них через theme-мэппинг (TW3 — плагин, TW4 — @theme). Смена скина — правка переменных, без пересборки.

Механика #

Класс bg-primary-500 компилируется в background-color: var(--sk-primary-500). Значения переменных — это API пака: имена менять нельзя, значения — сколько угодно.

css
/* TW4: @theme в theme.css пака */
@theme static {
  --color-primary-500: var(--sk-primary-500);
}
/* TW3: theme.extend плагина */
primary: { 500: 'var(--sk-primary-500)' }

Уровень 1 — словари внутри компонентов #

У каждого компонента есть словари вариантов и размеров (variant, size). Это дефолтная шкурка пака — то, что видно без всякой настройки.

Уровень 2 — глобальная тема потребителя #

Опция модуля theme переопределяет токен-классы и словари по компонентам. Значение слота заменяет дефолт целиком (без слияния); доступно в рантайме через useSkTheme().

ts
// nuxt.config.ts — тема уровня 2
export default defineNuxtConfig({
  modules: ['skob-ui'],
  skobUi: {
    theme: {
      skButton: {
        slots:   { root: 'rounded-full px-6' },
        variants: { danger: 'bg-primary-900 text-text-primary' },
        sizes:    { lg: 'h-12 px-8' }
      }
    }
  }
})

Уровень 3 — :ui-проп при вызове #

Точечная правка на месте вызова: слот-строки мержатся через tailwind-merge — конфликтующие утилиты разрешаются в пользу :ui. Обычный class мержится поверх тоже.

vue
<SkButton :ui="{ root: 'w-full rounded-none' }">
  Во всю ширину, без радиуса
</SkButton>

<!-- tailwind-merge: bg-card победит bg-primary-500 (одна группа) -->
<SkButton class="bg-card">Ок</SkButton>

Мульти-темы #

Пак не поставляет готовых скинов, но механизм заложен: переопредели переменные в блоке по атрибуту data-sk-theme на <html> или любом контейнере. Переключатель в шапке этого сайта — три таких блока, живьём.

css
/* свой скин у потребителя (пример — тёмный) */
:root[data-sk-theme="dark"] {
  --sk-bg: #17161A;
  --sk-card: #1F1E24;
  --sk-text-primary: #F2F0F5;
}

/* переключение — атрибут на <html>, без пересборки */

Живой стенд токенов #

Значения читаются из getComputedStyle и пересчитываются при смене темы — попробуй переключатель в шапке.

Палитра primary

Поверхности

bg
bg-warm
card
sidebar

Значения

--sk-bg—
--sk-bg-warm—
--sk-card—
--sk-sidebar—
--sk-text-primary—
--sk-text-secondary—
--sk-text-muted—
--sk-border—
--sk-divider—
--sk-radius—
--sk-font-sans—