Skip to Content
Дизайн

Обновление дизайн-контракта

Журнал изменений публичных дизайн-токенов, API компонентов и контрактных спецификаций Qokit.

Обновление дизайн-контракта

2026-10-21 · Закреплённые действия в прокручиваемых меню

ActionItem.pinned принимает start или end, удерживая действия и ActionMenu.dropdownHeader вне прокручиваемого списка. Клавиатурная навигация и выбор охватывают все области. Хосты порталов могут ограничить высоту через --qk-menu-available-height, измеряемую с выбранной стороны элемента открытия. Без pinned сохраняется прежняя структура меню.

17 октября 2026 г. · Точка входа для настройки виджетов

Настройка виджетов страниц использует общую панель заголовка, доступную в проектах, контенте и на панелях управления. CustomizableWidgetLayoutControls добавляет необязательные customizeButtonRef и disabledCustomize; элементы сворачивания являются опциональными. CustomizableWidgetLibrary разделяет мобильную геометрию, начальное фокусирование, клавишу Escape и возврат фокуса между хостами. Сохранение состояния виджетов и команды остаются собственностью хоста. См. Интеграция настройки виджетов.

17 октября 2026 г. · Управляемые элементы панели рабочей области

WorkspaceHeaderPortal принимает необязательные startControl и endControl, с соответствующими опциональными целями хоста. Представления «Управляемые файлы» используют те же слоты панели заголовка и геометрию рабочей области, что и редактирование одного актива и предварительный просмотр. Существующие хосты могут продолжать предоставлять только заголовок, статус и действия. См. Интеграция EditorHeader.

17 октября 2026 г. · Измеряемые значения по умолчанию редактора

useWorkspaceResponsiveProfile добавляет необязательный onWidthChange(width) для доступных измерений рабочей области. useEditorLayout теперь применяет настроенные общие ограничения ширины также к хранилищу хоста, а readEditorLayout принимает необязательные ограничения в качестве своего четвертого аргумента. Существующие вызывающие объекты сохраняют свои значения по умолчанию. См. Интеграция компонентов.

2026-09-26 · Creator · Наборы стилей

Точные отступы · v3: site.theme.spacingOverrides 按 desktop/tablet/mobile → sectionPadding (0–240px), pageGutter, cardGap (0–96px). --qk-site-custom-{sectionPadding|pageGutter|cardGap}-{desktop|tablet|mobile}. 980px / 720px.

Кнопки и ссылки: primaryButtonStyle, secondaryButtonStyle (solid/outline), buttonFontSize (12–24px), linkUnderline (always/hover/none), linkHoverStyle (none/tint). --qk-site-{primary|secondary}-button-{background|color|border|shadow}, --qk-site-button-font-size, --qk-site-button-size-{sm|md|lg}, --qk-site-link-decoration, --qk-site-link-hover-decoration, --qk-site-link-hover-background. initial → Автоматически.

Дополнительные цвета: mutedColor, borderColor, buttonTextColor, cardSurfaceColor 与对应 dark* 字段 (--qk-site-color-card-rgb).

2026-09-09 · Сочетание клавиш глобальной навигации

SidebarNavigation / WorkspaceNavigationMenu: Глобальная навигация использует Command+\ на Mac или Control+\ в Windows/Linux, в том числе независимо внутри Creator. T и Shift+T по-прежнему управляют компоновкой редактора. Редактируемые поля, композиция текста, повторы и уже обработанные события игнорируются.

2026-09-08 · EmptyState

Создание проектов и статей/товаров CMS использует общий EmptyState: центрирование, прозрачный фон, компактная типографика и перенос действий. icon, layout, style и description необязательны. Заголовок использует h2; перенесите свои селекторы strong в слот skin title. Действия используют общий контейнер. Права и создание остаются у хоста.

2026-09-08 · SidebarNavigation

SidebarNavigation предварительно загружает маршруты того же источника после наведения на 180 мс или фокуса клавиатуры. Закреплённая и всплывающая навигация делят лимит 8 целей за 30 секунд. Загрузка приостанавливается без сети, в скрытых вкладках, при Save-Data или 2G; исключены скачивания, отключённые ссылки, новые окна и якоря той же страницы. Навигация и защита несохранённых изменений сохраняются.

2026-09-08 - Primary button foreground

Основные кнопки сохраняют синий цвет Logo #4695D8 и используют белые надписи, значки и индикаторы загрузки в обеих темах. При наведении сохраняется лёгкое осветление. Вторичные и опасные действия сохраняют свои смысловые цвета.

