Тематика

Использование переменных CSS и токенов темы.

Хотите создать свою тему визуально? Используйте buridan/create для предварительного просмотра цветов, радиуса и шрифтов, а затем создайте набор настроек для своего проекта.

Мы используем и рекомендуем переменные CSS для оформления тем. Этот подход предоставляет токены семантического проектирования, такие как background, foreground и primary, на которые компоненты полагаются по умолчанию. Вы можете настроить внешний вид своего приложения, переопределив эти токены в CSS, без необходимости изменять классы на уровне компонента.

rx.el.div(class_name="bg-background text-foreground")

Попутный ветер V4

Мы рекомендуем использовать Tailwind V4 в вашем приложении Reflex, поскольку это позволяет лучше использовать синтаксис и позволяет избежать дублирования кодов. Использование Tailwind V4 также позволяет нам обойти расширение rxconfig.py соответствующими токенами CSS, используя синтаксис @theme inline.

Базовая настройка Tailwind V4 в Reflex может выглядеть следующим образом:

@theme inline {
  --color-background: var(--background);
  --color-foreground: var(--foreground);
}

:root {
  --background: oklch(1 0 0);
  --foreground: oklch(0.145 0 0);
}

.dark {
  --background: oklch(0.145 0 0);
  --foreground: oklch(0.985 0 0);
}

Используя @theme inline, мы теперь имеем доступ к этим токенам непосредственно внутри любого компонента.

Однако некоторые пакеты Tailwind обрабатываются как файлы JavaScript, например @tailwind/typography, и такие пакеты необходимо добавлять непосредственно в rxconfig.py.

import reflex as rx
from reflex.plugins.shared_tailwind import TailwindConfig

config = rx.Config(
    ...,
    plugins=[
        rx.plugins.TailwindV4Plugin(
            config=TailwindConfig(plugins=["@tailwindcss/typography"])
        ),
    ],
)

Наконец, обязательно извлеките файлы CSS, в которых определены ваши токены, в вашем экземпляре rx.App.

app = rx.App(stylesheets=["globals.css"])

Tailwind сопоставляет эти токены с такими утилитами, как bg-background, text-foreground, border-border и rounded-lg. Темный режим работает путем переопределения одних и тех же токенов внутри селектора .dark.

Тематические жетоны

Эти токены находятся в вашем CSS-файле в разделах :root и .dark.

Токен Что он контролирует Используется
background / foreground Фон приложения и цвет текста по умолчанию. Оболочка страницы, разделы страницы и текст по умолчанию.
card / card-foreground Возвышающиеся поверхности и содержимое внутри них. Card, панели мониторинга, панели настроек.
popover / popover-foreground Плавающие поверхности и содержимое внутри них. Popover, DropdownMenu, ContextMenu и другие наложения.
primary / primary-foreground Акцентные действия и поверхности бренда. Button по умолчанию, выбранные штаты, значки и активные акценты.
secondary / secondary-foreground Действия и опорные поверхности с меньшим акцентом. Вторичные кнопки, второстепенные значки и вспомогательный пользовательский интерфейс.
muted / muted-foreground Тонкие поверхности и содержание с меньшим акцентом. Описания, заполнители, пустые состояния, вспомогательный текст и приглушенные поверхности.
accent / accent-foreground Интерактивное наведение, фокус и активные поверхности. Призрачные кнопки, состояния выделения меню, наведенные строки и выбранные элементы.
destructive Деструктивные действия и акцент на ошибках. Деструктивные кнопки, недопустимые состояния и деструктивные пункты меню.
border Границы и разделители по умолчанию. Карточки, меню, таблицы, разделители и разделители макета.
input Границы контроля формы и обработка входной поверхности. Input, Textarea, Select и элементы управления в стиле структуры.
ring Кольца и контуры фокусировки. Кнопки, поля ввода, флажки, меню и другие элементы управления, на которых можно фокусироваться.
chart-1 ... chart-5 Палитра диаграммы по умолчанию. Диаграммы и блоки информационной панели на основе диаграмм.
sidebar / sidebar-foreground Базовая поверхность боковой панели и текст боковой панели по умолчанию. Контейнер Sidebar и его содержимое по умолчанию.
sidebar-primary / sidebar-primary-foreground Выделенные действия внутри боковой панели. Активные элементы, плитки значков, значки и призывы к действию на боковой панели.
sidebar-accent / sidebar-accent-foreground Наведите указатель мыши и выберите состояния внутри боковой панели. Состояния наведения бокового меню, открытые элементы и интерактивные строки.
sidebar-border Границы и разделители, специфичные для боковой панели. Заголовки боковой панели, группы и внутренние разделители.
sidebar-ring Кольца фокусировки для боковой панели. Фокусированные элементы управления внутри боковой панели.
radius Масштаб базового углового радиуса. Карты, поля ввода, кнопки, всплывающие окна и производные токены radius-*.

Добавление новых токенов

Чтобы добавить новый токен, определите его в :root и .dark, а затем откройте его для Tailwind, добавив rxconfig.py.

:root {
  --warning: oklch(0.84 0.16 84);
  --warning-foreground: oklch(0.28 0.07 46);
}

.dark {
  --warning: oklch(0.41 0.11 46);
  --warning-foreground: oklch(0.99 0.02 95);
}

Теперь вы можете использовать bg-warning и text-warning-foreground в своих компонентах.

rx.el.div(class_name="bg-warning text-warning-foreground")

CSS темы по умолчанию

Ниже приведен полный шаблон темы neutral по умолчанию. Скопируйте его в свой глобальный файл CSS и при необходимости настройте токены.

