Skip to Content
Ontwerp

Updates van het ontwerpcontract

Registratie van wijzigingen in de openbare design Tokens, component-API's en integratiecontracten van Qokit.

Updates van het ontwerpcontract

2026-10-21 · Vaste acties in schuifbare menu’s

ActionItem.pinned accepteert start of end om acties en ActionMenu.dropdownHeader buiten de schuifbare lijst te houden. Toetsenbordnavigatie en selectie werken in alle gebieden. Portalhosts kunnen de hoogte begrenzen met --qk-menu-available-height, gemeten aan de gekozen zijde van de trigger. Zonder pinned blijft de bestaande menustructuur behouden.

2026-10-17 · Toegang tot widgetaanpassing

De aanpassing van paginawidgets maakt gebruik van de gedeelde kopteksttoegang in Projecten, Inhoud en dashboards. CustomizableWidgetLayoutControls voegt optionele customizeButtonRef en disabledCustomize toe; inklapbesturingselementen zijn optioneel. CustomizableWidgetLibrary deelt mobiele geometrie, initiële focus, Escape en terugkeer van focus over hosts heen. Widgetpersistentie en opdrachten blijven host-eigendom. Zie widgetaanpassingsintegratie.

2026-10-17 · Bestuurde werktafelpaneelbesturingselementen

WorkspaceHeaderPortal accepteert optionele startControl en endControl, met bijpassende optionele hostdoelen. Beheerde bestandsweergaven gebruiken dezelfde koptekstpaneelslots en werkgebiedgeometrie als het bewerken en voorvertonen van een enkel object. Bestaande hosts kunnen blijven uitsluitend titel, status en acties leveren. Zie EditorHeader-integratie.

2026-10-17 · Gemeten standaardwaarden voor editor

useWorkspaceResponsiveProfile voegt optionele onWidthChange(width) toe voor beschikbare metingen van het werkgebied. useEditorLayout past nu ook geconfigureerde gedeelde breedtelimieten toe op hostopslag, en readEditorLayout accepteert optionele limieten als vierde argument. Bestaande aanroepers behouden hun standaardwaarden. Zie Componentintegratie.

2026-09-26 · Creator · Stijlschemas

Precieze afstanden · 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.

Knoppen en links: 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 → Automatisch.

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

2026-09-09 · Sneltoets voor algemene navigatie

SidebarNavigation / WorkspaceNavigationMenu: Algemene navigatie gebruikt Command+\ op Mac of Control+\ op Windows/Linux, ook onafhankelijk binnen Creator. T en Shift+T blijven de editorindeling bedienen. Bewerkbare velden, tekstcompositie, herhalingen en al afgehandelde gebeurtenissen worden genegeerd.

2026-09-08 · EmptyState

Project- en CMS-artikel-/productaanmaak delen EmptyState: gecentreerd, transparant, compact en met afbrekende acties. icon, layout, style en description zijn optioneel. De titel gebruikt h2; vervang eigen strong-selectors door het skin-slot title. Acties delen een container. Rechten en aanmaak blijven bij de host.

2026-09-08 · SidebarNavigation

SidebarNavigation laadt routes van dezelfde oorsprong vooraf na 180 ms aanwijzen of bij toetsenbordfocus. Vaste en pop-upnavigatie delen een limiet van 8 bestemmingen per 30 seconden. Voorladen stopt offline, in verborgen tabbladen, met Save-Data of 2G; downloads, uitgeschakelde links, nieuwe vensters en ankers op dezelfde pagina zijn uitgesloten. Navigatie en bescherming van wijzigingen blijven behouden.

2026-09-08 - Primary button foreground

Primaire pilknoppen behouden het Logo-blauw #4695D8 met witte tekst, pictogrammen en laadindicatoren in beide thema’s. Hover blijft licht ophelderen. Secundaire en gevaarlijke acties behouden hun semantische kleuren.

2026-09-07 - AccountDropdown / SidebarProfile

