Skip to Content
Projektowanie

Integracja komponentów

Publiczny kontrakt integracyjny dla udostępnianych komponentów, wzorców, Skin oraz tokenów stylów Qokit.

Integracja komponentów

Qokit wykorzystuje model „wspólny szkielet + receptura Skin”. Integratorzy zewnętrzni polegają na semantycznym kontrakcie i interakcjach komponentów, realizując dostosowanie wizualne poprzez Skin i Tokeny.

2026-10-20 · Niezależne działania kart wyboru wizualnego

Opcje EditorVisualChoiceGroup przyjmują opcjonalne accessory dla niezależnych menu kart lub edytorów nazw. Wspólny RadioGroup umieszcza je obok natywnej etykiety, więc zarządzanie kartą nie aktywuje jej wyboru. afterOptions dodaje po opcjach osobne działanie katalogu, np. utworzenie karty. Zapis, uprawnienia, walidacja i fokus po zastąpieniu lub usunięciu należą do hosta. Opcje bez dodatków zachowują strukturę i zachowanie.

2026-10-17 · Wspólny ruch panelu warsztatu

EditorWorkbenchChrome renderuje wstrzyknięte pasma start/koniec przez BuilderWorkbenchFrame, ten sam szkielet panelu używany przez Creator i edycję treści. Hosty dostarczają treść, widoczność i preferencje szerokości. Desktop śledzi i dzieli przejrzystość panelu/translacje z --qk-sidebar-motion-duration i --qk-sidebar-motion-easing; przeciąganie wyłącza przejścia, a tryb zmniejszonego ruchu przełącza się natychmiast.

Zwijane panele pozostają zamontowane, aby zachować szkice. Wspólna ramka natychmiast stosuje inert i aria-hidden, podczas gdy skóra platformy kończy wyjście przed ukryciem widoczności. Kompaktowe panele zachowują swoją geometrię nakładki przez cały czas wyjścia; hosty nie muszą dodawać hidden ani display: none do powłoki panelu. Jawne panele peek zachowują istniejące interaktywne zachowanie ujawniania. Wybory nagłówka pozostają dostępne w stanach otwartym/zamkniętym; użyj EditorPanelChoiceShortcuts.mobileMenu, gdy miejsca docelowe na telefonie powinny udostępniać menu.

2026-10-17 · Domyślne wartości edytora z pomiarem

useWorkspaceResponsiveProfile akceptuje opcjonalne onWidthChange(width), raportując tę samą dostępną szerokość obszaru roboczego używaną dla profili responsywnych po odliczeniu wewnętrznych wypełnień. Użyj stabilnego callbacka do wyprowadzenia proporcjonalnych wartości domyślnych bez dodawania kolejnego obserwatora. useEditorLayout stosuje sharedWidths.limits do preferencji hosta oraz wspólnej pamięci szerokości; readEditorLayout akceptuje te same limity jako swój opcjonalny czwarty argument. Istniejący wywołujący zachowują swoje domyślne granice i zachowanie.

2026-09-30 · Dostępność SelectionToolbar

SelectionToolbar.ariaLabel opcjonalnie nadaje paskowi narzędzi nazwę regionu. Licznik pozostaje komunikatem stanu na żywo. Host dostarcza przetłumaczone etykiety i może użyć actionContent do wspólnych komponentów EditorToolGroup i ActionMenu; sprawdzanie uprawnień i obsługa działań pozostają po stronie hosta.

2026-09-10 · Identyfikatory obszaru roboczego

ProjectSwitcherProject.badge przyjmuje opcjonalną, nieinteraktywną zawartość React. Identyfikator jest wyświetlany obok nazwy każdego elementu, w wierszu bieżącego kontekstu nieobecnego na liście oraz obok bieżącej nazwy w wyzwalaczu tekstowym. Wyzwalacze tylko z ikoną pozostają zwarte; tekstowe wyzwalacze platformy ukrywają identyfikator przy szerokości telefonu, aby zachować miejsce na nazwę obszaru. Otwarte menu nadal go pokazuje. Host dostarcza dane o właściwym zakresie, zlokalizowane etykiety i style prezentacji; pominięcie pola zachowuje dotychczasowy wygląd.

2026-09-08 · EmptyState

EmptyState centruje opcjonalną dekoracyjną ikonę icon, title, opcjonalny description i action na przezroczystym tle. layout="section" jest domyślnie zwarty; layout="workspace" rezerwuje więcej miejsca. Umieść działania bezpośrednio w action, używając fragment dla wielu przycisków; kontener obsługuje odstępy i długie etykiety. Tytuł to h2: używaj slotu title zamiast strong. Klasy główne pozostają; obsługiwane są skin.vars i style. Host zarządza tłumaczeniami, uprawnieniami, nawigacją i tworzeniem; wyszukiwanie i błędy zachowują własne komunikaty i działania.

2026-09-08 · SidebarNavigation

SidebarNavigation wstępnie ładuje trasy tego samego źródła po 180 ms zatrzymania kursora lub po fokusie klawiatury. Nawigacja stała i wysuwana współdzielą limit 8 celów na 30 sekund. Ładowanie zatrzymuje się offline, w ukrytych kartach, przy Save-Data lub 2G; pomija pobieranie plików, wyłączone linki, nowe okna i kotwice tej samej strony. Nawigacja i ochrona zmian pozostają bez zmian.

2026-09-07 - AccountDropdown / SidebarProfile

AccountDropdown obsługuje opcjonalne compact i preferences: tryb kompaktowy ukrywa identyfikatory i historię tworzenia; domyślnie zachowuje istniejącą zawartość. Appearance i Language przyjmują triggerRole="menuitem" w menu konta. Nawigacja klawiaturą przywraca fokus, a zagnieżdżone okna języka samodzielnie obsługują Escape. SidebarNavigation.searchEnabled domyślnie ma wartość true; użyj false dla krótkiej, stałej nawigacji. SidebarProfile z href, bez menu, otwiera ten sam cel w trybie rozwiniętym i ikon.

