Skip to Content
Дизайн

Интеграция компонентов

Публичный контракт интеграции общих компонентов, паттернов, Skin и токенов стилей Qokit.

Интеграция компонентов

Qokit использует модель «общий скелет + рецепт Skin». Внешние интеграторы полагаются на семантические и интерактивные контракты компонентов, завершая визуальную адаптацию через Skin и токены.

2026-10-20 · Независимые действия карточек визуального выбора

Параметры EditorVisualChoiceGroup принимают необязательный accessory для независимых меню карточки или редакторов имени. Общий RadioGroup размещает его рядом с нативной подписью, поэтому управление карточкой не выбирает её радиокнопку. afterOptions добавляет отдельное действие каталога, например создание карточки, после вариантов. Сохранение, права, проверка и фокус после замены или удаления остаются у хоста. Варианты без дополнительных действий сохраняют структуру и поведение.

17 октября 2026 г. · Общая анимация панели рабочей области

EditorWorkbenchChrome отображает внедренные начальные/конечные полосы через BuilderWorkbenchFrame, ту же структуру панели, которая используется в Creator и при редактировании контента. Хосты предоставляют контент, видимость и предпочтения ширины. На десктопе отслеживание и прозрачность/сдвиг панели разделяют --qk-sidebar-motion-duration и --qk-sidebar-motion-easing; перетаскивание отключает переходы, а режим уменьшенного движения переключается мгновенно.

Свернутые панели остаются смонтированными для сохранения черновиков. Общая рамка немедленно применяет inert и aria-hidden, в то время как скин платформы завершает выход перед скрытием видимости. Компактные панели сохраняют свою геометрию оверлея на протяжении всего выхода; хосты не должны добавлять hidden или display: none в оболочку панели. Явные панели подглядывания сохраняют свое существующее поведение интерактивного раскрытия. Выбор заголовка остается доступным в открытом/закрытом состояниях; используйте EditorPanelChoiceShortcuts.mobileMenu, когда телефонные назначения должны совместно использовать меню.

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

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

2026-09-30 · Доступность SelectionToolbar

SelectionToolbar.ariaLabel позволяет задать панели инструментов имя области. Счётчик остаётся сообщением об изменении состояния. Хост предоставляет локализованные подписи и может использовать actionContent для общих компонентов EditorToolGroup и ActionMenu; проверки разрешений и обработчики действий остаются у хоста.

2026-09-10 · Значки идентификации рабочего пространства

ProjectSwitcherProject.badge принимает необязательное неинтерактивное содержимое React. Значок отображается рядом с именем каждого элемента, в строке текущего контекста, отсутствующего в списке, и рядом с текущим именем в текстовом переключателе. Переключатели только со значком остаются компактными; текстовые переключатели платформы скрывают значок на ширине телефона, сохраняя место для имени рабочего пространства. В открытом меню значок остаётся видимым. Хост предоставляет данные с правильной областью действия, локализованные подписи и стили отображения; при отсутствии поля сохраняется прежний вид.

2026-09-08 · EmptyState

EmptyState центрирует необязательный декоративный icon, title, необязательный description и action на прозрачном фоне. layout="section" — компактный вариант по умолчанию; layout="workspace" выделяет больше места. Помещайте действия прямо в action, несколько кнопок объединяйте во fragment; контейнер управляет отступами и длинными подписями. Заголовок — h2; используйте слот title вместо strong. Корневые классы сохраняются; поддерживаются skin.vars и style. Хост отвечает за локализацию, права, навигацию и создание; поиск и ошибки сохраняют собственные сообщения и действия.

2026-09-08 · SidebarNavigation

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

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 и используют белые надписи, значки и индикаторы загрузки в обеих темах. При наведении сохраняется лёгкое осветление. Вторичные и опасные действия сохраняют свои смысловые цвета.

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

2026-09-07 - ColumnLayout

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

Точки входа для импорта

import { Button, Card, Dialog, IconButton } from '@qokit/components/ui';
import { PlatformHeader, SiteFooter } from '@qokit/components/patterns';
import { platformButtonSkin } from '@qokit/components/skins/platform';
import { siteCardSkin } from '@qokit/components/skins/site';
Точка входаНазначение
@qokit/components/uiБазовые компоненты: Button, Card, Dialog, Menu, Pill и др.
@qokit/components/patternsКомпозиции: Header, Footer, рабочая область, таблицы, ресурсы и AI-ассистент
@qokit/components/skins/platformВизуальные рецепты платформы и рабочей области
@qokit/components/skins/adminВизуальный рецепт Admin
@qokit/components/skins/siteГенерация визуального рецепта сайта

Границы общих обязанностей

PromptPanel принимает необязательные атрибуты referenceReader и локализованные свойства referenceCopy. Ридер возвращает извлечённые маркеры contentExcerpt и truncated через асинхронные file(File, AbortSignal) и website(url, AbortSignal), при этом аутентификация и доступ к API обеспечиваются хостом. Компонент управляет чтением, предпросмотром, повторной попыткой и удалением; если валидный URL не содержит подсказок, запрос дополняется через referenceCopy.websitePrompt, при ошибке формата используется referenceCopy.errors.url и чтение блокируется. Отправка данных до завершения чтения или во время него ожидает актуального содержимого и выполняется только один раз; изменение ввода или сбой чтения отменяет ожидающую отправку, повторная попытка не восстанавливает старые данные. Файл должен быть готов к отправке. Полный URL автоматически считывается при вставке, потере фокуса или нажатии Enter; начальный URL также считывается с повторным использованием активных или завершённых результатов; при сбое предоставляется явная возможность повторить попытку. Редактирование или удаление URL отменяет старое чтение и очищает результат. Если ридер не предоставлен, продолжается нативная отправка без обработки асинхронных ссылок.

Интеграция ссылок была добавлена в сентябре 2026 года как дополнительная и обратно совместимая функция компонента.

Скелетные компоненты гарантируют:

  • DOM и семантические теги;
  • Поведение ARIA, клавиатуры, фокуса и disabled;
  • Состояния и базовую интерактивность;
  • Стабильные классы по умолчанию;
  • Именованные слоты Skin.

Skin может:

  • добавлять классы к слотам root, header, body, item, action и др.;
  • передавать CSS-переменные через vars;
  • использовать уже опубликованные переключатели тона, слоя или визуальной адаптации компонента.

Skin не должен запрашивать данные, изменять DOM, содержать бизнес-логику или обходить функции доступности.

Генерация содержимого элементов