AccountDropdown ondersteunt de optionele eigenschappen compact en preferences: de compacte modus verbergt identificaties en de aanmaakgeschiedenis; standaard blijft bestaande inhoud behouden. Appearance en Language accepteren triggerRole="menuitem" in het accountmenu. Toetsenbordnavigatie herstelt de focus; geneste taaldialogen verwerken Escape zelf. SidebarNavigation.searchEnabled is standaard true; gebruik false voor korte, vaste navigatie. SidebarProfile met href zonder menu opent in uitgeklapte en pictogrammodus dezelfde bestemming.

2026-09-07 - FormField / AdminEntityDialog / EditorWorkspace

Formulieren delen een letterschaal en laten lange tekst omlopen, met behoud van pilvormen en merkkleuren. FormField benoemt groepen: controlId en de binnenste id verbinden het label. SearchField herstelt focus na wissen. Segmented en ControlMenu ondersteunen uitgeschakelde opties; uitgeschakelde ActionMenu-items hebben geen link. Bezige knoppen behouden formaat en indicator. AdminEntityDialog valideert verplichte velden, e-mail en JSON, focust fouten, blokkeert dubbel opslaan en bewaart invoer bij fouten. EditorWorkspace biedt ref.focusControl(element) om verborgen panelen te tonen vóór focus. Verminderde beweging schakelt overgangen van bedieningselementen uit. WorkspaceDialog scrolt lange inhoud met zichtbare kop en acties; korte mobiele dialogen passen zich aan de inhoud aan.

2026-09-07 · WorkspaceLocationSync / ProjectSwitcher

Na een voltooide routewissel sluit WorkspaceLocationSync de tijdelijke ruimtekeuze, zodat de bestemming direct haar hulpmiddelen toont. Zoek- en sectievoorkeuren blijven behouden. Bereiknaam en context staan op aparte regels; lange namen in de kop worden binnen de knop ingekort.

2026-09-07 · Uniforme navigatie en afgeronde Qokit-oppervlakken

WorkspaceNavigationDock hergebruikt de navigatie en rechten van de host via items, fallback, className en onClickCapture, zonder een extra sessie te laden. De bestaande voorkeur bepaalt uitgevouwen, pictogrammen of verborgen; tot 860px blijft het navigatievenster. PlatformHeader.leadingContext verschijnt ook in EditorHeader. Capsuleknoppen en afgeronde oppervlakken blijven; dubbele randen vervallen.

Op desktop verbergt een klik op het menu de zijbalk of herstelt de laatst zichtbare modus. Slepen aan het menu of de zijbalkrand schakelt tussen verborgen, alleen pictogrammen en uitgevouwen. De pijltoetsen links/rechts volgen de leesrichting. Geannuleerd slepen behoudt de opgeslagen voorkeur; mobiel blijft het navigatiepaneel gebruiken.

Plaats WorkspaceLocationSync eenmaal onder Suspense in de Next-layout. useWorkspaceQueryState(key, defaultValue, validate) geeft [value, setValue, ready]; useWorkspaceQueryRecord(key, defaults, validators) herstelt alleen gedeclareerde vlakke filters. Zet geen inloggegevens of concepten in URL’s. WorkspacePage herstelt begrensde sessiescrollposities; binnenste gebieden gebruiken data-workspace-scroll-region en WorkspaceScrollRestoration. Annuleerbare native terug/vooruitnavigatie gebruikt de vertrekbeveiliging zonder extra geschiedenis. AdminEntityDialog bewaart invoer na fouten en nieuwe renders; de host beheert versies en opslagresultaten.

Beheer gebruikt vaste tekstrollen: paginatitel 20px/650, sectietitel 16px/600, tekst en navigatie 14px, veldlabels 13px, toelichting 12px. --qk-workspace-body-ink en --qk-workspace-active-ink zijn afgeleid van bestaande platformkleuren.

Primaire pilknoppen gebruiken via --accent-action rechtstreeks het Logo-blauw #4695D8, zonder donker verloop. Hover voegt 8% wit toe; labels gebruiken merkinkt met 10% zwart voor leesbaarheid. Navigatieaccenten behouden hetzelfde blauw en tekst passend bij het thema.