2026-09-07 - AccountDropdown / SidebarProfile

AccountDropdown поддерживает необязательные compact и preferences: компактный режим скрывает идентификаторы и историю создания; по умолчанию содержимое сохраняется. Appearance и Language принимают triggerRole="menuitem" в меню аккаунта. Клавиатурная навигация восстанавливает фокус, а вложенные языковые диалоги обрабатывают Escape самостоятельно. SidebarNavigation.searchEnabled по умолчанию равно true; для короткой фиксированной навигации используйте false. SidebarProfile с href без меню открывает одну и ту же страницу в развёрнутом режиме и режиме значков.

2026-09-07 - FormField / AdminEntityDialog / EditorWorkspace

Формы используют общую шкалу шрифта и переносят длинный текст, сохраняя скругления и фирменные цвета. FormField именует группы: controlId и внутренняя id связывают подпись. SearchField возвращает фокус после очистки. Segmented и ControlMenu поддерживают отключённые варианты; отключённые пункты ActionMenu не имеют ссылки. Занятые кнопки сохраняют размер и индикатор. AdminEntityDialog проверяет обязательные поля, почту и JSON, фокусирует ошибки, блокирует повторное сохранение и сохраняет ввод при сбое. EditorWorkspace предоставляет ref.focusControl(element) для показа скрытых панелей перед фокусировкой. Уменьшенное движение отключает переходы элементов управления. WorkspaceDialog прокручивает длинное содержимое, сохраняя заголовок и действия видимыми; короткие мобильные диалоги соответствуют высоте содержимого.

2026-09-07 · WorkspaceLocationSync / ProjectSwitcher

После завершения перехода WorkspaceLocationSync закрывает временную панель выбора пространств и сразу показывает инструменты целевой страницы. Настройки поиска и разделов сохраняются. Название области и контекст размещаются на разных строках; длинные имена в шапке сокращаются внутри кнопки.

2026-09-07 · Единая навигация и скруглённые поверхности Qokit

WorkspaceNavigationDock использует навигацию и права хоста через items, fallback, className и onClickCapture, не загружая новую сессию. Сохраняется настройка развёрнутой панели, значков или скрытия; до 860px используется выдвижное меню. PlatformHeader.leadingContext отображается и в EditorHeader. Кнопки-капсулы и скруглённые поверхности сохраняются, повторные рамки удаляются.

На компьютере нажатие кнопки меню скрывает боковую панель или восстанавливает последний видимый режим. Перетаскивание меню или края панели переключает режимы: скрыта, только значки, развёрнута. Стрелки влево/вправо учитывают направление текста. Отмена перетаскивания сохраняет прежнюю настройку; на телефоне остаётся выдвижное меню навигации.

Подключите WorkspaceLocationSync один раз внутри Suspense в layout Next. useWorkspaceQueryState(key, defaultValue, validate) возвращает [value, setValue, ready]; useWorkspaceQueryRecord(key, defaults, validators) восстанавливает только объявленные плоские фильтры. Не храните пароли и черновики в URL. WorkspacePage восстанавливает ограниченный набор позиций прокрутки сессии; внутренние области используют data-workspace-scroll-region и WorkspaceScrollRestoration. Отменяемые нативные переходы назад/вперёд используют защиту выхода без новых записей истории. AdminEntityDialog сохраняет ввод при ошибках и повторном рендеринге; версии и результаты контролирует хост.

В управлении используются фиксированные роли текста: заголовок страницы 20px/650, раздела 16px/600, текст и навигация 14px, подписи 13px, пояснения 12px. --qk-workspace-body-ink и --qk-workspace-active-ink основаны на существующих цветах.

Основные кнопки-капсулы используют синий цвет Logo #4695D8 напрямую через --accent-action, без тёмного градиента. Наведение добавляет 8% белого; подписи используют фирменный чернильный цвет с 10% чёрного для читаемости. Навигация сохраняет тот же синий оттенок и текст с учётом темы.

Выпадающие меню и переключатели пространств используют --menu-option-font-size (14px), --menu-option-font-weight (500) и высоту строки 1.45; выбранные пункты имеют насыщенность 600, метаданные — 12px/400. WorkspaceNavigationDock предварительно загружает адреса того же источника при наведении мыши или фокусе клавиатуры, с ограниченной дедупликацией. Сохраняются защита при выходе и маршруты хоста.

2026-09-07 - ColumnLayout