Сгенерированные пользовательские блоки продолжают использовать зарегистрированные элементы html-* в Schema v2, без применения исполняемого HTML или новых типов блоков. Начиная с сентября 2026 года, @qokit/site-schema предоставляет bindSiteModuleContent, updateSiteModuleBoundContent и forkSiteModuleContentBindings для привязки языкового контента. Пути контента сохраняются в модуле, тексты для посетителей — в отображении языкового контента; обновления используют транзакции отмены и сохранения; при копировании или перемещении элементов между блоками необходимо создавать производные привязки, чтобы не изменять источник.

Необязательный extensionRequirements фиксирует нерешённые требования времени выполнения и не является списком установки или предоставлением прав. createSiteExtensionHandoff экспортирует неисполняемые запросы разработки v1; перед публикацией работающего сайта эти требования должны быть устранены или явно исключены после проверки.

Элементы форм

Общие формы используют FormField для связывания меток, пояснений, обязательных метаданных, ошибок и идентификаторов элементов. Текстовые элементы используют Input, многострочный контент — Textarea, элементы выбора — Checkbox, RadioGroup и Switch; существующие Select и SearchField используют единый контракт размеров и состояний.

import { FormField, Input } from '@qokit/components/ui';

<FormField label="Site name" description="Up to 60 characters" error={errors.name} required>
  <Input name="name" value={name} onChange={handleChange} />
</FormField>;

FormField связывает метки, пояснения и ошибки с уникальным дочерним элементом через id, aria-describedby, aria-invalid и required. Больше не нужно оборачивать общие элементы в дополнительные <label>.

Input, Textarea, Select и SearchField поддерживают три размера: sm, md и lg, соответствующие 40px, 44px и 48px. Однострочные элементы по умолчанию используют форму pill; Textarea всегда использует общий скруглённый угол для многострочного ввода. Все состояния взаимодействия и ошибок берутся из общих Token.

Во время миграции допускается использование старого контракта .qk-field; новое подключение должно использовать общие компоненты и именованные слоты Skin.

Выбор в списках

Начиная с сентября 2026 года списки могут использовать useWorkspaceSelectionMode({ enabled, resetKey, onClear }) совместно с WorkspaceFilterToolbar.selection. Этот Hook изначально не активен, сбрасывается при изменении диапазона или прав, а также различает очистку выбранных ID и выход из пакетного режима; ключ диапазона должен включать коллекцию, язык, пагинацию и фильтрацию.

Передавайте WorkspaceDataTable.selection только при активном пакетном режиме; сетка и мобильные чекбоксы используют тот же режим. Панель инструментов отвечает за общие операции выбора, потребитель предоставляет локализованный текст, необязательный ID и проверенные на права действия предметной области. Необязательный actionContent может содержать дополнительную семантику ARIA, но не заменяет общие элементы или подтверждение. Списки только для чтения не показывают пакетный режим, выбор файлов и проверка предложений сохраняют свою собственную семантику.

Эти новые возможности являются необязательными и обратно совместимыми; выбор в таблицах по-прежнему явно контролируется потребителем.

Карточки показателей

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

DataCard provides a title and optional headerAction, body content with an optional emphasized value, and optional footerText and footerAction. Pass other body content as children. density="default" has a 144px minimum height and 20px padding; density="compact" has a 112px minimum height and 16px padding. Cards grow when content needs more room. variant selects the shared Card surface: surface, muted, or state. Choose these shared sizes instead of overriding height, padding, or value typography in route CSS.

Use shared UI controls in action slots. Keep the card root non-interactive when it has actions; a whole-card action cannot contain nested buttons or links. MetricCard composes the same skeleton and retains label, detail, semantic tone, and optional visuals.

import { DataCard, MetricCard } from '@qokit/components/patterns';
import { Button } from '@qokit/components/ui';

<DataCard
  title="Published"
  value={24}
  headerAction={<Button size="sm" variant="ghost">View</Button>}
  footerText="Up 3 from last week"
  footerAction={<Button size="sm" variant="secondary">Details</Button>}
  density="compact"
/>;

<MetricCard density="compact" label="Published" value={24} tone="success" />;

Logo по умолчанию показывает статичное изображение. motion="breathe" сохраняет размеры скрытого логотипа и один раз проявляет его за 4,8 секунды после загрузки страницы, когда видна хотя бы половина. Шапка и подвал не добавляют задержку. motionVisibilityDelayMs задаёт дополнительное время непрерывной видимости, по умолчанию ноль. motionOnceKey сохраняет запись воспроизведения между повторными монтированиями в одном документе; у шапки и подвала отдельные ключи. Навигация, смена темы и обратная прокрутка не повторяют анимацию; полная перезагрузка сбрасывает запись. При уменьшении движения, отключённом JavaScript или недоступном наблюдении видимости показывается статичный логотип. motion="reveal" остаётся псевдонимом.

PlatformHeader.autoHideOnScroll по умолчанию равен false; PublicPlatformHeader включает его. Шапка скрывается при прокрутке вниз и возвращается при прокрутке вверх или около начала страницы. Открытые меню и фокус внутри шапки сохраняют её видимость. Шапки рабочей области и редактора остаются неподвижными.

PlatformHeader — это скелет Header без бизнес-состояния. PublicPlatformHeader комбинирует на его основе входные точки бренда, общую навигацию, язык, тему, вход, кнопку «Попробовать сейчас» и мобильное меню; анонимное состояние платформы и документационный сайт напрямую повторно используют эту композицию.

Общая навигация генерируется единообразно через buildPublicHeaderNavItems(copy, links) («Ресурсы / Цены / Новости»). Интеграторы должны парсить только внутренние URL текущего приложения, документационного сайта и платформы; не следует повторно определять порядок меню или тексты. После входа Header платформы также использует ту же функцию генерации.

<PublicPlatformHeader
  copy={headerCopy}
  links={{
    brandHref: '/',
    resourceCenterHref: '/resources',
    userManualHref: 'https://docs.qokit.com/manual',
    developerDocsHref: 'https://docs.qokit.com/developers',
    changelogHref: 'https://docs.qokit.com/changelog',
    pricingHref: '/pricing',
    newsHref: '/news',
    loginHref: '/login',
    studioHref: '/studio'
  }}
/>

Базовый navItems все еще поддерживает link, scroll и menu. menu на десктопе поддерживает закрытие по клику, клавиатуре, Escape и клику вне элемента; на мобильных устройствах MobileHeaderMenu разворачивает их в группы ссылок.

SiteFooter — это скелет Footer; платформа и документационный сайт используют PublicPlatformFooter для унифицированной композиции внешнего Shell, входных точек бренда, ссылок, элементов темы и языка. Кросс-доменная интеграция преобразует относительные ссылки платформы в абсолютные адреса через resolveCompanyHref.

<PublicPlatformFooter
  brandHref="https://qokit.com"
  copy={footerCopy}
  resolveCompanyHref={(href) => `https://qokit.com${href}`}