Dropdowns en werkruimtekiezers delen --menu-option-font-size (14px) en --menu-option-font-weight (500), met regelhoogte 1.45; geselecteerde opties gebruiken 600 en metadata 12px/400. WorkspaceNavigationDock laadt doelen van dezelfde oorsprong vooraf bij muishover of toetsenbordfocus, met begrensde deduplicatie. Bestaande vertrekbeveiliging en hostroutes blijven gelden.

2026-09-07 - ColumnLayout

ColumnLayout vult beheervensters met vaste navigatie, een apart scrollgebied en een vaste paginawerkbalk. WorkspacePage gebruikt vlakke secties en gedeelde radius-Tokens. Tot 860px blijft de navigatie een lade, niet interactief wanneer gesloten. Props en bedrijfslogica blijven gelijk. Verwijder dubbele buitenmarges en beperk de leesbreedte binnen formulieren.

2026-09-05 · WorkspaceNavigationMenu / WorkspacePageHeader

Aangemelde werkruimten gebruiken PlatformHeader.workspaceActions voor één account- en navigatiegebied op elke breedte. WorkspacePageHeader deelt titels en acties. WorkspaceNavigationMenu toont de huidige zijbalk met rechten en context; EditorNavigationMenu blijft een compatibele alias. Studio behoudt zijn werkbalk. Publieke kopteksten behouden hun weergave.

WorkspaceNavigationGuard beschermt globale navigatie met dirty, busy, error en optioneel onSave. Pas na bevestigd opslaan met true mag de gebruiker vertrekken; fouten behouden het concept. Language.onBeforeChange(apply) biedt dezelfde bescherming bij taalwijzigingen. Schakel formuliervelden uit tijdens het opslaan.

2026-09-05 · EditorNavigationMenu

EditorNavigationMenu toont de volledige SidebarNavigation van de host als overlay met rechten en projectcontext, zonder het canvas te verschuiven. Taal en thema staan onderaan; submenu’s verwerken Escape eerst. Tot en met 1120px heeft de kop twee rijen en noemt het menu de huidige weergave. Focus en volledig scherm van de browser zijn onafhankelijk. Navigatie wacht op lopende opslag en beschermt concepten.

2026-09-05 · EditorHeader

EditorHeader behoudt het logo, account en globale menu van de host in de actieve editor. startControl en endControl bedienen de zijpanelen, center de weergaven en actions het opslaan. PlatformHeader.editorActions hergebruikt de responsieve navigatie, taal en thema. onNavigate moet onopgeslagen wijzigingen afhandelen voordat de callback wordt uitgevoerd. Op smalle schermen gebruikt de kop twee rijen; submenu’s verwerken Escape eerst.

2026-09-05 · SidebarToggleSlot

SidebarToggleSlot plaatst de bestaande zijbalkknop in de kop van de werkruimte. Gebruik één slot met één linkerzijbalk. SidebarNavigation blijft de status, sneltoetsen en mobiele lade beheren; zonder slot blijven de oorspronkelijke knoppen staan. De knop in de kop sluit ook de mobiele lade; na het sluiten keert de focus terug naar diezelfde knop.

2026-09-05 · EditorWorkspace / Dialog / Segmented

view / onViewChange wisselen tussen edit, focus en preview zonder de editor te vervangen. preview levert het voorbeeld; previewPanel hergebruikt een paneel. layout ondersteunt writing, structure en canvas. storageKey onthoudt paneelbreedtes en ingeklapte panelen, nooit het document.

onSaveAndClose geeft true na bevestigd opslaan, false bij fouten, handled als de host al navigeerde of pending wanneer validatie een beslissing vereist. Bij fouten blijft de editor open. Gebruik closeBehavior="collapse" alleen als de host het concept bewaart. EditorSaveStatus toont bevestigde toestanden. EditorViewControls, EditorLeaveDialog en useEditorLayout zijn ook los te combineren.