2026-09-07 - FormField / AdminEntityDialog / EditorWorkspace

Formularze używają wspólnej skali pisma i zawijają długi tekst, zachowując kształt kapsułek i kolory marki. FormField nazywa grupy: controlId oraz wewnętrzna id łączą etykietę. SearchField przywraca fokus po wyczyszczeniu. Segmented i ControlMenu obsługują wyłączone opcje; wyłączone elementy ActionMenu nie mają linku. Zajęte przyciski zachowują rozmiar i wskaźnik. AdminEntityDialog sprawdza pola wymagane, e-mail i JSON, skupia fokus na błędach, blokuje podwójny zapis i zachowuje dane po błędzie. EditorWorkspace oferuje ref.focusControl(element) do pokazania ukrytych paneli przed ustawieniem fokusu. Ograniczony ruch wyłącza przejścia kontrolek. WorkspaceDialog przewija długą treść z widocznym nagłówkiem i działaniami; krótkie okna mobilne dopasowują wysokość do treści.

2026-09-07 · WorkspaceLocationSync / ProjectSwitcher

Po zakończeniu zmiany trasy WorkspaceLocationSync zamyka tymczasowy panel wyboru przestrzeni i pokazuje narzędzia strony docelowej. Preferencje wyszukiwania i sekcji pozostają zachowane. Nazwa zakresu i kontekst zajmują osobne wiersze; długie nazwy w nagłówku są skracane w obrębie przycisku.

2026-09-07 · Wspólna nawigacja i zaokrąglone powierzchnie Qokit

WorkspaceNavigationDock korzysta z nawigacji i uprawnień gospodarza przez items, fallback, className i onClickCapture, bez dodatkowej sesji. Zachowuje ustawienie rozwinięcia, ikon lub ukrycia; do 860px używa wysuwanego menu. PlatformHeader.leadingContext trafia także do EditorHeader. Przyciski kapsułkowe i zaokrąglenia pozostają, powtarzające się obramowania znikają.

Na komputerze kliknięcie menu ukrywa pasek boczny lub przywraca ostatni widoczny tryb. Przeciąganie menu lub krawędzi paska przełącza między ukryciem, samymi ikonami i rozwinięciem. Strzałki w lewo i w prawo uwzględniają kierunek tekstu. Anulowanie przeciągania zachowuje zapisane ustawienie; na telefonie pozostaje panel nawigacji.

Zamontuj WorkspaceLocationSync raz pod Suspense w układzie Next. useWorkspaceQueryState(key, defaultValue, validate) zwraca [value, setValue, ready]; useWorkspaceQueryRecord(key, defaults, validators) odtwarza tylko zadeklarowane płaskie filtry. Nie zapisuj danych logowania ani szkiców w URL. WorkspacePage przywraca ograniczoną pamięć przewijania sesji; obszary wewnętrzne używają data-workspace-scroll-region i WorkspaceScrollRestoration. Anulowalne natywne przejścia wstecz/dalej korzystają z ochrony wyjścia bez dodawania historii. AdminEntityDialog zachowuje dane po błędach i ponownym renderowaniu; wersje i wyniki zapisu należą do gospodarza.

Panel używa stałych ról pisma: tytuł strony 20px/650, sekcji 16px/600, tekst i nawigacja 14px, etykiety 13px, opisy pomocnicze 12px. --qk-workspace-body-ink i --qk-workspace-active-ink pochodzą z istniejących kolorów.

Główne przyciski zachowują błękit Logo #4695D8 oraz białe napisy, ikony i wskaźniki ładowania w obu motywach. Najechanie nadal lekko rozjaśnia tło. Przyciski drugorzędne i niebezpiecznych działań zachowują kolory semantyczne.

Menu rozwijane i przełączniki przestrzeni współdzielą --menu-option-font-size (14px) oraz --menu-option-font-weight (500), z interlinią 1.45; wybrane opcje mają grubość 600, a metadane 12px/400. WorkspaceNavigationDock wstępnie ładuje cele tego samego pochodzenia po najechaniu kursorem lub uzyskaniu fokusu klawiatury, z ograniczoną deduplikacją. Istniejące zabezpieczenia opuszczania i trasy hosta nadal działają.

2026-09-07 - ColumnLayout

ColumnLayout wypełnia okno zarządzania zadokowaną nawigacją, osobnym przewijaniem treści i przyklejonym paskiem strony. WorkspacePage używa płaskich sekcji i wspólnych Tokenów promienia. Do 860px nawigacja pozostaje szufladą, nieaktywną po zamknięciu. Właściwości i logika biznesowa nie zmieniają się. Usuń podwójne marginesy zewnętrzne i ogranicz szerokość czytania wewnątrz formularzy.

Punkty wejścia importu

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';
Punkt wejściaPrzeznaczenie
@qokit/components/uiPodstawowe komponenty: Button, Card, Dialog, Menu, Pill
@qokit/components/patternsZestawy: Header, Footer, obszar roboczy, tabela, zasoby i asystent AI
@qokit/components/skins/platformReceptury wizualne platformy i obszaru roboczego
@qokit/components/skins/adminReceptura wizualna Admin
@qokit/components/skins/siteReceptura wizualna generowanej witryny

Granice odpowiedzialności publicznej