/>

Бизнес-приложения не должны копировать DOM Header/Footer или массивы общей навигации; для иного визуального представления следует использовать PlatformHeaderSkin, SiteFooterSkin или соответствующие Skin платформы.

Стратегия совместимости

  • Добавление опциональных свойств и слотов Skin относится к обратно совместимым изменениям;
  • Удаление свойств, изменение семантики по умолчанию или изменение поведения DOM/клавиатуры относится к разрушительным изменениям;
  • Разрушительные изменения должны быть внесены в Changelog и сопровождаться примерами миграции;
  • Не следует полагаться на непубличные внутренние классы, каталоги или структуру маршрутов;
  • Если две и более точки интеграции требуют одинакового переопределения, следует повысить его до уровня публичного Skin или токена.

Полноэкранное редактирование

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

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 принимает общие переключатели вида. Сохранение, публикация и права остаются в ведении приложения.

import { EditorWorkspace } from '@qokit/components/patterns';

<EditorWorkspace
  open={open}
  title={title}
  dirty={dirty}
  busy={saving}
  onClose={closeEditor}
  onSave={saveDraft}
  onSaveAndClose={saveDraft}
  saveState={saveState}
  layout="writing"
  storageKey="article"
  preview={preview}
  navigation={structure}
  inspector={properties}
  actions={saveActions}
>
  {editor}
</EditorWorkspace>

SidebarToggleSlot

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

EditorHeader

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

WorkspaceHeaderPortal.startControl и endControl размещают переключатели панели управляемой страницы в соответствующих слотах хоста. Хосты экспонируют необязательные startTarget и endTarget наряду с заголовком, статусом и действиями. Библиотека файлов и рабочее пространство одного актива используют workAreaControls; предварительный просмотр актива сохраняет полный заголовок, чтобы его идентичность, действие возврата и назначения панели оставались доступными. ProjectWorkspace владеет общим выбором левой навигации/разговора для Контента и Файлов. Файлы регистрирует свои сохраненные размеры панели ресурсов через useProjectResourcePanel, навигацию через порталы — через ProjectContentTools и предоставляет только свой правый элемент управления инспектора через ProjectToolbar.endControl. Разговор использует ту же левую полосу и встроенный композитор во всех областях проекта; компактные задачи ресурсов, разговоров и инспекторов являются взаимоисключающими.

EditorNavigationMenu

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

WorkspaceNavigationMenu / WorkspacePageHeader

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

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

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

Навигация на компьютере сохраняет развёрнутую панель и значки и добавляет автоматическое скрытие. Панель и выдвижное меню используют общие поиск и состояние групп. Точный указатель у края открывает просмотр через 300ms и закрывает его через 320ms после ухода; щелчок оставляет меню открытым. Сенсорное управление и клавиатура сохраняют явные кнопки. По умолчанию Dialog использует modal={true} и autoFocus={true}; просмотр задаёт обоим false, сохраняя фокус ввода и прокрутку.

EditorViewControls

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

EditorViewControls отделяет режимы редактирования и фокусировки от полноэкранного режима. Предпросмотр включается отдельно и возвращает предыдущий режим; useEditorWorkMode сохраняет его для собственных действий выхода. Значения edit/focus/preview по-прежнему поддерживаются. Предпросмотр теперь использует button с aria-pressed вместо radio в группе режимов. Полный экран требует нажатия и включает навигацию и диалоги внутри корня приложения; без поддержки действие скрыто.

Language / Appearance

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

requestWorkspaceNavigation

Страницы с переключателем боковой панели скрывают дополнительную кнопку меню в шапке, включая свёрнутый и мобильный режимы. Редакторы и страницы без боковой панели сохраняют её. Импортируйте requestWorkspaceNavigation(returnFocusTarget?) и useWorkspaceNavigationState() из @qokit/components/patterns/WorkspaceNavigation: запрос переключает зарегистрированную панель и возвращает false, если она недоступна. Необязательный элемент получает фокус после закрытия. Проверяйте .available перед показом дополнительного входа. Используйте существующий переключатель или этот API вместо DOM-позиции удалённой кнопки.

WorkspacePanelReveal

Глобальная навигация использует значок меню, инструменты — направленные значки панелей. useWorkspacePanelReveal({ temporary: true }) временно открывает инструменты щелчком или клавиатурой в режиме фокусировки. toggle(trigger?) и close(true) сохраняют компоновку и режим и возвращают фокус. Край экрана открывает глобальную навигацию; инструменты реагируют возле своих кнопок. Предпросмотр скрывает переключатели панелей и предлагает явный возврат к предыдущему режиму редактирования.

EditorViewControls / Режим отображения

EDITOR_VIEW_SHORTCUTS → Tooltip + aria-keyshortcuts

EditorHeader также управляет EDITOR_TOOLBAR_SHORTCUTS: Command/Control+S вызывает видимый EditorSaveButton, Shift+P открывает EditorStatusAction shortcut="publish", Shift+M — меню инструментов. Команды используют те же доступные элементы, что и щелчки; публикация требует отдельного явного действия в панели. Отвечает только активный видимый заголовок. Подменю, диалоги, композиционный ввод и повторные события блокируют сочетания; в полях ввода разрешено только сохранение. Подсказки и aria-keyshortcuts используют общие определения. Собственный toolsControl задаёт aria-keyshortcuts={EDITOR_TOOLBAR_SHORTCUTS.tools.aria} на кнопке. ActionMenu.triggerKeyShortcuts добавляет атрибут и подсказку без регистрации глобальной команды.

Команды панелей: Shift+A (добавить), Shift+L (страницы/слои), Shift+K (диалог), Shift+C (содержимое), Shift+D (дизайн), Shift+G (общий стиль). CMS добавляет доступные Shift+S (настройки), Shift+E (SEO), Shift+H (история). Метаданные shortcut в EditorChoiceControl, EditorViewTabs, ActionMenu обеспечивают общие подсказки. EditorPanelChoiceShortcuts и EditorViewControls.compactActions сохраняют действия при сворачивании в меню, в том числе на телефонах. EditorPanelShortcuts.commands регистрирует существующие действия без дублирования элементов. Сохраняются ограничения скрытого, inert, отключённого состояния, предпросмотра и перекрытий. Немодальные мобильные боковые панели одной рабочей области допускают переключение; меню и модальные диалоги блокируют сочетания. Клавиши без модификаторов сохраняют прежнее поведение.

Режим отображения
EРедактирование
TРедактирование ↔ Фокус
VПредпросмотр / Вернуться к редактированию
FНа весь экран / Выйти из полного экрана

На клавиши реагирует только активный редактор. Ввод текста, композиция IME, удержание клавиш и открытые дочерние диалоги или меню не переключают режим.