Toetsenbordmigratie: Segmented heeft één Tab-stop en gebruikt pijlen / Home / End. Dialog respecteert Escape dat door een onderliggende overlay wordt verwerkt. Daarna verlaat de editor eerst focus of voorbeeld voordat hij sluit. LivePreviewToolbar.exitControl accepteert gedeelde weergaveknoppen. Opslaan, publiceren en rechten blijven bij de host.

2026-09 · EditorWorkspace

EditorWorkspace combineert een dialoog op volledig scherm met focusbeheer en responsieve panelen. dirty vraagt bevestiging voordat wijzigingen worden weggegooid, busy blokkeert sluiten tijdens het opslaan en onSave verwerkt Ctrl/Cmd+S. De toepassing beheert rechten, gegevens, opslaan en publiceren.

2026-08 · Compacte metrische dichtheid

  • Voeg een optionele density="compact" API toe aan MetricCard voor werkruimten met hoge operationele dichtheid;
  • Houd de bestaande standaarddichtheid en DOM-semantiek ongewijzigd;
  • Breng compacte padding, numerieke schaal en minimale hoogte samen in gedeelde componentstijlen, zodat routes geen visuele overschrijvingen meer hoeven toe te passen.

2026-07 · Geünificeerde formulierbesturingselementen

  • Voeg FormField, Input, Textarea, Checkbox, RadioGroup en Switch toe aan @qokit/components/ui;
  • Koppel labels, omschrijvingen, foutmeldingen, verplichte velden en ARIA-referenties via een gedeelde FormField-skeletstructuur;
  • Vereenvoudig Input, Textarea, Select en SearchField tot de afmetingen 40px, 44px en 48px met gedeelde interactie-tokens;
  • Voeg Skin-recepten toe voor nieuwe formulierbasiscomponenten voor het platform, Admin en gegenereerde sites;
  • Behoud de bestaande .qk-field-stijlen als achterwaarts compatibel migratiepad.

2026-07 · Knopgrootte typografie

  • Drie semantische Tokens toegevoegd: --button-font-size-sm, --button-font-size-md, --button-font-size-lg;
  • De sm, md en lg van Button gebruiken nu vast respectievelijk 14px, 15px en 16px tekstgrootte en erven niet langer de tekstgrootte van Header, Dialoog of paginacontainer;
  • Als een site Skin de knoptypografie moet aanpassen, moet deze de corresponderende semantische Token overschrijven in plaats van font-size te herschrijven via routeringsklassen.

2026-07 · Platform-gemeenschappelijke navigatieskelet

  • PlatformHeader zonder inlogafhankelijkheid toegevoegd; platform en documentatiewebpagina delen dezelfde semantische skeletstructuur;
  • PublicPlatformHeader en buildPublicHeaderNavItems toegevoegd; anonieme status op het platform en de documentatiewebpagina delen dezelfde combinatie van gemeenschappelijke Header en navigatieconfiguratie;
  • HeaderNavItem heeft het type menu toegevoegd; desktop Header gebruikt uitschuifmenu's die sluitbaar zijn, mobiele Header vouwt automatisch uit tot linkgroepen;
  • SiteFooter ondersteunt optionele brandHref en controls, geschikt voor verschillende integratiescenario's zoals openbare documentatie;
  • PublicPlatformFooter toegevoegd; platform en documentatiewebpagina delen dezelfde Footer Shell en kunnen platformlinks over domeinen heen verwerken;
  • Bovenstaande zijn backward-compatible optionele API's; de oorspronkelijke Header-statuslogica en Footer-standaardbesturingselementen op het platform blijven ongewijzigd.

2026-07 · Openbare ontwerprichtlijnen

  • Openbare ontwerpcontracten gescheiden van interne AI-implementatiespecificaties;
  • Openbare visuele Tokens, componentimport, grenzen van Skeleton/Skin, Button, Card en toegankelijkheidseisen gedefinieerd;
  • Duidelijk dat destructieve componentwijzigingen migratierichtlijnen moeten bevatten;
  • Openbare zoekopdrachten, Sitemap en LLM-uitvoer bevatten alleen inhoud die extern afhankelijk kan zijn.