PromptPanel akceptuje opcjonalne atrybuty referenceReader oraz zlokalizowane referenceCopy. Czytnik zwraca wyodrębnione znaczniki contentExcerpt i truncated poprzez asynchroniczne file(File, AbortSignal) i website(url, AbortSignal), podczas gdy uwierzytelnianie oraz dostęp do API są odpowiedzialnością hosta. Komponent zarządza procesem odczytu, podglądu, ponownej próby i usuwania; w przypadku prawidłowego adresu URL bez tekstu zachęty żądanie uzupełnia referenceCopy.websitePrompt, a w przypadku błędu formatu stosuje referenceCopy.errors.url i blokuje odczyt. Przesłanie adresu URL, który nie został jeszcze odczytany lub jest właśnie przetwarzany, oczekuje na najnowsze dane i wykonuje operację tylko raz; zmiana wprowadzonych danych lub niepowodzenie odczytu anuluje operację w toku, a ponowna próba nie przywraca poprzednich przesłanych danych. Plik musi być gotowy przed przesłaniem. Pełny adres URL jest automatycznie odczytywany po wklejeniu, utracie fokusu lub naciśnięciu klawisza Enter; początkowy adres URL również podlega odczytowi, a wyniki w trakcie lub zakończone są ponownie wykorzystywane; w przypadku błędu system wskazuje wyraźną opcję ponownej próby. Edycja lub usunięcie adresu URL anuluje poprzedni odczyt i czyści wynik. Jeśli czytnik nie został dostarczony, kontynuowana jest natywna przesyłka bez obsługi odwołań asynchronicznych.

Mechanizm pobierania odwołań został dodany we wrześniu 2026 r. jako opcjonalna, zgodna wstecz funkcjonalność komponentu.

Komponenty szkieletowe zapewniają:

  • DOM i znaczniki semantyczne;
  • zachowanie ARIA, klawiatury, fokusu i disabled;
  • stan i podstawowe interakcje;
  • stabilne domyślne klasy;
  • nazwane sloty Skin.

Skin może:

  • dodawać klasy do slotów takich jak root, header, body, item, action;
  • przekazywać zmienne CSS poprzez vars;
  • korzystać z publicznie udostępnionych przełączników tonacji, warstw lub dostosowań wizualnych komponentu.

Skin nie może żądać danych, zmieniać DOM, przechowywać reguł biznesowych ani omijać zachowań dostępności.

Zawartość elementów generowanych

Wygenerowane niestandardowe bloki nadal korzystają ze zarejestrowanych elementów html-* w Schema v2, bez użycia wykonywalnego HTML ani nowych typów bloków. Od września 2026 r. @qokit/site-schema zapewnia bindSiteModuleContent, updateSiteModuleBoundContent oraz forkSiteModuleContentBindings służące do wiązania treści językowych. Ścieżki treści zapisywane są w module, a teksty dla odwiedzających w mapowaniu treści językowych; aktualizacje odbywają się za pośrednictwem transakcji cofania i zapisywania; przy kopiowaniu lub przenoszeniu elementów między blokami należy tworzyć pochodne wiązania, aby uniknąć modyfikacji źródła.

Opcjonalny extensionRequirements rejestruje nierozwiązane wymagania środowiska uruchomieniowego i nie stanowi listy instalacyjnej ani nadania uprawnień. createSiteExtensionHandoff eksportuje niewykonywalne żądania deweloperskie v1; przed publikacją działającej witryny wymagania te muszą zostać rozwiązane lub jawnie wykluczone po audycie.

Elementy formularzy

Wspólne formularze wykorzystują FormField do powiązania etykiety, opisu, metadanych wymaganego pola, komunikatów błędów oraz identyfikatora elementu. Elementy tekstowe używają Input, treść wielowierszowa Textarea, a elementy wyboru Checkbox, RadioGroup oraz Switch; istniejące Select i SearchField stosują ten sam kontrakt rozmiarów i stanów.

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 wiąże etykietę, opis oraz komunikaty błędów z unikalnym elementem podrzędnym za pomocą id, aria-describedby, aria-invalid i required. Nie owijaj już wspólnych elementów dodatkowym <label>.

Input, Textarea, Select oraz SearchField obsługują trzy rozmiary: sm, md i lg, odpowiadające odpowiednio 40px, 44px i 48px. Elementy jednowierszowe domyślnie używają kształtu pill; Textarea zawsze stosuje współdzielone zaokrąglenia dla treści wielowierszowych. Wszystkie stany interakcji oraz błędów pochodzą ze wspólnego Tokena.

Podczas migracji nadal dopuszczalny jest stary kontrakt .qk-field; nowe integracje powinny wykorzystywać wspólne komponenty oraz nazwane sloty skórki.

Wybór z listy

Od września 2026 r. listy mogą współpracować z useWorkspaceSelectionMode({ enabled, resetKey, onClear }) i WorkspaceFilterToolbar.selection. Ten Hook jest domyślnie nieaktywny, resetuje się przy zmianie zakresu lub uprawnień oraz rozróżnia czyszczenie zaznaczonych identyfikatorów od wyjścia z trybu zbiorczego; klucze zakresu powinny obejmować kolekcję, język, paginację oraz filtry.

WorkspaceDataTable.selection przekazywany jest wyłącznie przy aktywnym trybie zbiorczym, a kontrolki wyboru w siatce i wersji mobilnej korzystają z tego samego schematu. Pasek narzędzi odpowiada za ogólne operacje wyboru, natomiast użytkownik dostarcza zlokalizowane teksty, opcjonalne identyfikatory oraz operacje domenowe zweryfikowane pod kątem uprawnień. Opcjonalny actionContent może zawierać dodatkowe semantyki ARIA, ale nie zastępuje ogólnych kontrolek ani potwierdzenia. Listy tylko do odczytu nie wyświetlają trybu zbiorczego, a selektory plików oraz przeglądanie propozycji zachowują własną semantykę.

Nowe możliwości są opcjonalne i zgodne wstecz; wybór w tabeli pozostaje nadal jawnie kontrolowany przez użytkownika.

Karty wskaźników