PlatformHeader.workspaceNavigation

PlatformHeader.workspaceNavigation размещает глобальную навигацию перед логотипом; workspaceActions и editorActions сохраняют действия аккаунта. Рабочие области используют существующую кнопку боковой панели, а редакторы размещают кнопку правой панели перед аватаром. На узких экранах навигация, бренд, заголовок и аватар находятся над инструментами редактирования и сохранением. Порядок DOM соответствует раскладке; сохраняется эффект матового стекла без рамок.

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-07

SiteFooterLayout получает явно заданный locale и copy на одном языке. Серверные компоненты формируют общую структуру нижнего колонтитула; элементы выбора темы и языка и диалог QR остаются клиентскими компонентами. Существующие интерфейсы SiteFooter и PublicPlatformFooter по-прежнему поддерживаются.

import { SiteFooterLayout } from '@qokit/components/patterns/SiteFooter';

<div className="qk-platform-footer-shell">
  <SiteFooterLayout locale={locale} copy={footerCopy} />
</div>

Подготовьте междоменные ссылки в copy.companyLinks на сервере. Используйте controls для настройки области интерактивных элементов.

EditorHeader.titleControl / FloatingAssistant.presentation

EditorHeader.titleControl и EditorWorkspace.titleControl позволяют заменить заголовок общим меню проекта. Сохраните описательный title и защиту несохранённых изменений при переходах. FloatingAssistant.presentation="embedded" отображает именованную область внутри панели без плавающей кнопки и фонового перекрытия; по умолчанию используется floating. Хост управляет расположением и видимостью, помощник — состоянием диалога и разрешениями.

2026-09-07 · WorkspaceAssembly

WorkspaceAssembly отмечает уходящие карточки и входящие разделы, не добавляя контейнер. Если нужны прямые дочерние элементы, задавайте workspaceAssemblyAttributes(part, index, phase) существующему DOM. EditorHeader.assemble и BuilderWorkspacePanels.assemble предоставляют метки редактора.

Вызывайте await startWorkspaceAssembly(navigate, destinationPathname) только после успешного создания: снимки видимых частей, один переход и сборка назначения либо соответствующего каркаса загрузки за максимум 720 мс. Назначению нужна входящая метка canvas; useWorkspaceAssemblyPending() сохраняет экран загрузки до завершения размещения снимков, пока данные и код загружаются заранее. При уменьшении движения или отсутствии поддержки переход выполняется сразу. Медленные и прерванные переходы освобождают снимки и продолжают навигацию. Метки сами не анимируют правки, перезагрузку или историю. Общий шаблон очищает временные стили; ошибки создания, идемпотентность и загрузка остаются у приложения.

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

WorkspacePage и WorkspaceLayout принимают variant: overview, list, detail, settings или editor. WorkspaceFormFooter размещает переданные приложением actions, message, tone и busy; данные сохраняет приложение.

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

2026-09-08 · Task focus

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

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

EditorHeader.contextMode="title" displays the editor's own titleControl instead of the host workspace picker. The default "host" behavior is unchanged; navigation, brand, account controls and leave guards retain their existing ownership. Hosts supply responsive placement for their title control.

EditorViewControls.focusInMenu shows a labelled preview action and moves focus mode into the shared menu. Its default remains false; view shortcuts and returning from preview keep the existing behavior.

EditorViewControls.toolsControl replaces the fallback menu with a host-owned tools control. Hosts retain its accessible trigger, menu state and actions; view buttons and keyboard shortcuts keep their existing behavior. Creator uses this slot for its complete editor tools menu beside Add, Layers and Preview.

EditorViewControls.responsiveLabels displays text beside focus and preview icons above 720px, reserving space for both focus labels. At phone widths the labels are hidden while accessible names and tooltips remain. EditorSaveButton.showStatusLabel displays saved/saving status or a retry action when state is provided; it reserves label space across states. Both options default to false.

ResizablePanels.middlePanelProps forwards section attributes such as inert to the middle panel, matching the existing side-panel attribute slots. An editor can keep its canvas mounted while preventing keyboard and pointer interaction when a compact conversation view covers it. Hosts still control panel visibility and restore focus when switching views; the prop does not unmount content.

ProjectSwitcher.currentWorkspaceId optionally marks the parent workspace independently of currentProjectId; only the current location receives the selected surface. IDs must match the supplied projects items. onActionSelect(action, event) lets the host guard shortcut navigation after the menu closes; omitted callbacks retain normal link behavior. Creation shortcuts use ordinary menu surfaces. Optional SiteHeaderCopy.projectSwitcherCreate and projectSwitcherWebsites label creation and the current workspace's website group without renaming the Creator product.

AccountDropdown.usageSummary is an optional slot below the account identity for host-supplied credit balances, plan usage and links to details. It also accepts ({ environmentInfo }) => ReactNode to place the shared ID disclosure and copy controls in the summary without duplicating them below. Links use role="menuitem" and retain menu keyboard behavior and navigation guards. The platform header shows credits and plan usage in two columns, with ID details expanding below; the sidebar account retains appearance and language. Failed reads never appear as zero, and reopening the menu refreshes the data.

PublicPlatformHeader.workspaceAction optionally supplies { href, label } for an authenticated visitor's return link. It replaces the desktop login icon and stays visible beside the mobile menu; the mobile menu then omits anonymous account actions. Session detection belongs to the host. The platform home uses a lightweight local session check, updates after focus/storage changes, and keeps ?view=public on its brand link so explicit website visits survive refresh.

contextAfter places editor-specific scope controls after the host project picker, preserving their DOM and keyboard order. The host retains project navigation and leave guards; the editor owns page and content-language selection. Hosts may adapt the responsive layout to put this context on its own row.

WorkspaceNavigationMenu.footerLinks supplies direct icon links alongside the sidebar display control. footerMenus accepts ordered WorkspaceNavigationFooterMenu entries, each with a label, icon and link items (with optional separatorBefore). The platform uses one menu for Website Home, Pricing, Templates and News, and a book-icon Help & Support menu for the user manual and contact support. The single footerMenu prop remains supported when footerMenus is omitted. Desktop menus open upward with ActionMenu placement="top" portal; mobile uses bottom sheets. The controls form one row when expanded and a column in icon mode; on mobile the sidebar control closes the navigation drawer. Each icon retains an accessible name and tooltip. profile adds the user name, plan and account menu without duplicating an existing sidebar account. Omitting footer links and menus retains the existing preferences and fullscreen actions.

Set a footer menu item's newTab to open a reference destination with target="_blank" and rel="noopener noreferrer". The skeleton adds a trailing arrow and localized screen-reader notice; other items keep current-page navigation. Website Home, Pricing, Templates, News, the manual and contact support use new tabs so the workspace stays open. An explicit public-home visit preserves ?view=public to bypass the signed-in landing redirect, including after refresh.