Этот каркас также соответствует предустановке b0 в buridan/create.

@custom-variant dark (&:is(.dark *));

@theme inline {
  --color-background: var(--background);
  --color-foreground: var(--foreground);
  --font-sans: var(--font-family);
  --font-heading: var(--font-family);
  --font-mono: var(--font-family);
  --color-sidebar-ring: var(--sidebar-ring);
  --color-sidebar-border: var(--sidebar-border);
  --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
  --color-sidebar-accent: var(--sidebar-accent);
  --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);
  --color-sidebar-primary: var(--sidebar-primary);
  --color-sidebar-foreground: var(--sidebar-foreground);
  --color-sidebar: var(--sidebar);
  --color-chart-5: var(--chart-5);
  --color-chart-4: var(--chart-4);
  --color-chart-3: var(--chart-3);
  --color-chart-2: var(--chart-2);
  --color-chart-1: var(--chart-1);
  --color-ring: var(--ring);
  --color-input: var(--input);
  --color-border: var(--border);
  --color-destructive: var(--destructive);
  --color-accent-foreground: var(--accent-foreground);
  --color-accent: var(--accent);
  --color-muted-foreground: var(--muted-foreground);
  --color-muted: var(--muted);
  --color-secondary-foreground: var(--secondary-foreground);
  --color-secondary: var(--secondary);
  --color-primary-foreground: var(--primary-foreground);
  --color-primary: var(--primary);
  --color-popover-foreground: var(--popover-foreground);
  --color-popover: var(--popover);
  --color-card-foreground: var(--card-foreground);
  --color-card: var(--card);
  --radius-sm: calc(var(--radius) * 0.6);
  --radius-md: calc(var(--radius) * 0.8);
  --radius-lg: var(--radius);
  --radius-xl: calc(var(--radius) * 1.4);
  --radius-2xl: calc(var(--radius) * 1.8);
  --radius-3xl: calc(var(--radius) * 2.2);
  --radius-4xl: calc(var(--radius) * 2.6);
}

:root {
  --background: oklch(1 0 0);
  --foreground: oklch(0.145 0 0);
  --card: oklch(1 0 0);
  --card-foreground: oklch(0.145 0 0);
  --popover: oklch(1 0 0);
  --popover-foreground: oklch(0.145 0 0);
  --primary: oklch(0.205 0 0);
  --primary-foreground: oklch(0.985 0 0);
  --secondary: oklch(0.97 0 0);
  --secondary-foreground: oklch(0.205 0 0);
  --muted: oklch(0.97 0 0);
  --muted-foreground: oklch(0.556 0 0);
  --accent: oklch(0.97 0 0);
  --accent-foreground: oklch(0.205 0 0);
  --destructive: oklch(0.577 0.245 27.325);
  --border: oklch(0.922 0 0);
  --input: oklch(0.922 0 0);
  --ring: oklch(0.708 0 0);
  --chart-1: oklch(0.87 0 0);
  --chart-2: oklch(0.556 0 0);
  --chart-3: oklch(0.439 0 0);
  --chart-4: oklch(0.371 0 0);
  --chart-5: oklch(0.269 0 0);
  --sidebar: oklch(0.985 0 0);
  --sidebar-foreground: oklch(0.145 0 0);
  --sidebar-primary: oklch(0.205 0 0);
  --sidebar-primary-foreground: oklch(0.985 0 0);
  --sidebar-accent: oklch(0.97 0 0);
  --sidebar-accent-foreground: oklch(0.205 0 0);
  --sidebar-border: oklch(0.922 0 0);
  --sidebar-ring: oklch(0.708 0 0);
  --radius: 0.5rem;
  --border-width: 1px;
  --card-padding: 1.25rem;
  --card-gap: 1rem;
  --font-family: "Inter", sans-serif;
}

.dark {
  --background: oklch(0.145 0 0);
  --foreground: oklch(0.985 0 0);
  --card: oklch(0.205 0 0);
  --card-foreground: oklch(0.985 0 0);
  --popover: oklch(0.205 0 0);
  --popover-foreground: oklch(0.985 0 0);
  --primary: oklch(0.922 0 0);
  --primary-foreground: oklch(0.205 0 0);
  --secondary: oklch(0.269 0 0);
  --secondary-foreground: oklch(0.985 0 0);
  --muted: oklch(0.269 0 0);
  --muted-foreground: oklch(0.708 0 0);
  --accent: oklch(0.269 0 0);
  --accent-foreground: oklch(0.985 0 0);
  --destructive: oklch(0.704 0.191 22.216);
  --border: oklch(1 0 0 / 10%);
  --input: oklch(1 0 0 / 15%);
  --ring: oklch(0.556 0 0);
  --chart-1: oklch(0.87 0 0);
  --chart-2: oklch(0.556 0 0);
  --chart-3: oklch(0.439 0 0);
  --chart-4: oklch(0.371 0 0);
  --chart-5: oklch(0.269 0 0);
  --sidebar: oklch(0.205 0 0);
  --sidebar-foreground: oklch(0.985 0 0);
  --sidebar-primary: oklch(0.488 0.243 264.376);
  --sidebar-primary-foreground: oklch(0.985 0 0);
  --sidebar-accent: oklch(0.269 0 0);
  --sidebar-accent-foreground: oklch(0.985 0 0);
  --sidebar-border: oklch(1 0 0 / 10%);
  --sidebar-ring: oklch(0.556 0 0);
  --radius: 0.5rem;
  --border-width: 1px;
  --card-padding: 1.25rem;
  --card-gap: 1rem;
  --font-family: "Inter", sans-serif;
}