Nowa dokumentacja API (angielski; tłumaczenie w przygotowaniu) · 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" />;

Nagłówek i stopka platformy

Logo domyślnie wyświetla statyczny obraz. motion="breathe" rezerwuje wymiary podczas ukrycia i odsłania logo raz, animacją oddechu trwającą 4,8 sekundy, gdy strona jest załadowana i widać co najmniej połowę logo. Nagłówek i stopka nie dodają opóźnienia. motionVisibilityDelayMs może dodać wymagany czas ciągłej widoczności, domyślnie zero. motionOnceKey współdzieli zapis odtwarzania między ponownymi montowaniami w tym samym dokumencie; nagłówek i stopka mają osobne klucze. Nawigacja, zmiana motywu i przewinięcie z powrotem nie odtwarzają animacji; pełne przeładowanie zeruje zapis. Ograniczenie ruchu, wyłączony JavaScript lub brak obserwacji widoczności powodują wyświetlenie statycznego logo. motion="reveal" pozostaje aliasem.

PlatformHeader.autoHideOnScroll ma domyślnie wartość false; PublicPlatformHeader je włącza. Nagłówek znika przy przewijaniu w dół i wraca przy przewijaniu w górę lub blisko początku strony. Otwarte menu i fokus wewnątrz nagłówka utrzymują jego widoczność. Nagłówki obszaru roboczego i edytora pozostają nieruchome.

PlatformHeader to szkielet nagłówka bez stanu biznesowego. PublicPlatformHeader komponuje na nim wejścia marki, publiczną nawigację, język, motyw, logowanie, „Wypróbuj teraz” oraz menu mobilne; stan anonimowy platformy i strona dokumentacji współdzielą ten zestaw bezpośrednio.

Publiczna nawigacja jest generowana jednolicie przez buildPublicHeaderNavItems(copy, links) jako „Zasoby / Cennik / Nowości”. Integratorzy parsują tylko URL-e wewnętrzne, strony dokumentacji i platformy aktualnie zastosowanej aplikacji, nie definiując ponownie kolejności menu ani tekstów. Nagłówek platformy po zalogowaniu również korzysta z tej samej funkcji generującej.

<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'
  }}
/>

Podstawowy navItems nadal obsługuje link, scroll oraz menu. menu na pulpicie obsługuje zamykanie kliknięciem, klawiaturą, Escape i kliknięciem poza element, natomiast na urządzeniach mobilnych MobileHeaderMenu rozwija się w grupy linków.

SiteFooter to szkielet stopki; platforma i strona dokumentacji używają PublicPlatformFooter do jednolitego komponowania zewnętrznej powłoki Shell, wejść marki, linków, motywów i kontrolek językowych. Integracja międzydomenowa konwertuje względne linki platformowe na adresy absolutne za pomocą resolveCompanyHref.

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

Aplikacje biznesowe nie powinny kopiować DOM nagłówka/stopki ani tablic publicznej nawigacji; w przypadku potrzeby innej prezentacji wizualnej należy użyć PlatformHeaderSkin, SiteFooterSkin lub odpowiedniego Skin platformy.

Strategia kompatybilności

  • Dodanie opcjonalnych właściwości i slotów Skin stanowi zmianę zgodną wstecz;
  • Usunięcie właściwości, modyfikacja domyślnej semantyki lub zmiana zachowań DOM/klawiatury stanowi zmianę łamiącą kompatybilność;
  • Zmiany łamiące kompatybilność muszą znaleźć się w Changelog wraz z przykładami migracji;
  • Nie należy polegać na niepublicznych wewnętrznych klasach, katalogach czy strukturach routingu;
  • W przypadku potrzeby identycznego nadpisania w więcej niż jednym punkcie integracyjnym, należy podnieść to do poziomu publicznego Skin lub Tokenu.

Edycja na pełnym ekranie

EditorWorkspace łączy pełnoekranowe okno dialogowe, zarządzanie fokusem i responsywne panele. dirty wymaga potwierdzenia odrzucenia zmian, busy blokuje zamknięcie podczas zapisu, a onSave obsługuje Ctrl/Cmd+S. Uprawnienia, dane, zapis i publikacja należą do aplikacji.

view / onViewChange przełączają edit, focus i preview bez zastępowania edytora. preview dostarcza podgląd, a previewPanel wykorzystuje istniejący panel. layout obsługuje writing, structure i canvas. storageKey pamięta szerokości i zwinięcie paneli, nigdy treść dokumentu.

onSaveAndClose zwraca true po potwierdzonym zapisie, false przy błędzie, handled, gdy aplikacja już zmieniła stronę, lub pending, gdy walidacja wymaga decyzji. Błąd pozostawia edytor otwarty. Używaj closeBehavior="collapse" tylko wtedy, gdy aplikacja zachowuje szkic. EditorSaveStatus pokazuje potwierdzony stan. EditorViewControls, EditorLeaveDialog i useEditorLayout można też łączyć osobno.

Zmiana klawiatury: Segmented ma jeden przystanek Tab, a wybór zmieniają strzałki / Home / End. Dialog respektuje Escape obsłużony przez warstwę potomną; następnie edytor wychodzi ze skupienia lub podglądu przed zamknięciem. LivePreviewToolbar.exitControl przyjmuje wspólne kontrolki widoku. Zapis, publikacja i uprawnienia pozostają po stronie aplikacji.

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 umieszcza przycisk panelu bocznego w nagłówku obszaru roboczego. Używaj jednego miejsca z jednym lewym panelem. SidebarNavigation nadal zarządza stanem, skrótami i panelem mobilnym; bez tego miejsca przyciski pozostają w pierwotnym położeniu. Przycisk w nagłówku zamyka również panel mobilny; po zamknięciu fokus wraca do tego samego przycisku.

EditorHeader