Editor tool palettes can use Dialog with keepMounted to preserve search and form state while closed. Closed dialogs immediately become inert, hidden from assistive technology, and leave the focus stack, including during a visual exit transition; the default still unmounts their content. Pair nonmodal palettes with DialogPanel to reuse the global overlay surface. Toolbar accepts a DOM ref for bounded positioning while retaining its shared arrow-key navigation.

useFloatingSurface from @qokit/components/patterns/FloatingTools supports defaultHeight: 'auto' for content-sized palettes. Keep the host body shrinkable with internal scrolling; the hook caps the surface to its workspace bounds and observes size changes. Moving an automatic palette stores its position without freezing the measured height. Resizing explicitly stores a fixed height, including across reloads; reset() or Home on a movement/resize handle restores automatic sizing. Numeric defaultHeight retains the existing fixed-height behavior.

FloatingToolPanel composes the shared DialogPanel, TreeToggle, pin button, tooltip and close button. Place it inside a nonmodal Dialog; the host controls pinned, collapsed, their callbacks and document operations. Pinning keeps the palette open after an operation; it does not lock its position. The title and header whitespace accept useFloatingSurface().dragHandle, while buttons, menus and inputs never initiate dragging or folding. Double-click the title or whitespace to fold; the explicit fold button supports keyboard and touch. Folding hides the body without unmounting it, preserving searches and tree state. Pass the same collapsed value to useFloatingSurface to retain the expanded height while moving the folded header. Optional actions and skin slots reuse the same structure; styles stay in the shared stylesheet.

Optional FloatingToolPanel.viewKey adds a short opacity transition when the active tool changes, without replacing its body instance. Ordinary parameter updates do not animate. Opening, closing, unfolding and pin feedback share the existing motion Tokens and respect reduced motion. Dragging stays direct; useFloatingSurface coalesces pointer movement to one geometry update per animation frame and saves the final position on release. Browsers without discrete display transitions close immediately.

Unified editors pass focus={false} to omit the separate Focus control. primaryActions accepts shared tool buttons before Preview; onTogglePanels handles T, and onToggleAllPanels handles Shift+T. Creator uses T to cycle from visible panels to floating launchers to fully hidden and back to the last visible layout; ordinary launcher clicks still open their panel. Shift+T directly hides everything and restores the exact preceding state. Both sidebar shortcuts are inactive in Preview and respect editable targets and active overlays. Existing hosts keep Edit/Focus behavior by default.

useWorkspacePanelVisibility().togglePanels hides the visible editor panels or restores their preceding layout. Desktop and compact layouts are remembered independently, and forceCollapsed (for example during Preview) does not overwrite that memory. The host owns global navigation visibility and any edge launchers.

For floating editor panels, pass skin: platformWorkspacePanelRevealSkin from @qokit/components/skins/platform and spread the returned panelProps onto the existing panel. The skin applies only while revealed; the docked panel and its mounted content remain intact. ResizablePanels merges startPanelProps, middlePanelProps, and endPanelProps class names with its own skin slots. Pair focus controls with Toolbar and platformFloatingToolbarSkin for shared keyboard navigation and compact spacing. Both skins share the global DialogPanel surface (background, shadow and blur); panel corners use the card radius and toolbar corners use the control radius. Hosts own positioning and available space, not a separate overlay palette.

useWorkspacePanelEdgeDrag is an opt-in hook for an existing workspace root ref. Mark its focusable borders with data-workspace-panel-edge="start" or "end"; ResizablePanels supplies these attributes on its own separators. The host provides each side's mode (expanded, icons, hidden), saved width and bounds through getState, applies onChange, and returns a rollback callback from onBegin. onResizing should suspend layout transitions; onFinish restores focus to the resulting control, and onReset restores the host's default width. One captured mouse or touch gesture crosses all three states, with RTL direction handling and cancellation on Escape, pointer cancellation or window changes. Arrow keys resize or step states, Shift increases the step, Home/double-click resets, and End expands to the allowed maximum. This hook adds no visual controls or stored content. Hosts can pair hidden borders with useWorkspacePanelReveal for temporary shortcut access while retaining their normal click actions; hosts without the hook keep existing resizer behavior.

FloatingAssistant.headerActionsTarget optionally accepts an HTMLElement in the host heading. The assistant portals its existing conversation history and new-conversation controls into that element and omits its internal header. Without a target, the original header remains. The host owns the heading and placement; the assistant retains action handlers, accessibility labels and conversation state. The Web adapter forwards this slot.

FeatureHint is exported from @qokit/components/patterns/FeatureHint. Use it for contextual first-use guidance attached to a real control. Provide a versioned id, a stable user scopeKey, an anchor: HTMLElement, an active eligibility signal, localized title, description, dismissLabel, and action: { label, onClick }. Set completed when the user discovers the capability independently. A null scope or unavailable anchor suppresses the hint.

The shared component allows one hint at a time, waits briefly for a visible target, follows scrolling and resizing, supports RTL, and keeps content inside the viewport. It does not add a backdrop, steal focus, or perform the action automatically. Escape, the close button, or clicking elsewhere dismisses it; Tab from the target reaches the action. The target receives a temporary highlight and accessible description. Seen hints are remembered in the current browser per scope and version, with an in-memory fallback if storage is unavailable; this is not cross-device progress. Hosts own permissions, review-state suppression and the actual action. skin, className and style adapt presentation.

AssistantContextCard is exported from @qokit/components/patterns/FloatingAssistant. Place it in composerContext to summarize the current editing target. Its typed contract includes title, description, scope, preview, parameters: { id, label, value }[], optional controls, status and notice, plus actions, onLocate and clearAction. Pass localized labels and formatted values, including units, from the host.

The card renders a read-only definition list, an optional controls slot for a few common adjustments, and a live status region. Reuse the host’s existing editing controls and commands in this slot; keep complete settings behind an explicit action that opens the existing inspector. Hosts retain ownership of selection, permissions, save, undo and AI requests. Conversation, canvas editing and inspector editing can operate together, with independent panel visibility. Selecting an object updates the card and an already open inspector without opening a closed panel or moving focus. Removing a conversation reference preserves canvas selection and direct editing; keep the conversation entry independent of this card and of floating-tool visibility. Changing the target or a parameter updates this live card without appending chat messages. Both draft and project conversations can use the same component. className, style and AssistantContextCardSkin support visual adaptation; styles are loaded with the component.

FloatingAssistantPanel.composerContext 接收输入框上方的实时上下文区域。提供此插槽时,顶部旧的 activeContext 摘要隐藏,activeContext.promptPlaceholder 仍供输入框使用。实时参数属于当前编辑状态,不应追加到历史消息列表;Web 适配器透传此插槽。