Compatibiliteitsinformatie

  • Toegevoegde optionele eigenschappen, optionele Skin-slots en semantische Tokens zijn doorgaans backward-compatible;

  • Verwijderde of hernoemde eigenschappen, of wijzigingen in standaard DOM/semantiek/toetsenbordgedrag, zijn destructieve wijzigingen;

  • Destructieve wijzigingen worden op deze pagina beschreven met invloedsscope, alternatieve API's en migratiestappen.

  • 2026-09-06: Desktopnavigatie behoudt de uitgeklapte zijbalk en pictogrammen en voegt automatisch verbergen toe. SidebarNavigation / WorkspaceNavigationMenu / Dialog

  • 2026-09-06: EditorViewControls scheidt Bewerken/Focus van het volledige scherm. EditorViewControls

  • 2026-09-06: Language en Appearance variant="menu" ondersteunen optioneel layout="row" voor een label, huidige waarde en pijl. De compacte standaardweergave en bescherming bij taalwisselingen blijven behouden. SiteHeaderCopy.helpResources en contactSupport benoemen optioneel de hulplinks in de werkruimte. Language / Appearance

  • 2026-09-06: Pagina’s met een zijbalk verwijderen de dubbele menuknop; de bestaande knop en navigatie-API blijven beschikbaar. WorkspaceNavigation

  • 2026-09-06: Globale navigatie gebruikt een menupictogram, gereedschap gerichte paneelpictogrammen. WorkspacePanelReveal / EditorViewControls

  • 2026-09-06: Weergavemodus · E / T / V / F · Segment.shortcut. EditorViewControls

  • 2026-09-06: PlatformHeader.workspaceNavigation plaatst globale navigatie vóór het logo PlatformHeader.workspaceNavigation

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

EditorHeader.preview toont alleen center als compacte voorbeeldwerkbalk zonder rand; logo, account, opslaan en panelen blijven gemount maar verborgen. Met een aparte LivePreviewToolbar kan de editorkop worden verborgen; EditorViewControls.returnView (edit of focus) herstelt de vorige modus. Behoud toegankelijke terugkeer en onafhankelijke schermvullende bediening; de websitekop blijft zichtbaar.

2026-09-06 · Builder / CMS

Builder en CMS delen BuilderWorkspace, EditorCatalog en EditorComponentSettings voor panelen, invoegillustraties en weergave-instellingen. Voorinstellingen passen gekoppelde opties samen toe en behouden de inhoud; elke toepassing beheert opslaan en ongedaan maken. Bedieningselementen volgen het platformthema en de inhoud het websitethema.

2026-09-06 - EditorViewControls

Eén knop schakelt in beide richtingen: tijdens bewerken staat er Focus, tijdens focus Bewerken. Klik of druk op T; E keert direct terug naar bewerken. In smalle koppen blijft de knop zichtbaar; voorbeeld, volledig scherm en extra acties staan onder Meer. EditorViewControls

2026-09 · Beheerwerkruimten

Smalle tabellen (WorkspaceDataTable, AdminDataTable) tonen gelabelde records met selectie, aangepaste koppen en acties. Gebruik mobileLayout="scroll" voor vergelijkingsmatrices. WorkspaceFilterToolbar plaatst zoeken en filters vóór sortering en weergave. De zijbalk gebruikt h2; de pagina gebruikt h1.

2026-09-08 · Task focus

useSidebarTaskFocus(active) verbergt de navigatie tijdelijk tijdens een gerichte taak. Bij het verlaten keert de vorige weergave terug, tenzij de gebruiker zelf de modus wijzigt. Automatisch verbergen overschrijft de opgeslagen voorkeur niet.

Nieuwe API-referentie (Engels; vertaling volgt)

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.

Nieuwe API-referentie (Engels; vertaling volgt) · 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.

Op deze pagina