Визуальные основы и токены
Публичный контракт на использование фирменных цветов, шрифтов, отступов, скруглений и семантических токенов бренда Qokit.
Визуальные основы и токены
Интерфейс платформы Qokit использует прозрачную, профессиональную и сдержанную синюю палитру. Разработчикам следует адаптировать тему через семантические токены, не дублируя значения цветов, теней, скруглений или шрифтов в компонентах бизнеса.
Основные роли
| Роль | Рекомендуемый токен | Назначение |
|---|---|---|
| Фон страницы | --bg, --page-background | Базовый цвет страницы и общее пространство |
| Поверхность контента | --panel, --card-surface | Панели, карточки контента |
| Поверхность элементов управления | --control-surface, --control-surface-hover, --control-surface-active, --input-surface | Кнопки, поиск, поля ввода и состояния взаимодействия |
| Поверхность всплывающих окон | --dropdown-surface, --dialog-surface | Меню, Popover, Dialog |
| Границы | --panel-border, --control-border, --input-border | Разделители и границы состояний |
| Текст | --text, --muted | Основная и второстепенная информация |
| Фирменные взаимодействия | --accent, --link-color, --link-hover-color | Ссылки, выделение и легкое акцентирование |
| Фокус клавиатуры | --focus-ring | Состояние focus-visible |
| Скругления | --card-radius, --button-radius, --button-pill-radius | Форма карточек и элементов управления |
| Размер шрифта кнопок | --button-font-size-sm, --button-font-size-md, --button-font-size-lg | Типографика размеров общих кнопок |
| Шрифты | --font-heading, --font-body | Заголовки и основной текст / элементы управления |
Типографика
- Space Grotesk используется для заголовков бренда, заголовков страниц и ключевых цифр;
- Manrope используется для основного текста, кнопок, форм, таблиц и рабочих пространств;
- Рабочее пространство сохраняет компактность, не используя крупные заголовки маркетинговых страниц;
- Для китайского текста не увеличивается английская ширина межбуквенного интервала, длинные переводы не должны сжимать соседние действия.
Отступы и размеры
- Используйте ритм 4px: 8, 12, 16, 20, 24, 32, 48, 64, 96;
- Высота кликабельной области компактных элементов управления не менее 40px;
- Стандартная высота действий — 44px, на мобильных устройствах основные действия не ниже 44px;
- Общие кнопки используют текст размером 14px, 15px и 16px соответственно для
sm,md,lg, не наследуя размер шрифта родительского контейнера; - Ширина контента платформы обычно не превышает 1160px, контент генерируемых сайтов — не более 1120px.
Правила тем
- Светлая и темная темы должны использовать одни и те же семантические токены;
- Обычный Dialog использует
--dialog-surfaceдля легкой вертикальной градации, скругление совпадает с Card и использует--card-radius; --accentиспользуется для ссылок, фокуса, выделения и прогресса, но не для больших фоновых заливок;- Обычные невыбранные элементы управления используют нейтральную поверхность
--control-surface-hoverпри hover; нажатые, выбранные, текущие и раскрытые состояния используют фирменную поверхность--control-surface-active.focus-visibleдобавляет--focus-ringповерх нейтральной поверхности; сфокусированные или активные поля сохраняют свои токены состояния ввода; - Цвета состояний передают только успех, предупреждение и опасность;
- Генерируемые сайты могут переопределять переменные темы, но должны сохранять контрастность основного текста и четкую иерархию CTA.