EditorHeader zachowuje logo, konto i menu globalne hosta w aktywnym edytorze. startControl i endControl sterują panelami bocznymi, center widokami, a actions zapisywaniem. PlatformHeader.editorActions wykorzystuje responsywną nawigację, język i motyw. onNavigate musi rozstrzygnąć niezapisane zmiany przed wykonaniem funkcji zwrotnej. Na wąskich ekranach nagłówek ma dwa wiersze; podmenu obsługują Escape jako pierwsze.

WorkspaceHeaderPortal.startControl i endControl umieszczają przełączniki panelu zarządzanej strony w pasujących slotach hosta. Hosty eksponują opcjonalne startTarget i endTarget obok tytułu, statusu i akcji. Biblioteka plików i przestrzeń robocza pojedynczego zasobu używają workAreaControls; podgląd zasobu zachowuje pełny nagłówek, dzięki czemu jego tożsamość, akcja powrotu i miejsca docelowe panelu pozostają dostępne. ProjectWorkspace zarządza wspólnymi wyborami nawigacji po lewej stronie/rozmowy dla Treści i Plików. Pliki rejestrują zapamiętane wymiary panelu zasobów przez useProjectResourcePanel, portalową nawigację przez ProjectContentTools i dostarcza tylko kontrolę inspektora po prawej stronie przez ProjectToolbar.endControl. Rozmowa używa tego samego pasa lewego i wbudowanego kompozytora w obszarach projektu; kompaktowe zadania zasobu, rozmowy i inspektora są wzajemnie wykluczające się.

EditorNavigationMenu

EditorNavigationMenu wyświetla całą SidebarNavigation aplikacji w nakładanym panelu, zachowując uprawnienia i kontekst projektu bez przesuwania obszaru edycji. Język i motyw pozostają na dole; podmenu obsługują Escape jako pierwsze. Skupienie i pełny ekran przeglądarki są niezależne. Nawigacja czeka na trwający zapis i chroni wersje robocze.

WorkspaceNavigationMenu / WorkspacePageHeader

Nawigacja globalna używa Command+\ na Macu lub Control+\ w Windows/Linux, również niezależnie wewnątrz Creator. T i Shift+T nadal sterują układem edytora. Pola edytowalne, składanie tekstu, powtórzenia i obsłużone zdarzenia są pomijane. Podpowiedzi przycisku i aria-keyshortcuts pokazują kombinację; nawigacja globalna nie przechwytuje już samego T.

Przestrzenie po zalogowaniu używają PlatformHeader.workspaceActions do wspólnego obszaru konta i nawigacji przy każdej szerokości. WorkspacePageHeader ujednolica tytuły i działania. WorkspaceNavigationMenu pokazuje bieżący panel boczny z uprawnieniami i kontekstem; EditorNavigationMenu pozostaje zgodnym aliasem. Studio zachowuje swój pasek narzędzi. Nagłówki publiczne zachowują dotychczasowy wygląd.

WorkspaceNavigationGuard chroni nawigację globalną za pomocą dirty, busy, error i opcjonalnego onSave. Wyjście jest możliwe dopiero po potwierdzonym zapisie zwracającym true; błąd zachowuje szkic. Language.onBeforeChange(apply) pozwala tak samo chronić zmianę języka. Podczas zapisu wyłącz pola formularza.

Nawigacja na komputerze zachowuje rozwinięty pasek i ikony oraz dodaje automatyczne ukrywanie. Pasek i wysuwany panel współdzielą wyszukiwanie oraz stan grup. Precyzyjny wskaźnik przy krawędzi otwiera podgląd po 300ms i zamyka go 320ms po opuszczeniu; kliknięcie pozostawia go otwartym. Sterowanie dotykiem i klawiaturą pozostaje dostępne. Dialog domyślnie używa modal={true} i autoFocus={true}; podgląd ustawia oba na false, zachowując fokus i przewijanie.

EditorViewControls

Jeden przycisk przełącza w obie strony: podczas edycji pokazuje Skupienie, a podczas skupienia Edycja. Kliknij lub naciśnij T; E wraca bezpośrednio do edycji. W wąskim nagłówku przycisk pozostaje widoczny, a podgląd, pełny ekran i dodatkowe działania są w menu Więcej.

EditorViewControls oddziela Edycję/Skupienie od natywnego pełnego ekranu. Podgląd jest osobnym przełącznikiem i wraca do poprzedniego trybu; useEditorWorkMode zachowuje go dla własnych akcji wyjścia. Wartości edit/focus/preview pozostają ważne. Podgląd używa teraz button z aria-pressed zamiast radio w grupie trybów. Pełny ekran wymaga kliknięcia i obejmuje nawigację oraz okna dialogowe w głównym elemencie aplikacji; bez obsługi akcja jest ukryta.

Language / Appearance

Language i Appearance variant="menu" obsługują opcjonalne layout="row", wyświetlające etykietę, bieżącą wartość i strzałkę. Domyślny kompaktowy układ i ochrona zmiany języka pozostają bez zmian. SiteHeaderCopy.helpResources i contactSupport opcjonalnie określają nazwy łączy pomocy obszaru roboczego.

requestWorkspaceNavigation

Strony z przyciskiem panelu bocznego pomijają dodatkowy przycisk menu w nagłówku, także po zwinięciu i na urządzeniach mobilnych. Edytory i strony bez panelu zachowują go. Importuj requestWorkspaceNavigation(returnFocusTarget?) i useWorkspaceNavigationState() z @qokit/components/patterns/WorkspaceNavigation: żądanie przełącza zarejestrowany panel i zwraca false, gdy jest niedostępny. Opcjonalny element otrzymuje fokus po zamknięciu. Przed pokazaniem dodatkowego wejścia sprawdź .available. Używaj istniejącego przycisku lub tego API zamiast pozycji DOM usuniętego przycisku.

