Дока · Темизация
Тема в три уровня
Все значения дизайн-токенов живут в CSS-переменных --sk-*. Утилитарные классы компонентов ссылаются на них через theme-мэппинг (TW3 — плагин, TW4 — @theme). Смена скина — правка переменных, без пересборки.
Механика #
Класс bg-primary-500 компилируется в background-color: var(--sk-primary-500). Значения переменных — это API пака: имена менять нельзя, значения — сколько угодно.
/* 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().
// 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 мержится поверх тоже.
<SkButton :ui="{ root: 'w-full rounded-none' }">
Во всю ширину, без радиуса
</SkButton>
<!-- tailwind-merge: bg-card победит bg-primary-500 (одна группа) -->
<SkButton class="bg-card">Ок</SkButton>Мульти-темы #
Пак не поставляет готовых скинов, но механизм заложен: переопредели переменные в блоке по атрибуту data-sk-theme на <html> или любом контейнере. Переключатель в шапке этого сайта — три таких блока, живьём.
/* свой скин у потребителя (пример — тёмный) */
:root[data-sk-theme="dark"] {
--sk-bg: #17161A;
--sk-card: #1F1E24;
--sk-text-primary: #F2F0F5;
}
/* переключение — атрибут на <html>, без пересборки */Живой стенд токенов #
Значения читаются из getComputedStyle и пересчитываются при смене темы — попробуй переключатель в шапке.
Палитра primary
Поверхности
Значения
| --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 | — |