ColumnLayout заполняет окно управления закреплённой навигацией, отдельной прокруткой содержимого и фиксированной панелью страницы. WorkspacePage использует плоские разделы и общие токены скругления. До 860px навигация остаётся выдвижной панелью, неактивной в закрытом виде. Свойства и бизнес-логика не меняются. Уберите повторные внешние отступы и ограничьте ширину чтения внутри форм.

2026-09-05 · WorkspaceNavigationMenu / WorkspacePageHeader

Рабочие пространства после входа используют PlatformHeader.workspaceActions для единой области аккаунта и навигации при любой ширине. WorkspacePageHeader объединяет заголовки и действия. WorkspaceNavigationMenu показывает текущую боковую панель с правами и контекстом; EditorNavigationMenu остаётся совместимым псевдонимом. Studio сохраняет свою панель инструментов. Публичные заголовки сохраняют прежнее оформление.

WorkspaceNavigationGuard защищает глобальную навигацию через dirty, busy, error и необязательный onSave. Уход разрешён только после подтверждённого сохранения с результатом true; при ошибке черновик сохраняется. Language.onBeforeChange(apply) позволяет так же защитить смену языка. На время сохранения отключайте поля формы.

2026-09-05 · EditorNavigationMenu

EditorNavigationMenu показывает всю SidebarNavigation приложения в панели поверх редактора, сохраняя права и контекст проекта без сдвига холста. Язык и тема находятся внизу; Escape сначала обрабатывают подменю. При ширине до 1120px включительно заголовок занимает две строки, а меню показывает текущий режим. Фокус и полноэкранный режим браузера независимы. Переход ожидает завершения сохранения и защищает черновики.

2026-09-05 · EditorHeader

EditorHeader сохраняет логотип, аккаунт и глобальное меню приложения в активном редакторе. startControl и endControl управляют боковыми панелями, center — режимами просмотра, actions — сохранением. PlatformHeader.editorActions повторно использует адаптивную навигацию, выбор языка и темы. onNavigate должен обработать несохранённые изменения до вызова callback. На узких экранах шапка занимает две строки; подменю обрабатывают Escape первыми.

2026-09-05 · SidebarToggleSlot

SidebarToggleSlot переносит кнопку боковой панели в заголовок рабочей области. Используйте один слот и одну левую панель. SidebarNavigation сохраняет управление состоянием, сочетаниями клавиш и мобильной панелью; без слота кнопки остаются на прежнем месте. Кнопка в заголовке также закрывает мобильную панель; после закрытия фокус возвращается к этой же кнопке.

2026-09-05 · EditorWorkspace / Dialog / Segmented

view / onViewChange переключают edit, focus и preview без замены редактора. preview задаёт предпросмотр, previewPanel использует существующую панель. layout поддерживает writing, structure и canvas. storageKey запоминает ширину и сворачивание панелей, но не документ.

onSaveAndClose возвращает true после подтверждённого сохранения, false при ошибке, handled, если приложение уже выполнило переход, или pending, если проверка требует решения. При ошибке редактор остаётся открытым. closeBehavior="collapse" допустим, только если приложение сохраняет черновик. EditorSaveStatus показывает подтверждённое состояние. EditorViewControls, EditorLeaveDialog и useEditorLayout можно комбинировать отдельно.

Изменения клавиатуры: у Segmented одна остановка Tab, выбор меняется стрелками / Home / End. Dialog учитывает Escape, обработанный вложенным слоем; затем редактор сначала выходит из фокуса или предпросмотра и лишь потом закрывается. LivePreviewToolbar.exitControl принимает общие переключатели вида. Сохранение, публикация и права остаются в ведении приложения.

2026-09 · EditorWorkspace

EditorWorkspace объединяет полноэкранный диалог, управление фокусом и адаптивные панели. dirty запрашивает подтверждение отмены изменений, busy запрещает закрытие при сохранении, а onSave обрабатывает Ctrl/Cmd+S. Права, данные, сохранение и публикация остаются в ведении приложения.

2026-08 · Компактная плотность метрик

  • Добавлен необязательный API density="compact" для MetricCard, предназначенный для рабочих пространств с высокой плотностью операций;
  • Сохранены текущая плотность по умолчанию и семантика DOM;
  • Компактные отступы, числовые масштабы и минимальные высоты объединены в общие стили компонентов, что исключает необходимость визуального переопределения на уровне маршрутизации.

