Skip to Content
Projektowanie

Aktualizacja kontraktu projektowego

Rejestr zmian w publicznych tokenach projektowych, interfejsach API komponentów i kontraktach integracyjnych Qokit.

Aktualizacja kontraktu projektowego

2026-10-21 · Stałe działania w przewijanych menu

ActionItem.pinned przyjmuje start lub end, utrzymując działania i ActionMenu.dropdownHeader poza przewijaną listą. Nawigacja klawiaturą i wybór obejmują wszystkie obszary. Hosty portali mogą ograniczyć wysokość przez --qk-menu-available-height, mierzone po wybranej stronie wyzwalacza. Bez pinned zachowana jest dotychczasowa struktura menu.

2026-10-17 · Element wejściowy do dostosowywania widżetów

Dostosowywanie widżetów strony wykorzystuje wspólny element nagłówka dostępny w projektach, treści i panelach. CustomizableWidgetLayoutControls dodaje opcjonalne customizeButtonRef oraz disabledCustomize; elementy zwijania są opcjonalne. CustomizableWidgetLibrary udostępnia geometrię mobilną, początkowe skupienie, klawisz Escape oraz powrót fokusu między hostami. Trwałość widżetów i polecenia pozostają własnością hosta. Zobacz integrację dostosowywania widżetów.

2026-10-17 · Sterowanie panelem warsztatu zarządzanego

WorkspaceHeaderPortal akceptuje opcjonalne startControl i endControl, wraz z pasującymi opcjonalnymi celami hosta. Widoki Zarządzanych plików używają tych samych slotów panelu nagłówkowego i geometrii obszaru roboczego co edycja pojedynczego zasobu i podgląd. Istniejące hosty mogą nadal dostarczać tylko tytuł, status i akcje. Zobacz integrację EditorHeader.

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

useWorkspaceResponsiveProfile dodaje opcjonalne onWidthChange(width) dla dostępnych pomiarów obszaru roboczego. useEditorLayout stosuje teraz skonfigurowane wspólne limity szerokości również do pamięci hosta, a readEditorLayout akceptuje opcjonalne limity jako czwarty argument. Istniejący wywołujący zachowują swoje domyślne wartości. Zobacz Integracja komponentów.

2026-09-26 · Creator · Zestawy stylów

Dokładne odstępy · v3: site.theme.spacingOverrides 按 desktop/tablet/mobile → sectionPadding (0–240px), pageGutter, cardGap (0–96px). --qk-site-custom-{sectionPadding|pageGutter|cardGap}-{desktop|tablet|mobile}. 980px / 720px.

Przyciski i linki: primaryButtonStyle, secondaryButtonStyle (solid/outline), buttonFontSize (12–24px), linkUnderline (always/hover/none), linkHoverStyle (none/tint). --qk-site-{primary|secondary}-button-{background|color|border|shadow}, --qk-site-button-font-size, --qk-site-button-size-{sm|md|lg}, --qk-site-link-decoration, --qk-site-link-hover-decoration, --qk-site-link-hover-background. initial → Automatycznie.

Zaawansowane kolory: mutedColor, borderColor, buttonTextColor, cardSurfaceColor 与对应 dark* 字段 (--qk-site-color-card-rgb).

2026-09-09 · Skrót nawigacji globalnej

SidebarNavigation / WorkspaceNavigationMenu: 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.

2026-09-08 · EmptyState

Tworzenie projektów oraz artykułów/produktów CMS korzysta ze wspólnego EmptyState: wyśrodkowanego, przezroczystego, zwartego i z zawijanymi działaniami. icon, layout, style i description są opcjonalne. Tytuł używa h2; przenieś własne selektory strong do slotu skin title. Działania korzystają ze wspólnego kontenera. Uprawnienia i tworzenie pozostają po stronie hosta.

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-08 - Primary button foreground

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.

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 w kształcie kapsułek używają bezpośrednio błękitu Logo #4695D8 przez --accent-action, bez ciemnego gradientu. Najechanie dodaje 8% bieli; etykiety korzystają z tuszu marki z 10% czerni dla czytelności. Nawigacja zachowuje ten sam błękit i tekst dopasowany do motywu.

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.