WorkspacePanelReveal

Nawigacja globalna używa ikony menu, a narzędzia kierunkowych ikon panelu. useWorkspacePanelReveal({ temporary: true }) otwiera narzędzia tymczasowo kliknięciem lub klawiaturą w trybie skupienia. toggle(trigger?) i close(true) zachowują układ i tryb oraz przywracają fokus. Krawędź ekranu otwiera nawigację globalną; narzędzia reagują przy swoich przyciskach. Podgląd ukrywa przyciski paneli i oferuje jawny powrót do poprzedniego trybu edycji.

EditorViewControls / Tryb wyświetlania

EDITOR_VIEW_SHORTCUTS → Tooltip + aria-keyshortcuts

EditorHeader zarządza również EDITOR_TOOLBAR_SHORTCUTS: Command/Control+S uruchamia widoczny EditorSaveButton, Shift+P otwiera EditorStatusAction shortcut="publish", a Shift+M menu narzędzi. Polecenia używają tych samych aktywnych kontrolek co kliknięcia; publikacja wymaga jawnego działania w panelu. Reaguje tylko aktywny, widoczny nagłówek. Podmenu, okna dialogowe, składanie tekstu i powtarzane zdarzenia blokują skróty; w polach edycji dozwolony jest tylko zapis. Podpowiedzi i aria-keyshortcuts współdzielą definicje. Własny toolsControl ustawia aria-keyshortcuts={EDITOR_TOOLBAR_SHORTCUTS.tools.aria} na przycisku. ActionMenu.triggerKeyShortcuts dodaje atrybut i podpowiedź bez rejestrowania globalnego polecenia.

Polecenia paneli: Shift+A (dodaj), Shift+L (strony/warstwy), Shift+K (rozmowa), Shift+C (treść), Shift+D (projekt), Shift+G (styl globalny). CMS dodaje dostępne Shift+S (ustawienia), Shift+E (SEO), Shift+H (historia). Metadane shortcut w EditorChoiceControl, EditorViewTabs i ActionMenu zapewniają wspólne podpowiedzi. EditorPanelChoiceShortcuts i EditorViewControls.compactActions zachowują działania po zwinięciu do menu, także na telefonach. EditorPanelShortcuts.commands rejestruje istniejące działania bez powielania kontrolek. Nadal obowiązują ograniczenia ukrycia, inert, wyłączenia, podglądu i nakładek. Niemodalne mobilne panele boczne tego samego obszaru pozwalają przełączać panele; menu i modalne okna blokują skróty. Klawisze bez modyfikatorów zachowują dotychczasowe działanie.

Tryb wyświetlania
EEdytuj
TEdytuj ↔ Skupienie
VPodgląd / Wróć do edycji
FWłącz pełny ekran / Wyłącz pełny ekran

Reaguje tylko aktywny edytor. Wpisywanie tekstu, kompozycja IME, przytrzymane klawisze oraz otwarte podrzędne okna dialogowe lub menu nie zmieniają trybu.

PlatformHeader.workspaceNavigation

PlatformHeader.workspaceNavigation umieszcza nawigację globalną przed logo; workspaceActions i editorActions zachowują działania konta. Obszary robocze używają istniejącego przełącznika paska bocznego, a edytory umieszczają przełącznik prawego panelu przed awatarem. Na wąskich ekranach nawigacja, marka, tytuł i awatar znajdują się nad narzędziami edycji i zapisem. Kolejność DOM odpowiada układowi; efekt matowego szkła bez obramowania pozostaje zachowany.

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

EditorHeader.preview pokazuje tylko center jako zwarty pasek podglądu bez ramki; logo, konto, zapis i panele pozostają zamontowane, ale ukryte. Przy osobnym LivePreviewToolbar można ukryć nagłówek edytora i przez EditorViewControls.returnView (edit lub focus) przywrócić poprzedni tryb. Zachowaj dostępny powrót i niezależny pełny ekran; nagłówek witryny pozostaje widoczny.

2026-09-06 · Builder / CMS

Builder i CMS współdzielą BuilderWorkspace, EditorCatalog oraz EditorComponentSettings dla paneli, ilustracji wstawiania i ustawień wyglądu. Presety stosują powiązane ustawienia razem i zachowują treść; zapisywanie i cofanie pozostają po stronie aplikacji. Elementy sterujące używają motywu platformy, a treść motywu witryny.

Stopka renderowana na serwerze · 2026-09-07

SiteFooterLayout przyjmuje jawne locale i copy w jednym języku. Komponenty serwerowe renderują wspólną strukturę stopki; elementy wyboru motywu i języka oraz okno QR pozostają komponentami klienckimi. Istniejące interfejsy SiteFooter i PublicPlatformFooter są nadal obsługiwane.

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

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

Przygotuj odnośniki między domenami w copy.companyLinks na serwerze. Użyj controls, aby dostosować obszar interaktywnych elementów sterujących.

EditorHeader.titleControl / FloatingAssistant.presentation

EditorHeader.titleControl i EditorWorkspace.titleControl mogą zastąpić tytuł wspólnym menu projektu. Zachowaj opisowy title oraz ochronę niezapisanych zmian podczas nawigacji. FloatingAssistant.presentation="embedded" wyświetla nazwany obszar w panelu hosta bez pływającego przycisku i nakładki; domyślnie pozostaje floating. Host zarządza położeniem i widocznością, a asystent stanem rozmowy i uprawnieniami.

2026-09-07 · WorkspaceAssembly

WorkspaceAssembly oznacza wychodzące karty i wchodzące sekcje bez dodatkowego kontenera. Gdy układ wymaga bezpośrednich dzieci, umieść workspaceAssemblyAttributes(part, index, phase) na istniejącym DOM. EditorHeader.assemble i BuilderWorkspacePanels.assemble zapewniają znaczniki edytora.