2026-07 · Унифицированные элементы форм

  • В @qokit/components/ui добавлены FormField, Input, Textarea, Checkbox, RadioGroup и Switch;
  • Общие скелетные компоненты FormField связывают метки, пояснения, сообщения об ошибках, статус обязательности и ссылки ARIA;
  • Элементы Input, Textarea, Select и SearchField унифицированы до размеров 40px, 44px, 48px и общих токенов взаимодействия;
  • Для новых базовых компонентов форм добавлены рецепты Skin для платформы, Admin и генерируемых сайтов;
  • Сохранены существующие стили .qk-field в качестве пути миграции с обратной совместимостью.

2026-07 · Типографика размеров кнопок

  • Добавлены три семантических токена: --button-font-size-sm, --button-font-size-md, --button-font-size-lg;
  • Текст в элементах Button с классами sm, md, lg теперь фиксированно использует размеры 14px, 15px, 16px соответственно и больше не наследует размер шрифта от Header, Dialog или контейнера страницы;
  • Если Skin сайта требует настройки типографики кнопок, следует переопределить соответствующий семантический токен, а не перезаписывать font-size через классы маршрутизации.

2026-07 · Скелет публичной навигации платформы

  • Добавлен PlatformHeader, не зависящий от авторизации; платформа и документационный сайт используют один и тот же семантический скелет;
  • Добавлены PublicPlatformHeader и buildPublicHeaderNavItems; анонимное состояние платформы и документационный сайт повторно используют одну и ту же комбинацию общего Header и конфигурацию навигации;
  • HeaderNavItem добавляет тип menu; десктопный Header использует выпадающее меню с возможностью закрытия, мобильный Header автоматически разворачивается в группы ссылок;
  • SiteFooter добавляет опциональные brandHref и controls, поддерживая различные сценарии интеграции, такие как публичные документы;
  • Добавлен PublicPlatformFooter; платформа и документационный сайт повторно используют один и тот же Footer Shell, разрешая кросс-доменное разрешение ссылок платформы;
  • Все вышеперечисленное является обратно совместимыми опциональными API; логика состояния оригинального платформенного Header и стандартные элементы управления Footer остаются без изменений.

2026-07 · Публичные дизайн-руководства

  • Разделены публичные дизайн-контракты и внутренние спецификации реализации AI;
  • Опубликованы визуальные токены, импорт компонентов, границы Skeleton/Skin, Button, Card и требования по доступности;
  • Четко указано, что разрушительные изменения компонентов должны сопровождаться инструкциями по миграции;
  • Публичный поиск, Sitemap и вывод LLM содержат только те данные, на которые можно безопасно ссылаться извне.

Примечания о совместимости

  • Новые опциональные свойства, опциональные слоты Skin и семантические токены обычно сохраняют обратную совместимость;

  • Удаление или переименование свойств, изменение поведения DOM/семантики/клавиатуры по умолчанию относится к разрушительным изменениям;

  • Разрушительные изменения будут описаны на этой странице с указанием области воздействия, альтернативных API и шагов миграции.

  • 2026-09-06: Навигация на компьютере сохраняет развёрнутую панель и значки и добавляет автоматическое скрытие. SidebarNavigation / WorkspaceNavigationMenu / Dialog

  • 2026-09-06: EditorViewControls отделяет режимы редактирования и фокусировки от полноэкранного режима. EditorViewControls

  • 2026-09-06: Language и Appearance variant="menu" поддерживают layout="row" для отображения подписи, текущего значения и стрелки. Компактный вид по умолчанию и защита при смене языка сохраняются. SiteHeaderCopy.helpResources и contactSupport задают необязательные подписи ссылок помощи рабочего пространства. Language / Appearance

  • 2026-09-06: Страницы с боковой панелью убирают дублирующую кнопку меню; существующий переключатель и API навигации остаются доступны. WorkspaceNavigation

  • 2026-09-06: Глобальная навигация использует значок меню, инструменты — направленные значки панелей. WorkspacePanelReveal / EditorViewControls

  • 2026-09-06: Режим отображения · E / T / V / F · Segment.shortcut. EditorViewControls

  • 2026-09-06: PlatformHeader.workspaceNavigation размещает глобальную навигацию перед логотипом PlatformHeader.workspaceNavigation

2026-09-06 - EditorHeader.preview / EditorViewControls.returnView

EditorHeader.preview показывает только center как компактную панель предпросмотра без рамки; логотип, аккаунт, сохранение и панели остаются смонтированными, но скрытыми. При отдельной LivePreviewToolbar можно скрыть заголовок редактора и передать EditorViewControls.returnView (edit или focus) для возврата прежнего режима. Сохраняйте доступный возврат и независимый полный экран; заголовок сайта остаётся видимым.