2026-09-05 · WorkspaceNavigationMenu / WorkspacePageHeader

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.

2026-09-05 · 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. Przy szerokości do 1120px nagłówek ma dwa wiersze, a menu pokazuje bieżący widok. Skupienie i pełny ekran przeglądarki są niezależne. Nawigacja czeka na trwający zapis i chroni wersje robocze.

2026-09-05 · 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.

2026-09-05 · 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.

2026-09-05 · EditorWorkspace / Dialog / Segmented

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.

2026-09 · EditorWorkspace

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.

2026-08 · Kompaktowa gęstość wskaźników

  • Dodano opcjonalny interfejs density="compact" API dla MetricCard, przeznaczony dla obszarów roboczych o wysokiej gęstości operacyjnej;
  • Zachowano istniejącą domyślną gęstość i semantykę DOM;
  • Kompaktowe marginesy wewnętrzne, skalę wartości i minimalną wysokość przeniesiono do wspólnych stylów komponentów, co eliminuje konieczność nadpisywania wizualnego w trasach.

2026-07 · Ujednolicone elementy formularzy

  • Do @qokit/components/ui dodano FormField, Input, Textarea, Checkbox, RadioGroup oraz Switch;
  • Wspólny szkielet FormField powiązuje etykiety, opisy, komunikaty błędów, stan wymagania oraz odwołania ARIA;
  • Elementy Input, Textarea, Select i SearchField ujednolicono pod kątem rozmiarów 40px, 44px i 48px oraz wspólnych tokenów interakcji;
  • Dodano receptury Skin dla platformy, Admina i generowanych stron dla nowych podstawowych komponentów formularzy;
  • Istniejące style .qk-field zachowano jako ścieżkę migracji wstecznej.

2026-07 · Układ rozmiarów przycisków

  • Dodano trzy semantyczne tokeny: --button-font-size-sm, --button-font-size-md, --button-font-size-lg;
  • Tekst w Button dla sm, md, lg jest teraz stały i wynosi odpowiednio 14px, 15px, 16px, nie dziedzicząc już rozmiaru czcionki z nagłówka, okna dialogowego ani kontenera strony;
  • Jeśli motywy Skin witryny wymagają zmiany układu przycisków, należy nadpisać odpowiednie tokeny semantyczne, a nie nadpisywać font-size za pomocą klas routingu.

2026-07 · Szkielet nawigacji platformowej

  • Dodano PlatformHeader niezależne od logowania, używane przez platformę i stronę dokumentacji jako wspólny szkielet semantyczny;
  • Dodano PublicPlatformHeader oraz buildPublicHeaderNavItems, umożliwiające platformie w stanie anonimowym i stronie dokumentacji współdzielenie tego samego zestawu nagłówków publicznych oraz konfiguracji nawigacji;
  • HeaderNavItem dodaje typ menu: nagłówek na pulpicie używa rozwijanego menu z opcją zamknięcia, a nagłówek mobilny automatycznie rozwija się w grupy linków;
  • SiteFooter dodaje opcjonalne brandHref oraz controls, obsługując różne scenariusze integracji, takie jak publiczne dokumentacje;
  • Dodano PublicPlatformFooter, dzięki czemu platforma i strona dokumentacji współdzielą ten sam Footer Shell, z możliwością rozwiązywania linków platformowych poza domeną;
  • Wszystkie powyższe są opcjonalnymi interfejsami API zgodnymi wstecz; istniejąca logika stanu nagłówka platformy oraz domyślne kontrolki stopki pozostają bez zmian.