Wywołuj await startWorkspaceAssembly(navigate, destinationPathname) dopiero po udanym utworzeniu: zapisuje widoczne fragmenty, nawiguje raz i składa cel lub odpowiedni szkielet ładowania w najwyżej 720 ms. Cel wymaga znacznika wejścia canvas; useWorkspaceAssemblyPending() utrzymuje ekran ładowania do zakończenia układania migawek, podczas wstępnego ładowania danych i kodu. Ograniczony ruch lub brak obsługi oznacza bezpośrednią nawigację. Powolne i przerwane przejścia zwalniają migawki i kontynuują. Same znaczniki nie animują edycji, odświeżania ani historii. Wspólny wzorzec sprząta tymczasowe style; aplikacja zarządza błędami tworzenia, idempotencją i ładowaniem.

2026-09 · Obszary zarządzania

WorkspacePage i WorkspaceLayout przyjmują variant: overview, list, detail, settings lub editor. WorkspaceFormFooter rozmieszcza przekazane przez aplikację actions, message, tone i busy; zapisywanie pozostaje jej zadaniem.

Wąskie tabele (WorkspaceDataTable, AdminDataTable) pokazują rekordy z etykietami, wyborem, własnymi nagłówkami i akcjami. Macierze porównawcze wymagają mobileLayout="scroll". WorkspaceFilterToolbar umieszcza wyszukiwanie i filtry przed sortowaniem i widokiem. Panel boczny używa h2, a strona h1.

2026-09-08 · Task focus

useSidebarTaskFocus(active) tymczasowo ukrywa nawigację podczas zadania wymagającego skupienia. Po zakończeniu przywraca poprzedni widok, chyba że użytkownik sam zmieni tryb. Automatyczne ukrywanie nie nadpisuje zapisanych preferencji.

Nowa dokumentacja API (angielski; tłumaczenie w przygotowaniu)

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.

Adapter Web przekazuje również FloatingAssistantPanel.composerAttachments. Slot pokazuje załączniki zarządzane przez aplikację w formularzu wiadomości przed polem tekstowym. Aplikacja kontroluje położenie i wysyłanie: upuszczenie przygotowuje załącznik, sukces usuwa tylko wysłany załącznik, a błąd zachowuje go do ponowienia.

Wspólne komponenty rozmowy (opis angielski; tłumaczenie w przygotowaniu)

@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 wykorzystuje InlineNotice do zwięzłego prezentowania stanów zadań, błędów, rozwiązań zastępczych i potwierdzeń zapisu w rozmowach. Przekaż zlokalizowany title oraz opcjonalne description, tone i action. Oba wiersze używają rozmiaru pisma podpisu, małego odstępu i przezroczystej powierzchni; ton podkreśla stan, a tekst pomocniczy pozostaje stonowany. Domyślne wartości role="status" i aria-atomic="true" ogłaszają całą aktualizację razem; użyj role="alert" dla błędów wymagających działania. Tekst napisany przez asystenta pozostaje w 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.

Nowa dokumentacja API (angielski; tłumaczenie w przygotowaniu) · 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 stanu, sort, domenowe controls, opcje advanced, warunkowe reset, result zasobu i pomocnicze summary.
  • presentation: view, wyświetla controls i options, takie jak widoczne kolumny i rozmiar strony. Dostosowywanie widżetów strony należy umieścić w akcjach nagłówka strony.
  • 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.

Użyj query.result={{ label, count, total?, locale? }} dla nazwy zasobu i liczby wyników. WorkspaceResultSummary wyświetla „Nazwa · liczba” i dodaje „/ razem” tylko wtedy, gdy wiarygodna liczba bez filtrów jest inna; liczby są formatowane według języka interfejsu i izolowane w tekście dwukierunkowym. Pomiń result, dopóki liczba nie jest znana; zero jest poprawne. Nie dodawaj nad tą samą listą drugiego wiersza nazwy i liczby. AdminFilterBar.result przyjmuje ten sam obiekt. Tytuły stron, istotnych sekcji, stronicowanie i liczby zaznaczonych elementów zachowują swoje role; query.summary służy innym jednostkom, kontekstowi zapytania lub aktualności.

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.

Dodatkowa dokumentacja API (angielski, tłumaczenie w przygotowaniu) · 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.

Opcje wyboru i menu obsługują annotation, które dodaje kropkę w kolorze motywu i uwzględnia jej przetłumaczone znaczenie w nazwie dostępnej dla technologii asystujących. Przycisk ControlMenu pokazuje też kropkę aktywnej opcji; triggerAnnotation: null pozostawia ją tylko w menu. Ponowne wybranie zaznaczonej, dostępnej opcji wywołuje onReselect. Opcje natywne pokazują opis obok etykiety; hidden usuwa symbol zastępczy z listy. Host określa oznaczaną wartość i działanie; wspólny element nie wnioskuje o dziedziczeniu ani nie zapisuje danych.

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

Umieść CustomizableWidgetLayoutControls w akcjach nagłówka strony po pomocy kontekstowej i przed główną akcją, w tym na urządzeniach mobilnych. Użyj zlokalizowanego copy.customize, aby jawnie nazwać akcję (np. „Dostosuj widżety”). Ten sam element tylko z ikoną odsłania aria-pressed i aria-expanded, a staje się copy.done podczas edycji. customizeButtonRef opcjonalnie eksponuje wyzwalacz do przywracania fokusu hosta; disabledCustomize wyłącza element bez zmiany jego geometrii. Dostarczaj onCollapseToggle i areWidgetsCollapsed tylko dla hostów obsługujących zwijanie widżetów; ich pominięcie renderuje sam element dostosowywania.