Hosts can set hoverReveal={false} to disable navigation previews from the trigger and window edge while retaining explicit controls and drag resizing; the default remains true.

WorkspaceNavigationDock prefetches same-origin destinations on mouse hover or keyboard focus, with bounded deduplication.

Web-адаптер также передаёт FloatingAssistantPanel.composerAttachments. Слот показывает вложения, управляемые приложением, внутри формы сообщения перед текстовым полем. Приложение отвечает за размещение и отправку: перетаскивание лишь готовит вложение, успех удаляет только отправленное вложение, а ошибка сохраняет его для повтора.

Общие компоненты диалога (справка на английском; перевод ожидается)

@qokit/components/patterns/Conversation exports ConversationPanel, ConversationMessages, ConversationMessage, ConversationSuggestions and ConversationComposer. Creator generation, draft refinement and the embedded project assistant use these structures and the same token-based stylesheet. Hosts own requests, history, permissions, selected objects and review/apply actions.

ConversationFeedback использует InlineNotice для компактного отображения состояния задач, ошибок, резервных вариантов и подтверждений сохранения в диалогах. Передайте локализованный title и при необходимости description, tone и action. Обе строки используют размер шрифта подписи, небольшой интервал и прозрачную поверхность; цветовой тон выделяет состояние, а вспомогательный текст остаётся приглушённым. Значения по умолчанию role="status" и aria-atomic="true" обеспечивают совместное озвучивание всего обновления; используйте role="alert" для ошибок, требующих действий. Текст, написанный ассистентом, остаётся в ConversationText.

Place the scrollable ConversationMessages and the fixed ConversationComposer directly inside the panel. Supply a localized label for the messages region and inputProps for the controlled textarea. The composer accepts attachments, notice and actions slots, plus formProps and formRef; it creates the form, so do not nest it in another form. Enter inserts a newline; Cmd/Ctrl+Enter requests submission with composition and disabled/busy guards. Preserve user input while a request is running when the host supports it.

PromptPanel.presentation="conversation" reuses the composer while retaining reference reading, upload/menu controls and serialized form fields. The default "prompt" preserves the landing-page prompt behavior. FloatingAssistant.presentation="embedded" uses the shared panel, messages, suggestions and composer; floating assistants retain their compact presentation.

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

2026-10-10 · Pagination dot display

Pagination from @qokit/components/ui accepts pageDisplay="dots" for compact visual choosers. Combine it with layout="centered" for centered arrows and 6px indicators with 32px-wide click targets. Dot colors, hover and keyboard focus use shared theme Tokens; PaginationSkin.dot adapts the indicator slot. Hosts supply currentPage, totalPages, onPageChange and localized navigation labels. pageLabel names each dot; its fallback combines ariaLabel with the page and total. Browsing pages only invokes the host callback. The default "numbers" display retains numeric pagination and formatPageNumber.

2026-10-10 · ActionMenu search header

ActionMenu.dropdownHeader accepts host-owned content before the actions in both dropdown and mobile sheet presentations. onOpenChange reports opening and dismissal so hosts can reset transient search state. Search hosts supply localized copy, filtering and initial input focus; ArrowDown from the input should focus the first enabled result, then the shared menu handles result navigation, selection and Escape.

2026-10-09 · Inline ColorPicker

ColorPicker from @qokit/components/ui/ColorPicker accepts presentation="inline" to expand its editor beneath the field trigger. It renders a named group in the document flow, keeps the surrounding workspace available, and retains palette, HEX, opacity, gradient and reset capabilities. Hosts should reserve a full row for the field. Changes to the controlled value, including undo and reset, update the open inline editor; leaving the field finishes the current edit. The default "popover" presentation retains its portal, outside-click dismissal and Escape behavior.

2026-10-07 · WorkspacePanelGrid

WorkspacePanelGrid from @qokit/components/patterns/WorkspaceLayout places independent detail panels below the shortest available column. It responds to content and container size changes without moving or remounting child nodes; DOM and keyboard order remain unchanged. Narrow containers use one column. Keep continuous panels in one grid rather than separate rows. Metrics, tables, paired fields and ordered workflows retain their own layouts.

Each direct child is a panel. Use data-workspace-panel-span="full" or a numeric column span on that child's root for wider panels. The optional skin has a root slot and variables; --qk-workspace-panel-grid-gap controls shared spacing, and --qk-workspace-panel-grid-max-columns defaults to 2. Without JavaScript or ResizeObserver, panels retain the responsive ordinary grid.

2026-10-08 · Shared list toolbar groups

WorkspaceFilterToolbar now has one container-responsive contract across Projects, CMS and Admin:

  • query: search, filters состояния, sort, предметные controls, параметры advanced, условный reset, result ресурса и вспомогательная summary.
  • presentation: view, отображайте controls и options, такие как видимые столбцы и размер страницы. Настройка виджетов страниц принадлежит действиям заголовка страницы.
  • actions: persistent operations, followed by the optional selection control at the logical end. Use ToolbarButtons with icon and localized compactLabel for refresh and other familiar actions.

The shared component measures its own available width. Controls show icons with labels above 960px and accessible icon buttons at or below 960px. At or below 640px, search occupies the first row and tool groups wrap in query → presentation → actions order. Routes must not override group widths or hide individual labels. ControlMenu and ViewMenu inherit this presentation without a route-specific responsive flag.

Используйте query.result={{ label, count, total?, locale? }} для имени ресурса и числа результатов. WorkspaceResultSummary выводит «Имя · количество» и добавляет «/ всего» только при отличающемся достоверном общем числе без фильтра; числа форматируются по языку интерфейса и изолируются в двунаправленном тексте. Пока количество неизвестно, опускайте result; ноль допустим. Не добавляйте над тем же списком вторую строку имени и количества. AdminFilterBar.result принимает тот же объект. Заголовки, значимые разделы, пагинация и число выбранных объектов сохраняют свои роли; query.summary служит другим единицам, контексту запроса или сведениям об обновлении.

Give overflow a localized label to move advanced and display options into More when compact. query.compactItems and presentation.compactItems supply complete menu choices replacing their corresponding controls; controlled values and callbacks remain in the host. Permanent menu actions use overflow.items. Selection and refresh stay outside More. Select and Done share the end slot, hit target and reserved idle toolbar height, including wrapped mobile rows.

This replaces the old flat toolbar API: migrate search, filters, sort, reset and secondaryControls into query; migrate view and display controls into presentation; move persistent endActions to actions. The former adaptive / inline-wrap CSS modes and WorkspaceFilterControlGroup capsule are removed; use these three semantic groups rather than compatibility aliases.