2026-07 · Publiczny przewodnik projektowy

  • Rozdzielono publiczny kontrakt projektowy od wewnętrznych specyfikacji implementacji AI;
  • Opublikowano wizualne tokeny, import komponentów, granice Skeleton/Skin, Button, Card oraz wymagania dotyczące dostępności;
  • Zdefiniowano, że zmiany komponentów łamiące kompatybilność muszą zawierać instrukcje migracji;
  • Publikowane wyszukiwanie, Sitemap oraz wyjścia LLM zawierają wyłącznie treści, które mogą być zależnością zewnętrzną.

Uwagi dotyczące kompatybilności

  • Dodanie opcjonalnych właściwości, opcjonalnych slotów Skin oraz tokenów semantycznych zazwyczaj zachowuje kompatybilność wstecz;

  • Usunięcie lub zmiana nazw właściwości, zmiana domyślnych zachowań DOM/semantycznych/klawiatury stanowi zmianę łamiącą kompatybilność;

  • Zmiany łamiące kompatybilność będą opisane na tej stronie pod kątem zakresu wpływu, alternatywnych interfejsów API oraz kroków migracji.

  • 2026-09-06: Nawigacja na komputerze zachowuje rozwinięty pasek i ikony oraz dodaje automatyczne ukrywanie. SidebarNavigation / WorkspaceNavigationMenu / Dialog

  • 2026-09-06: EditorViewControls oddziela Edycję/Skupienie od natywnego pełnego ekranu. EditorViewControls

  • 2026-09-06: 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. Language / Appearance

  • 2026-09-06: Strony z panelem bocznym usuwają powielony przycisk menu; istniejący przycisk i API nawigacji pozostają dostępne. WorkspaceNavigation

  • 2026-09-06: Nawigacja globalna używa ikony menu, a narzędzia kierunkowych ikon panelu. WorkspacePanelReveal / EditorViewControls

  • 2026-09-06: Tryb wyświetlania · E / T / V / F · Segment.shortcut. EditorViewControls

  • 2026-09-06: PlatformHeader.workspaceNavigation umieszcza nawigację globalną przed logo PlatformHeader.workspaceNavigation

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.

2026-09-06 - 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

2026-09 · Obszary zarządzania

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)

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

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

Nowa dokumentacja API (angielski; tłumaczenie w przygotowaniu) · 2026-10

2026-10-08 · Workspace title navigation

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

Na tej stronie

Aktualizacja kontraktu projektowego2026-10-21 · Stałe działania w przewijanych menu2026-10-17 · Element wejściowy do dostosowywania widżetów2026-10-17 · Sterowanie panelem warsztatu zarządzanego2026-10-17 · Domyślne wartości edytora z pomiarem2026-09-26 · Creator · Zestawy stylów2026-09-09 · Skrót nawigacji globalnej2026-09-08 · EmptyState2026-09-08 · SidebarNavigation2026-09-08 - Primary button foreground2026-09-07 - AccountDropdown / SidebarProfile2026-09-07 - FormField / AdminEntityDialog / EditorWorkspace2026-09-07 · WorkspaceLocationSync / ProjectSwitcher2026-09-07 · Wspólna nawigacja i zaokrąglone powierzchnie Qokit2026-09-07 - ColumnLayout2026-09-05 · WorkspaceNavigationMenu / WorkspacePageHeader2026-09-05 · EditorNavigationMenu2026-09-05 · EditorHeader2026-09-05 · SidebarToggleSlot2026-09-05 · EditorWorkspace / Dialog / Segmented2026-09 · EditorWorkspace2026-08 · Kompaktowa gęstość wskaźników2026-07 · Ujednolicone elementy formularzy2026-07 · Układ rozmiarów przycisków2026-07 · Szkielet nawigacji platformowej2026-07 · Publiczny przewodnik projektowyUwagi dotyczące kompatybilności2026-09-06 - EditorHeader.preview / EditorViewControls.returnView2026-09-06 · Builder / CMS2026-09-06 - EditorViewControls2026-09 · Obszary zarządzania2026-09-08 · Task focusNowa dokumentacja API (angielski; tłumaczenie w przygotowaniu)Nowa dokumentacja API (angielski; tłumaczenie w przygotowaniu) · 2026-102026-10-08 · Workspace title navigation