CustomizableWidgetLibrary zarządza wspólnym nagłówkiem biblioteki, akcjami resetowania/zamykania, responsywnym układem przewijania, początkowym skupieniem przycisku zamknięcia i obsługą Escape. Zamykanie zwraca fokus do sterowania wywołującego, gdy fokus jest nadal wewnątrz biblioteki; kliknięcia poza nią utrzymują jej miejsce docelowe. Hosty przechowują definicje widżetów, polecenia dodawania/usuwania/porządkowania/rozmiaru, trwałość i semantykę resetowania. Sloty klas CMS i Admin pozostają dostępne dla haków domenowych, ale nie mogą definiować oddzielnych powierzchni biblioteki lub układów mobilnych.

2026-10-17 · Rozbudowane wyzwalacze ActionMenu

ActionMenu.renderTrigger może ponownie wykorzystać rozbudowany element sterujący, taki jak SelectableTile. Otrzymuje on aria-expanded, aria-haspopup, disabled oraz onClick; rozłóż je na rzeczywisty wyzwalacz. Host zachowuje semantykę wyboru i wygląd kontrolki. Pozycjonowanie w portalu, nawigacja klawiaturowa menu, zamykanie, powrót fokusu oraz opcjonalne arkusze mobilne pozostają w gestii ActionMenu. Domyślne przyciski i ikony jako wyzwalacze nie uległy zmianie.

Kontrolki promienia i zakresu

RangeNumber z @qokit/components/ui/RangeNumber łączy natywny suwak z dokładnym polem liczbowym Input. Podaj label, value, min, max, opcjonalne step i unit oraz onChange. Niezdefiniowana wartość pokazuje kreskę oznaczającą wartości mieszane; zmiana dowolnego wejścia ustawia jedną liczbę w granicach zakresu. onCommit pozwala grupować ciągłe zmiany w istniejącej historii cofania aplikacji. disabled, nawigacja klawiaturą, zwarta gęstość, RTL i style fokusu są wspólne; zapis należy do aplikacji. RangeNumberSkin udostępnia sloty korzenia, suwaka, pola i jednostki.

EditorRadiusControl z @qokit/components/patterns/EditorRadiusControl łączy podgląd kształtu na żywo, cztery pola fizycznych narożników, RangeNumber i opcjonalne gotowe kształty. value i onChange korzystają ze skróconej składni CSS border-radius; aplikacja tłumaczy cornerLabels i nazwy ustawień. W RTL kolejność pozostaje następująca: lewy górny, prawy górny, prawy dolny, lewy dolny. max ogranicza edycję do ograniczonych wartości pikselowych; pominięcie zachowuje jednostki CSS i składnię eliptycznych narożników. Mieszany promień nie pokazuje jednej liczby, dopóki wszystkie cztery narożniki nie zostaną ustawione razem. Opcjonalny EditorRadiusControlSkin dostosowuje sloty korzenia, schematu, podglądu i ustawień bez zmiany stanu ani zapisu.

2026-10-22 · Aktywne karty na wąskich ekranach

PillTabs przyjmuje opcjonalne scrollActiveTabIntoView z domyślną wartością false. Dla kart poziomych pokazuje aktywne bezpośrednie dziecko PillTabLink lub PillTabButton przy wyborze i zmianie rozmiaru. Przewija się tylko pasek kart; pozycja strony i fokus klawiatury pozostają bez zmian. Obsługuje LTR i RTL z natychmiastową korektą, także przy ograniczeniu ruchu. Karty pionowe i wywołania bez opcji zachowują dotychczasowe działanie.

Na tej stronie

Integracja komponentów2026-10-20 · Niezależne działania kart wyboru wizualnego2026-10-17 · Wspólny ruch panelu warsztatu2026-10-17 · Domyślne wartości edytora z pomiarem2026-09-30 · Dostępność SelectionToolbar2026-09-10 · Identyfikatory obszaru roboczego2026-09-08 · EmptyState2026-09-08 · SidebarNavigation2026-09-07 - AccountDropdown / SidebarProfile2026-09-07 - FormField / AdminEntityDialog / EditorWorkspace2026-09-07 · WorkspaceLocationSync / ProjectSwitcher2026-09-07 · Wspólna nawigacja i zaokrąglone powierzchnie Qokit2026-09-07 - ColumnLayoutPunkty wejścia importuGranice odpowiedzialności publicznejZawartość elementów generowanychElementy formularzyWybór z listyKarty wskaźnikówNowa dokumentacja API (angielski; tłumaczenie w przygotowaniu) · 2026-10Nagłówek i stopka platformyStrategia kompatybilnościEdycja na pełnym ekranieSidebarToggleSlotEditorHeaderEditorNavigationMenuWorkspaceNavigationMenu / WorkspacePageHeaderEditorViewControlsLanguage / AppearancerequestWorkspaceNavigationWorkspacePanelRevealEditorViewControls / Tryb wyświetlaniaPlatformHeader.workspaceNavigation2026-09-06 - EditorHeader.preview / EditorViewControls.returnView2026-09-06 · Builder / CMSStopka renderowana na serwerze · 2026-09-07EditorHeader.titleControl / FloatingAssistant.presentation2026-09-07 · WorkspaceAssembly2026-09 · Obszary zarządzania2026-09-08 · Task focusNowa dokumentacja API (angielski; tłumaczenie w przygotowaniu)Wspólne komponenty rozmowy (opis angielski; tłumaczenie w przygotowaniu)Nowa dokumentacja API (angielski; tłumaczenie w przygotowaniu) · 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 · EditorItemDisclosureDodatkowa dokumentacja API (angielski, tłumaczenie w przygotowaniu) · 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 / CustomizableWidgetLibrary2026-10-17 · Rozbudowane wyzwalacze ActionMenuKontrolki promienia i zakresu2026-10-22 · Aktywne karty na wąskich ekranach