2026-10-10 · EditorItemDisclosure

EditorItemDisclosure from @qokit/components/patterns/EditorItemCollection accepts title, summary, open, onOpenChange, leading, actions and children for editing within a list. Sibling items remain visible. Escape collapses the item and restores trigger focus; opening does not scroll or autofocus. useEditorItemDisclosure scopes single-item expansion with scopeKey and restores adjacent focus after deletion. EditorItemCollection uses the same interaction; hosts still own content, ordering, persistence and undo. The existing EditorFocusedItem export remains available for flows that require a separate detail view.

Дополнение к справочнику API (английский, перевод ожидается) · 2026-10

2026-10-15 · Shared inspector choices

EditorStyleChoice uses the shared EditorChoiceControl for finite settings. In auto mode, two or three illustrated options use a segmented group; larger illustrated sets use a portalled ControlMenu showing the current icon and name. Text-only choices retain a native Select. Existing custom values remain selectable.

Параметр annotation добавляет к вариантам выбора и пунктам меню точку цвета темы и включает локализованное пояснение в доступное имя. Кнопка ControlMenu также показывает точку текущего варианта; triggerAnnotation: null оставляет её только в меню. Повторный выбор доступного выбранного пункта вызывает onReselect. Нативные варианты показывают пояснение рядом с подписью; hidden исключает заполнитель из списка. Хост определяет отмеченный вариант и действие; общий компонент не выводит наследование и не записывает данные.

Use presentation="visual" for labeled diagram choices and presentation="toolbar" for familiar tools such as four-way text alignment. The toolbar has separate targets without a shared capsule. Native radios, shared menu keyboard handling, visible focus, disabled states and theme Tokens are retained. Hosts own labels, allowed values, persistence and undo. id identifies the control; ControlMenu also accepts triggerId and disabled.

Inspector menus, inputs, collapsed summaries and reset actions share a 32px mouse field height, restored to 40px on narrow screens and coarse pointers. Field icons use 16px and diagram choices keep an 8px gap. EditorComponentSettings reuses these choices for columns, density, image fit and aspect ratio, while composition layouts retain detailed previews. If saving briefly disables native radios, the shared skeleton restores focus to the selected option for continuous arrow-key editing.

Inspector labels and diagram captions use the 12px caption scale; values, actions and section titles use the 13px field scale. Visual choices have no decorative outer border: a soft selected surface and centered caption identify the current option, while keyboard focus retains its ring. Font specimens in the inspector use a compact, bounded scale.

2026-10-15 · Responsive workspace tables

WorkspaceDataTable reflows mobileLayout="records" into two columns of labeled facts, with the primary identity and sticky end actions spanning the record. Names and identifiers can use two lines. Column labels and selection remain accessible. Comparison tables using mobileLayout="scroll" retain their columns.

When a host toolbar already provides sorting or other header actions, set mobileHeader="labels" to remove duplicate header controls from the mobile layout and tab order. Column names remain available to assistive technology; desktop headers are unchanged. The default "controls" preserves custom header controls on mobile.

2026-10-14 · Independent editor panels

resolveWorkspaceResponsiveProfile and useWorkspaceResponsiveProfile from WorkspacePanels, and EditorWorkbenchChrome, accept the optional panelPolicy="independent". With BuilderWorkbenchFrame and the platform editor skin, both panels remain docked above the mobile threshold. Shared styles temporarily compress displayed widths while retaining remembered sizes, and the canvas fits the remaining space. Effective work areas at or below 720px retain mobile task switching.

Hosts own panel visibility. When supplying a measured profile, use the same policy for the measurement hook and Chrome. Omitting panelPolicy retains the default "adaptive" policy with its existing desktop, two-column and overlay layouts.

Editor workspace integration

workspaceNavigation connects the host's shared business navigation through EditorWorkbenchChrome: desktop navigation reserves space beside the content, while mobile uses the shared drawer. It is separate from the document structure panel navigation and retains the host's permissions and unsaved-change protection.

EditorSaveButton.showIcon keeps the save glyph beside its label. iconOnly reduces the control to an icon while retaining an accessible action and status name and tooltip. Editor hosts can use useCompactWorkspaceHeader() to show icons and labels in roomy layouts and icons alone in compact layouts. EditorStatusAction.iconOnly follows the same rule while retaining its issue count.

2026-10-15 · EditorControlGroup title actions

The headerActions slot on EditorControlGroup remains visible in both expanded and collapsed groups, for actions such as content visibility beside a group title. Pointer and keyboard interactions with these actions do not toggle the group. summaryActions still appears only when collapsed. Hosts own action names, state and persistence; icon actions must use the shared IconButton with a localized accessible name.

2026-10-14 · Management groups and summaries

WorkspaceSectionGroup, WorkspaceSection, WorkspaceFieldGrid and WorkspaceFacts are exported from @qokit/components/patterns/WorkspaceLayout. Headings and descriptions sit above their content panels on both desktop and mobile, sharing the starting edge. Use the default stacked layout; legacy layout="split" callers also render stacked. Apply qk-workspace-section-group__form to forms within a group to share spacing and save-area alignment. WorkspaceSection accepts optional icon, actions and description slots, keeping headings outside the content panel.

WorkspaceFieldGrid arranges independent short fields in at most two columns according to available width. WorkspaceFacts renders a semantic definition list with stable id, label, value, and optional unit, description, emphasis and tone. columns supports 2, 3 or 4 columns and adapts to narrow containers. Set mobileColumns={2} for short numeric summaries that should retain two columns on phones; the default is one. It is unboxed so summaries can share an existing content panel. Each component supports its named Skin, className and style. Hosts retain form state, permissions, submission, conflicts and recovery; these components do not make requests.

2026-10-14 · Management content panels and disclosures

WorkspaceContentPanel and WorkspaceSection.kind support summary, form, records, and actions. Section toolbar stays outside the content surface; supporting and footer provide compact metadata and end operations. titleId preserves existing heading anchors. The default panel container does not override a host's named container.

Use WorkspacePanelBlock, WorkspacePanelMeta, and WorkspaceRecordRow for subordinate groups, metadata, and repeated records. A record accepts title, description, meta, status, actions, and full-width detail children. Facts always align at the top. Hosts retain business fields, permissions, table columns, and submission boundaries.

WorkspaceActionRow accepts an optional action label or quiet empty/loading status, alongside description and actions. Action identity uses 14px semibold text, status uses 14px regular text, and descriptions use 12px. Copy and controls share a center line on desktop and stack at narrow widths. Card surfaces do not override descendant strong typography or spacing.