2026-09-06 · Builder / CMS

Builder и CMS совместно используют BuilderWorkspace, EditorCatalog и EditorComponentSettings для панелей, иллюстраций вставки и настроек оформления. Пресеты применяют связанные настройки вместе и сохраняют содержимое; сохранением и отменой управляет приложение. Элементы управления используют тему платформы, а содержимое — тему сайта.

2026-09-06 - EditorViewControls

Одна кнопка переключает режимы в обе стороны: при редактировании показывает Фокус, в фокусе — Редактировать. Нажмите её или T; E сразу возвращает редактирование. В узком заголовке кнопка остаётся видимой, а предпросмотр, полный экран и дополнительные действия находятся в меню Ещё. EditorViewControls

2026-09 · Рабочие области управления

Узкие таблицы (WorkspaceDataTable, AdminDataTable) показывают записи с подписями, выбором, собственными заголовками и действиями. Для сравнительных матриц задайте mobileLayout="scroll". WorkspaceFilterToolbar размещает поиск и фильтры перед сортировкой и видом. Боковая панель использует h2, страница — h1.

2026-09-08 · Task focus

useSidebarTaskFocus(active) временно скрывает навигацию во время работы, требующей концентрации. При выходе восстанавливается прежний вид, если пользователь сам не изменил режим. Автоматическое скрытие не перезаписывает сохранённые настройки.

Новая документация API (на английском; перевод ожидается)

Optional FloatingToolPanel.viewKey animates tool changes without remounting the body. Shared opening, closing, unfolding and pin feedback respect reduced motion; pointer geometry updates run at most once per animation frame. Closed Dialog keepMounted surfaces become inert and hidden from assistive technology immediately, including during an exit transition. Existing props and document state ownership are unchanged.

The opt-in useWorkspacePanelEdgeDrag hook connects existing workspace borders to expanded, icon and hidden states in one mouse or touch gesture, with keyboard resizing, RTL and cancellation. ResizablePanels now marks its separators with data-workspace-panel-edge; existing hosts retain their behavior until they enable the hook. Hosts own widths, state, focus and visual skins. See the integration contract.

Новая документация API (на английском; перевод ожидается) · 2026-10

2026-10-08 · Workspace title navigation

WorkspaceLayout and WorkspacePageHeader accept optional backControl before the title. Use WorkspaceBackButton with a localized label and the existing href or onClick; it supplies an icon, accessible name, Tooltip and RTL mirroring. Hosts retain return destinations, list state and navigation guards. Existing headers without this slot keep their layout.

На этой странице

Обновление дизайн-контракта2026-10-21 · Закреплённые действия в прокручиваемых меню17 октября 2026 г. · Точка входа для настройки виджетов17 октября 2026 г. · Управляемые элементы панели рабочей области17 октября 2026 г. · Измеряемые значения по умолчанию редактора2026-09-26 · Creator · Наборы стилей2026-09-09 · Сочетание клавиш глобальной навигации2026-09-08 · EmptyState2026-09-08 · SidebarNavigation2026-09-08 - Primary button foreground2026-09-07 - AccountDropdown / SidebarProfile2026-09-07 - FormField / AdminEntityDialog / EditorWorkspace2026-09-07 · WorkspaceLocationSync / ProjectSwitcher2026-09-07 · Единая навигация и скруглённые поверхности Qokit2026-09-07 - ColumnLayout2026-09-05 · WorkspaceNavigationMenu / WorkspacePageHeader2026-09-05 · EditorNavigationMenu2026-09-05 · EditorHeader2026-09-05 · SidebarToggleSlot2026-09-05 · EditorWorkspace / Dialog / Segmented2026-09 · EditorWorkspace2026-08 · Компактная плотность метрик2026-07 · Унифицированные элементы форм2026-07 · Типографика размеров кнопок2026-07 · Скелет публичной навигации платформы2026-07 · Публичные дизайн-руководстваПримечания о совместимости2026-09-06 - EditorHeader.preview / EditorViewControls.returnView2026-09-06 · Builder / CMS2026-09-06 - EditorViewControls2026-09 · Рабочие области управления2026-09-08 · Task focusНовая документация API (на английском; перевод ожидается)Новая документация API (на английском; перевод ожидается) · 2026-102026-10-08 · Workspace title navigation