WorkspaceDisclosure accepts title, optional status, and children; WorkspaceDisclosureGroup accepts Accordion items and controlled expansion props. They start closed unless the host specifies an initial item, and open at most one sibling. Enter/Space toggles; Escape closes and returns focus to its trigger, handling inner disclosures before their parent. Hidden panels retain their DOM and input state. Optional headingLevel supplies section heading semantics; Skin and class slots only adapt appearance. Import these components from @qokit/components/patterns/WorkspaceLayout.

CustomizableWidgetLayoutControls / CustomizableWidgetLibrary

Разместите CustomizableWidgetLayoutControls в действиях заголовка страницы после контекстной справки и перед основным действием, включая мобильную версию. Используйте локализованный copy.customize, чтобы явно назвать действие (например, «Настроить виджеты»). Тот же самый вход только с иконкой открывает aria-pressed и aria-expanded и становится copy.done во время редактирования. customizeButtonRef опционально экспонирует триггер для восстановления фокуса хоста; disabledCustomize отключает вход, не изменяя его геометрию. Передавайте onCollapseToggle и areWidgetsCollapsed только для хостов, поддерживающих сворачивание виджетов; их отсутствие оставляет только точку входа настройки.

CustomizableWidgetLibrary владеет общей заголовочной частью библиотеки, действиями сброса/закрытия, адаптивной прокруткой, начальным фокусом кнопки закрытия и обработкой Escape. Закрытие возвращает фокус вызвавшему элементу управления, если фокус все еще находится внутри библиотеки; клики вне библиотеки сохраняют свое назначение фокуса. Хосты хранят определения виджетов, команды добавления/удаления/порядка/изменения размера, сохранение состояния и семантику сброса. Слоты классов CMS и Admin остаются доступными для доменных хуков, но не должны определять отдельные поверхности библиотеки или макеты для мобильных устройств.

17.10.2026 · Расширенные триггеры ActionMenu

ActionMenu.renderTrigger может использовать расширенный элемент управления, такой как SelectableTile. Он принимает aria-expanded, aria-haspopup, disabled и onClick; передайте их в реальный триггер. Хост сохраняет семантику выбора и внешний вид элемента управления. Позиционирование портала, навигация по меню с клавиатуры, закрытие, возврат фокуса и необязательные мобильные панели остаются под управлением ActionMenu. Триггеры для стандартной кнопки и иконки не изменены.

Элементы управления радиусом и диапазоном

RangeNumber из @qokit/components/ui/RangeNumber объединяет нативный ползунок и точный числовой Input. Передайте label, value, min, max, необязательные step и unit, а также onChange. Неопределённое значение отображается как прочерк смешанного значения; изменение любого поля задаёт одно число в пределах диапазона. onCommit позволяет объединять непрерывные изменения в существующей истории отмены приложения. disabled, клавиатурная навигация, компактность, RTL и стили фокуса общие; сохранением управляет приложение. RangeNumberSkin предоставляет слоты корня, ползунка, поля и единицы.

EditorRadiusControl из @qokit/components/patterns/EditorRadiusControl объединяет предварительный просмотр формы, четыре поля физических углов, RangeNumber и необязательные шаблоны формы. value и onChange используют сокращённую запись CSS border-radius; приложение переводит cornerLabels и названия шаблонов. В RTL порядок остаётся таким: верхний левый, верхний правый, нижний правый, нижний левый. max ограничивает редактирование пикселями в заданных пределах; без него сохраняются единицы CSS и синтаксис эллиптических углов. Смешанный радиус не показывает одно число до совместной настройки всех четырёх углов. Необязательный EditorRadiusControlSkin меняет слоты корня, схемы, просмотра и шаблонов, не затрагивая состояние или сохранение.

2026-10-22 · Активные вкладки на узких экранах

PillTabs принимает необязательный параметр scrollActiveTabIntoView со значением по умолчанию false. Для горизонтальных вкладок он показывает активного прямого потомка PillTabLink или PillTabButton при выборе и изменении размера. Прокручивается только полоса вкладок; положение страницы и фокус клавиатуры не меняются. Поддерживаются LTR и RTL с мгновенной коррекцией, в том числе при уменьшении движения. Вертикальные вкладки и вызовы без параметра сохраняют прежнее поведение.

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

Интеграция компонентов2026-10-20 · Независимые действия карточек визуального выбора17 октября 2026 г. · Общая анимация панели рабочей области17 октября 2026 г. · Измеряемые значения по умолчанию редактора2026-09-30 · Доступность SelectionToolbar2026-09-10 · Значки идентификации рабочего пространства2026-09-08 · EmptyState2026-09-08 · SidebarNavigation2026-09-07 - AccountDropdown / SidebarProfile2026-09-07 - FormField / AdminEntityDialog / EditorWorkspace2026-09-07 · WorkspaceLocationSync / ProjectSwitcher2026-09-07 · Единая навигация и скруглённые поверхности Qokit2026-09-07 - ColumnLayoutТочки входа для импортаГраницы общих обязанностейГенерация содержимого элементовЭлементы формВыбор в спискахКарточки показателейНовая документация API (на английском; перевод ожидается) · 2026-10Header и Footer платформыСтратегия совместимостиПолноэкранное редактированиеSidebarToggleSlotEditorHeaderEditorNavigationMenuWorkspaceNavigationMenu / WorkspacePageHeaderEditorViewControlsLanguage / AppearancerequestWorkspaceNavigationWorkspacePanelRevealEditorViewControls / Режим отображенияPlatformHeader.workspaceNavigation2026-09-06 - EditorHeader.preview / EditorViewControls.returnView2026-09-06 · Builder / CMSНижний колонтитул с серверным рендерингом · 2026-09-07EditorHeader.titleControl / FloatingAssistant.presentation2026-09-07 · WorkspaceAssembly2026-09 · Рабочие области управления2026-09-08 · Task focusНовая документация API (на английском; перевод ожидается)Общие компоненты диалога (справка на английском; перевод ожидается)Новая документация API (на английском; перевод ожидается) · 2026-102026-10-10 · Pagination dot display2026-10-10 · ActionMenu search header2026-10-09 · Inline ColorPicker2026-10-07 · WorkspacePanelGrid2026-10-08 · Shared list toolbar groups2026-10-10 · EditorItemDisclosureДополнение к справочнику API (английский, перевод ожидается) · 2026-102026-10-15 · Shared inspector choices2026-10-15 · Responsive workspace tables2026-10-14 · Independent editor panelsEditor workspace integration2026-10-15 · EditorControlGroup title actions2026-10-14 · Management groups and summaries2026-10-14 · Management content panels and disclosuresCustomizableWidgetLayoutControls / CustomizableWidgetLibrary17.10.2026 · Расширенные триггеры ActionMenuЭлементы управления радиусом и диапазоном2026-10-22 · Активные вкладки на узких экранах