Skip to Content
Ontwerp

Componentintegratie

Openbaar integratiecontract voor gedeelde componenten, patronen, Skin's en stijl-Tokens van Qokit.

Componentintegratie

Qokit gebruikt het model "gedeeld skelet + Skin-recept". Externe integrators vertrouwen op de semantische en interactiecontracten van componenten en passen de visuele weergave aan via Skin's en Tokens.

2026-10-20 · Onafhankelijke acties in visuele keuzekaarten

Opties van EditorVisualChoiceGroup ondersteunen een optioneel accessory voor eigen kaartmenu’s of naameditors. De gedeelde RadioGroup plaatst dit naast het oorspronkelijke label, zodat kaartbeheer de radiokeuze niet activeert. afterOptions plaatst een aparte catalogusactie, zoals een kaart maken, na de opties. De host beheert opslag, rechten, validatie en focus na vervanging of verwijdering. Opties zonder extra acties behouden hun structuur en gedrag.

2026-10-17 · Gedeelde beweging van werktafelpanelen

EditorWorkbenchChrome renderen ingevoegde start-/eindbanen via BuilderWorkbenchFrame, hetzelfde paneelskelet dat wordt gebruikt door Creator en inhoudsbewerking. Hosts leveren inhoud, zichtbaarheids- en breedtevoorkeuren. Desktop volgt en deelt paneeltransparantie/translatie --qk-sidebar-motion-duration en --qk-sidebar-motion-easing; slepen schakelt transities uit en verminderde beweging wordt onmiddellijk toegepast.

Ingeklapte panelen blijven gemonteerd om concepten te behouden. Het gedeelde frame past onmiddellijk inert en aria-hidden toe, terwijl de platformschil het verlaten voltooit voordat de zichtbaarheid wordt verborgen. Compacte panelen behouden hun overlaygeometrie gedurende het hele verlaatproces; hosts mogen geen hidden of display: none aan de paneelschil toevoegen. Exploratieve peek-panelen behouden hun bestaande interactieve onthullingsgedrag. Koptekstkeuzes blijven beschikbaar in open/gesloten toestanden; gebruik EditorPanelChoiceShortcuts.mobileMenu wanneer telefoonbestemmingen een menu moeten delen.

2026-10-17 · Gemeten standaardwaarden voor editor

useWorkspaceResponsiveProfile accepteert optionele onWidthChange(width), waarbij dezelfde beschikbare breedte van het werkgebied wordt gerapporteerd die wordt gebruikt voor responsieve profielen nadat inline-padding is afgetrokken. Gebruik een stabiele callback om proportionele standaardwaarden af te leiden zonder nog een observer toe te voegen. useEditorLayout past sharedWidths.limits toe op zowel hostvoorkeuren als gedeelde breedteopslag; readEditorLayout accepteert dezelfde limieten als zijn optionele vierde argument. Bestaande aanroepers behouden hun standaardgrenzen en -gedrag.

2026-09-30 · Toegankelijkheid van SelectionToolbar

SelectionToolbar.ariaLabel geeft de werkbalk optioneel een naam als regio. De telling blijft een live statusbericht. De host levert vertaalde labels en kan met actionContent de gedeelde componenten EditorToolGroup en ActionMenu combineren; de host blijft verantwoordelijk voor machtigingscontroles en actiehandlers.

2026-09-10 · Identiteitsbadges voor werkruimten

ProjectSwitcherProject.badge accepteert optionele, niet-interactieve React-inhoud. De badge verschijnt naast elke itemnaam, in de rij voor de niet-vermelde huidige context en naast de huidige naam in een teksttrigger. Triggers met alleen een pictogram blijven compact; teksttriggers van het platform verbergen de badge op telefoonbreedte om ruimte te houden voor de werkruimtenaam. In het geopende menu blijft de badge zichtbaar. De host levert correct afgebakende gegevens, gelokaliseerde labels en presentatiestijlen; zonder dit veld blijft de bestaande weergave behouden.

2026-09-08 · EmptyState

EmptyState centreert het optionele decoratieve icon, title, optionele description en action op een transparant vlak. layout="section" is standaard compact; layout="workspace" reserveert meer ruimte. Plaats acties in action, met een fragment voor meerdere knoppen; de container regelt afstanden en lange labels. De titel is h2: gebruik het slot title in plaats van strong. Bestaande rootklassen blijven behouden; skin.vars en style worden ondersteund. De host beheert vertalingen, rechten, navigatie en aanmaak; zoekresultaten en fouten behouden eigen berichten en acties.

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

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.

Importeerpunten

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';
ImportpuntGebruik
@qokit/components/uiBasiscomponenten zoals Button, Card, Dialog, Menu, Pill
@qokit/components/patternsCombinaties zoals Header, Footer, Workspace, Tabel, Resources en AI-assistent
@qokit/components/skins/platformVisuele recepten voor platform en workspace
@qokit/components/skins/adminVisueel recept voor Admin
@qokit/components/skins/siteVisueel recept gegenereerd voor sites

Grens van gemeenschappelijke verantwoordelijkheden

PromptPanel accepteert optionele referenceReader- en gelokaliseerde referenceCopy-eigenschappen. De reader retourneert via asynchrone file(File, AbortSignal) en website(url, AbortSignal) de geëxtraheerde contentExcerpt- en truncated-markeringen; authenticatie en API-toegang worden door de host verzorgd. De component beheert lezen, voorbeeldweergave, opnieuw proberen en verwijderen; bij een geldige URL zonder hinttekst voegt referenceCopy.websitePrompt een aanvullend verzoek toe, bij een formaatfout wordt referenceCopy.errors.url gebruikt en wordt het lezen geblokkeerd. Indien een URL nog niet gelezen is of momenteel wordt gelezen, wacht een indienen op de nieuwste inhoud en dient deze slechts één keer in; wijzigingen in invoer of een mislukte leesbewerking annuleren de wachtende indiening, en opnieuw proberen herstelt geen eerdere indieningen. Bestanden mogen pas worden ingediend wanneer ze gereed zijn. Volledige URLs worden automatisch gelezen bij plakken, verlies van focus of het indrukken van Enter; initiële URLs worden eveneens gelezen en lopende of voltooide resultaten worden hergebruikt; bij falen wordt een duidelijke optie tot opnieuw proberen geboden. Bewerken of verwijderen van een URL annuleert eerdere leesbewerkingen en wist de resultaten. Wanneer geen reader is opgegeven, gaat de native indiening door zonder asynchrone verwijzingsverwerking.

Referentie-inname werd in september 2026 toegevoegd als een optionele en achterwaarts compatibele componentfunctie.

Skeletcomponenten garanderen:

  • DOM en semantische tags;
  • ARIA-, toetsenbord-, focus- en disabled-gedrag;
  • Status en basisinteractie;
  • Stabiele standaardklassen;
  • Genomineerde Skin-slots.

Skin's kunnen:

  • Klassen toevoegen aan slots zoals root, header, body, item, action;
  • CSS-variabelen doorgeven via vars;
  • Gebruikmaken van door de component gepubliceerde tone-, layer- of visuele aanpassingsschakelaars.

Skin's mogen geen data aanvragen, DOM wijzigen, bedrijfsregels vasthouden of toegankelijkheidsgedrag omzeilen.

Gegenereerde elementinhoud

Gegenereerde aangepaste blokken blijven in Schema v2 gebruikmaken van geregistreerde html-*-elementen en maken geen gebruik van uitvoerbare HTML of nieuwe bloktypes. Sinds september 2026 biedt @qokit/site-schema bindSiteModuleContent, updateSiteModuleBoundContent en forkSiteModuleContentBindings voor taalinhoudsbindingen. Inhoudspaden worden in modules opgeslagen, bezoekersteksten in taalinhoudsmappings; updates volgen undo- en opslagtaken. Bij kopiëren of verplaatsen van elementen over blokken heen moet de binding worden afgeleid om wijzigingen aan de bron te voorkomen.

Optionele extensionRequirements registreert onopgeloste runtime-eisen en fungeert niet als installatielijst of machtigingsverlening. createSiteExtensionHandoff exporteert niet-uitvoerbare v1-ontwikkelingsverzoeken; deze eisen moeten worden opgelost of expliciet uitgesloten na goedkeuring voordat een functionele site wordt gepubliceerd.

Formulierbesturingselementen

Gedeelde formulieren gebruiken FormField om labels, uitleg, verplichte metadata, fouten en besturings-ID's te koppelen. Tekstbesturingselementen maken gebruik van Input, meerregelige inhoud van Textarea, en selectiebesturingselementen van Checkbox, RadioGroup en Switch; bestaande Select en SearchField hanteren dezelfde grootte- en statuscontracten.

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 koppelt via id, aria-describedby, aria-invalid en required labels, uitleg en fouten aan unieke subbesturingselementen. Wikkel gedeelde besturingselementen niet langer in extra <label>.

Input, Textarea, Select en SearchField ondersteunen drie formaten: sm, md en lg, overeenkomend met 40 px, 44 px en 48 px. Enkelregelige besturingselementen gebruiken standaard pill-vormen; Textarea hanteert altijd de gedeelde afgeronde hoeken voor meerregelige inhoud. Alle interactie- en foutstatussen komen uit gedeelde tokens.

Tijdens de migratiefase kan het oude .qk-field-contract nog worden gebruikt; nieuwe integraties dienen gedeelde componenten en genaamde skin-slots te gebruiken.

Lijstselectie

Sinds september 2026 kunnen lijsten useWorkspaceSelectionMode({ enabled, resetKey, onClear }) en WorkspaceFilterToolbar.selection combineren. Deze hook is initieel niet geactiveerd, wordt gereset bij wijzigingen in bereik of rechten, en onderscheidt tussen het wissen van geselecteerde ID's en het verlaten van de bulkmodus; bereik-sleutels moeten verzameling, taal, paginering en filtering bevatten.

Dien WorkspaceDataTable.selection alleen door wanneer de bulkmodus actief is; raster- en mobiele selectievakjes gebruiken hetzelfde patroon. De werkbalk verzorgt algemene selectiebewerkingen, terwijl de integratie gelokaliseerde teksten, geschikte zichtbare ID's en op rechten gecontroleerde domeinacties levert. Optionele actionContent kan extra ARIA-semantiek dragen, maar vervangt geen algemene besturingselementen of bevestigingen. Alleen-lezen lijsten tonen geen bulkmodus; bestandskiezers en voorstelbeoordelingen behouden hun eigen semantiek.

Deze nieuwe mogelijkheden zijn optioneel en achterwaarts compatibel; de integratie blijft de tabelselectie expliciet besturen.

Metricskaarten

Nieuwe API-referentie (Engels; vertaling volgt) · 2026-10

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

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

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

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

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

Logo toont standaard een statische afbeelding. motion="breathe" reserveert verborgen de afmetingen en onthult het logo eenmaal met een ademanimatie van 4,8 seconden zodra de pagina geladen is en minstens de helft zichtbaar is. Kop en voettekst wachten niet extra. motionVisibilityDelayMs voegt desgewenst een aaneengesloten zichtbare wachttijd toe, standaard nul. motionOnceKey deelt de afspeelregistratie tussen hermontages in hetzelfde document; kop en voettekst hebben aparte sleutels. Navigatie, themawijzigingen en terugscrollen spelen niets opnieuw af; volledig herladen stelt de registratie opnieuw in. Verminderde beweging, uitgeschakeld JavaScript of ontbrekende zichtbaarheidsobservatie tonen het statische logo. motion="reveal" blijft een alias.

PlatformHeader.autoHideOnScroll is standaard false; PublicPlatformHeader schakelt dit in. De kop verdwijnt bij omlaag scrollen en keert terug bij omhoog scrollen of nabij de bovenkant. Open kopmenu’s en focus in de kop houden hem zichtbaar. Werkruimte- en editorkoppen blijven vast.

PlatformHeader is het Header-skelet zonder bedrijfsstatus. PublicPlatformHeader combineert hierboven merktoegang, gemeenschappelijke navigatie, taal, thema, inloggen, "Nu proberen" en mobiel menu; de anonieme status op het platform en de documentatiewebpagina hergebruiken deze combinatie direct.

Gemeenschappelijke navigatie wordt uniform gegenereerd via buildPublicHeaderNavItems(copy, links) als "Resources / Prijzen / Nieuws". Integrators parseren alleen de interne links van de huidige applicatie, de documentatiewebpagina en platform-URL's; ze moeten de menurvolgorde of -tekst niet opnieuw definiëren. De ingelogde platform Header gebruikt ook dezelfde generatiefunctie.

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

De onderliggende navItems ondersteunt nog steeds link, scroll en menu. menu ondersteunt op desktop klikken, toetsenbord, Escape en klikken buiten het menu om te sluiten; op mobiel vouwt MobileHeaderMenu uit tot linkgroepen.

SiteFooter is het Footer-skelet; platform en documentatiewebpagina gebruiken PublicPlatformFooter om uniform de outer Shell, merktoegang, links, thema- en besturingselementen voor taal te combineren. Cross-domain integratie converteert relatieve platformlinks naar absolute adressen via resolveCompanyHref.

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

Bedrijfsapplicaties mogen de Header- of Footer-DOM of gemeenschappelijke navigatiearrays niet kopiëren; voor verschillende visuele weergaven moeten PlatformHeaderSkin, SiteFooterSkin of de corresponderende platform Skin's worden gebruikt.

Compatibiliteitsstrategie

  • Toegevoegde optionele eigenschappen en Skin-slots zijn backward-compatible wijzigingen;
  • Verwijderde eigenschappen, gewijzigde standaardsemantiek of wijzigingen in DOM/toetsenbordgedrag zijn destructieve wijzigingen;
  • Destructieve wijzigingen moeten worden opgenomen in de Changelog en migratievoorbeelden bevatten;
  • Verlaat niet-ondersteunde interne klassen, mappen of routeringsstructuren;
  • Als twee of meer importpunten dezelfde overschrijving nodig hebben, moet dit worden verhoogd naar een openbare Skin of Token.

Bewerken op volledig scherm

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.

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.

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

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.

WorkspaceHeaderPortal.startControl en endControl plaatsen bestuursde-pagina-paneelschakelaars in de bijpassende slots van de host. Hosts stellen optionele startTarget en endTarget naast titel, status en acties beschikbaar. De Bibliotheek Bestanden en de werkruimte voor een enkel object gebruiken workAreaControls; voorvertoning van objecten behoudt de volledige koptekst zodat identiteit, retouractie en paneelbestemmingen beschikbaar blijven. ProjectWorkspace is eigenaar van de gedeelde linker navigatie/conversatiekeuzes voor Inhoud en Bestanden. Bestanden registreert zijn geheugenresourcepaneelafmetingen via useProjectResourcePanel, portalnavigatie via ProjectContentTools, en levert slechts zijn rechter inspectiebesturingselement via ProjectToolbar.endControl. Conversatie gebruikt dezelfde linkerbana en ingebedde composer over projectgebieden heen; compacte bron-, conversatie- en inspectietaken zijn wederzijds uitsluitend.

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. Focus en volledig scherm van de browser zijn onafhankelijk. Navigatie wacht op lopende opslag en beschermt concepten.

WorkspaceNavigationMenu / WorkspacePageHeader

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. Knophints en aria-keyshortcuts tonen de combinatie; algemene navigatie onderschept de losse T niet meer.

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.

Desktopnavigatie behoudt de uitgeklapte zijbalk en pictogrammen en voegt automatisch verbergen toe. Zijbalk en lade delen de zoekopdracht en groepsstatus. Met een nauwkeurige aanwijzer opent de rand na 300ms een voorbeeld en sluit dit 320ms na vertrek; klikken houdt het open. Aanraak- en toetsenbordbediening blijven beschikbaar. Dialog gebruikt standaard modal={true} en autoFocus={true}; het voorbeeld zet beide op false om invoerfocus en scrollen te behouden.

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 scheidt Bewerken/Focus van het volledige scherm. Voorbeeld is een aparte schakelaar die terugkeert naar de vorige bewerkmodus; useEditorWorkMode bewaart die modus voor aangepaste afsluitacties. De waarden edit/focus/preview blijven geldig. Voorbeeld gebruikt nu een button met aria-pressed in plaats van een radio in de modusgroep. Volledig scherm vereist een klik en omvat navigatie en dialogen binnen de app-root; zonder ondersteuning wordt de actie verborgen.

Language / Appearance

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.

requestWorkspaceNavigation

Pagina’s met een zijbalkknop tonen geen extra menuknop in de koptekst, ook niet ingeklapt of op mobiel. Editors en pagina’s zonder zijbalk behouden de knop. Importeer requestWorkspaceNavigation(returnFocusTarget?) en useWorkspaceNavigationState() uit @qokit/components/patterns/WorkspaceNavigation: de aanvraag schakelt het geregistreerde paneel om en retourneert false als het ontbreekt. Het optionele element krijgt de focus bij sluiten. Controleer .available voordat u een extra ingang toont. Gebruik de bestaande knop of deze API in plaats van de DOM-positie van de verwijderde knop.

WorkspacePanelReveal

Globale navigatie gebruikt een menupictogram, gereedschap gerichte paneelpictogrammen. useWorkspacePanelReveal({ temporary: true }) opent gereedschap tijdelijk met klikken of toetsenbord in Focus. toggle(trigger?) en close(true) behouden indeling en werkmodus en geven de focus terug. De schermrand opent globale navigatie; gereedschap reageert bij de eigen knoppen. Voorbeeld verbergt paneelknoppen en biedt een expliciete terugkeer naar de vorige bewerkingsmodus.

EditorViewControls / Weergavemodus

EDITOR_VIEW_SHORTCUTS → Tooltip + aria-keyshortcuts

EditorHeader beheert ook EDITOR_TOOLBAR_SHORTCUTS: Command/Control+S activeert de zichtbare EditorSaveButton, Shift+P opent EditorStatusAction shortcut="publish" en Shift+M opent het gereedschapsmenu. De opdrachten gebruiken dezelfde ingeschakelde bediening als muisklikken; publiceren vereist een expliciete actie in het paneel. Alleen de actieve zichtbare kop reageert. Submenu’s, dialogen, tekstcompositie en herhaalde gebeurtenissen blokkeren sneltoetsen; in invoervelden mag alleen worden opgeslagen. Hints en aria-keyshortcuts delen de definities. Een eigen toolsControl stelt aria-keyshortcuts={EDITOR_TOOLBAR_SHORTCUTS.tools.aria} in op de trigger. ActionMenu.triggerKeyShortcuts voegt attribuut en hint toe zonder een globale opdracht te registreren.

Panelen gebruiken Shift+A (toevoegen), Shift+L (pagina’s/lagen), Shift+K (gesprek), Shift+C (inhoud), Shift+D (ontwerp), Shift+G (globale stijl). CMS voegt waar beschikbaar Shift+S (instellingen), Shift+E (SEO), Shift+H (geschiedenis) toe. shortcut-metadata in EditorChoiceControl, EditorViewTabs en ActionMenu deelt hints. EditorPanelChoiceShortcuts en EditorViewControls.compactActions behouden acties in ingeklapte menu’s, ook op telefoons. EditorPanelShortcuts.commands registreert bestaande acties zonder dubbele bediening. Verborgen, inert, uitgeschakelde en voorbeeldstatussen en overlays blijven gerespecteerd. Niet-modale mobiele zijbalken in dezelfde werkruimte laten paneelwissels toe; menu’s en modale dialogen blokkeren sneltoetsen. Toetsen zonder wijzigingstoets behouden hun gedrag.

Weergavemodus
EBewerken
TBewerken ↔ Focus
VVoorbeeld / Terug naar bewerken
FVolledig scherm openen / Volledig scherm sluiten

Alleen de actieve editor reageert. Tekstinvoer, IME-compositie, ingedrukte toetsen en geopende onderliggende dialoogvensters of menu’s wijzigen de modus niet.

PlatformHeader.workspaceNavigation

PlatformHeader.workspaceNavigation plaatst globale navigatie vóór het logo; workspaceActions en editorActions behouden accountacties. Werkruimten hergebruiken de bestaande zijbalkknop en editors plaatsen de knop voor het rechterpaneel vóór de avatar. Op smalle schermen staan navigatie, merk, titel en avatar boven de bewerkingshulpmiddelen en Opslaan. De DOM-volgorde volgt de indeling; het randloze matglaseffect blijft behouden.

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.

SiteFooterLayout ontvangt een expliciete locale en een copy in één taal. Servercomponenten renderen de gedeelde footerstructuur; de bediening voor thema en taal en het QR-dialoogvenster blijven clientcomponenten. De bestaande interfaces SiteFooter en PublicPlatformFooter blijven ondersteund.

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

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

Verwerk domeinoverschrijdende links in copy.companyLinks op de server. Gebruik controls om het gedeelte met interactieve bediening aan te passen.

EditorHeader.titleControl / FloatingAssistant.presentation

EditorHeader.titleControl en EditorWorkspace.titleControl kunnen de titel vervangen door het gedeelde projectmenu. Behoud een beschrijvende title en de bescherming van niet-opgeslagen wijzigingen bij navigatie. FloatingAssistant.presentation="embedded" toont een benoemd gebied in het hostpaneel zonder zwevende knop of achtergrondlaag; standaard blijft floating. De host beheert positie en zichtbaarheid; de assistent beheert gespreksstatus en rechten.

2026-09-07 · WorkspaceAssembly

WorkspaceAssembly markeert uitgaande kaarten en inkomende secties zonder extra layoutvak. Plaats workspaceAssemblyAttributes(part, index, phase) op bestaande DOM-elementen als directe kinderen vereist zijn. EditorHeader.assemble en BuilderWorkspacePanels.assemble leveren de editormarkeringen.

Roep await startWorkspaceAssembly(navigate, destinationPathname) alleen aan na geslaagde creatie: leg zichtbare delen vast, navigeer eenmaal en bouw het doel of het passende laadskelet binnen 720 ms op. Het doel vereist een inkomende canvas-markering; useWorkspaceAssemblyPending() houdt het laadscherm gemount totdat de opnamen klaar zijn, terwijl gegevens en code vooraf laden. Minder beweging of ontbrekende ondersteuning leidt direct naar het doel. Trage of onderbroken overgangen geven opnamen vrij en vervolgen de navigatie. Markeringen animeren geen bewerkingen, herladen of geschiedenis. Het patroon ruimt tijdelijke stijlen op; fouten, idempotentie en laadstatus blijven bij de host.

2026-09 · Beheerwerkruimten

WorkspacePage en WorkspaceLayout ondersteunen variant: overview, list, detail, settings of editor. WorkspaceFormFooter rangschikt actions, message, tone en busy van de host; de host slaat gegevens op.

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)

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.

De Web-adapter geeft ook FloatingAssistantPanel.composerAttachments door. Dit slot toont door de host beheerde bijlagen in het berichtformulier, vóór het tekstveld. De host beheert positie en verzending: neerzetten bereidt de bijlage voor, succes verwijdert alleen de verzonden bijlage en fouten behouden deze voor een nieuwe poging.

Gedeelde gesprekken (Engelse referentie; vertaling volgt)

@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 gebruikt InlineNotice voor compacte taakstatussen, fouten, terugvalopties en opslagbevestigingen in gesprekken. Geef een gelokaliseerde title op en optioneel description, tone en action. Beide regels gebruiken de lettergrootte voor bijschriften, een kleine tussenruimte en een transparant oppervlak; de kleurtoon benadrukt de status en de ondersteunende tekst blijft gedempt. De standaardwaarden role="status" en aria-atomic="true" kondigen de volledige update samen aan; gebruik role="alert" voor fouten die actie vereisen. Door de assistent geschreven tekst blijft in 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.

Nieuwe API-referentie (Engels; vertaling volgt) · 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, status-filters, sort, domein-controls, advanced-opties, voorwaardelijke reset, bron-result en aanvullende summary.
  • presentation: view, toon controls en options zoals zichtbare kolommen en paginagrootte. Paginawidgetaanpassing behoort tot de koptekstacties van de pagina.
  • 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.

Gebruik query.result={{ label, count, total?, locale? }} voor de bronnaam en het aantal resultaten. WorkspaceResultSummary toont “Naam · aantal” en voegt “/ totaal” alleen toe als een betrouwbaar ongefilterd totaal afwijkt; getallen volgen de UI-taal en worden in bidirectionele tekst geïsoleerd. Laat result weg zolang het aantal onbekend is; nul is geldig. Voeg boven dezelfde lijst geen tweede naam- en telregel toe. AdminFilterBar.result accepteert hetzelfde object. Paginatitels, zinvolle sectietitels, paginering en geselecteerde aantallen behouden hun rol; gebruik query.summary voor andere eenheden, zoekcontext of actualiteit.

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.

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

Selectie- en menuopties ondersteunen annotation voor een punt in de themakleur en de gelokaliseerde betekenis in de toegankelijke naam. De knop van ControlMenu toont ook het punt van de actieve optie; triggerAnnotation: null beperkt dit tot het menu. Het opnieuw kiezen van een ingeschakelde, geselecteerde optie roept onReselect aan. Native opties tonen de annotatie naast het label; hidden houdt een tijdelijke aanduiding buiten de keuzelijst. De host bepaalt de gemarkeerde waarde en de actie; het gedeelde besturingselement leidt geen overerving af en schrijft geen gegevens.

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

Plaats CustomizableWidgetLayoutControls in de koptekstacties van de pagina na contextuele hulp en vóór de primaire actie, inclusief op mobiel. Gebruik gelokaliseerde copy.customize om de actie expliciet te benoemen (bijvoorbeeld "Widgets aanpassen"). Dezelfde invoer alleen met pictogram exposeert aria-pressed en aria-expanded, en wordt copy.done tijdens het bewerken. customizeButtonRef exposeert optioneel de trigger voor host-focusherstel; disabledCustomize schakelt de invoer uit zonder de geometrie te wijzigen. Lever alleen onCollapseToggle en areWidgetsCollapsed voor hosts die het inklappen van widgets ondersteunen; het weglaten ervan renderen alleen de aanpassingsinvoer.

CustomizableWidgetLibrary is eigenaar van de gemeenschappelijke bibliotheekkop, reset-/sluitacties, responsieve scrollende lay-out, initiële focus op de sluitknop en Escape-behandeling. Sluiten brengt de focus terug naar het aanroepend besturingselement wanneer de focus zich nog steeds binnen de bibliotheek bevindt; klikken buiten houdt de bestemmingsfocus vast. Hosts behouden widgetdefinities, add/remove/order/resize-opdrachten, persistentie en resetsemantiek. CMS- en Admin-klasslots blijven beschikbaar voor domeinhooks, maar mogen geen aparte bibliotheka oppervlakken of mobiele lay-outs definiëren.

2026-10-17 · Rich ActionMenu triggers

ActionMenu.renderTrigger kan een rijk besturingselement zoals SelectableTile hergebruiken. Het ontvangt aria-expanded, aria-haspopup, disabled, en onClick; spreid deze uit over het daadwerkelijke trigger-element. De host behoudt de selectiesemantiek en het uiterlijk van het besturingselement. Portal-positionering, menu-toetsenbordnavigatie, sluiten, focus terugkeer, en optionele mobiele sheets blijven eigendom van ActionMenu. De standaard knop- en pictogramtriggers zijn ongewijzigd.

Besturing voor radius en bereik

RangeNumber uit @qokit/components/ui/RangeNumber koppelt een native schuifregelaar aan een exacte numerieke Input. Geef label, value, min, max, optioneel step en unit, en onChange op. Een ongedefinieerde waarde toont een streepje voor gemengde waarden; elke wijziging stelt één begrensd getal in. Met onCommit groepeert de host doorlopende wijzigingen in de bestaande geschiedenis voor ongedaan maken. disabled, toetsenbordnavigatie, compacte dichtheid, RTL en focusstijlen zijn gedeeld; opslag blijft bij de host. RangeNumberSkin biedt slots voor hoofdcontainer, schuifregelaar, invoer en eenheid.

EditorRadiusControl uit @qokit/components/patterns/EditorRadiusControl combineert een live vormvoorbeeld, vier invoervelden voor fysieke hoeken, RangeNumber en optionele vormvoorinstellingen. value en onChange gebruiken de verkorte CSS-notatie border-radius; de host vertaalt cornerLabels en de namen van voorinstellingen. Ook in RTL blijft de volgorde linksboven, rechtsboven, rechtsonder, linksonder. max beperkt bewerking tot begrensde pixelwaarden; zonder deze optie blijven CSS-eenheden en elliptische hoeken behouden. Een gemengde radius toont pas één getal wanneer alle vier hoeken samen worden ingesteld. EditorRadiusControlSkin past hoofdcontainer, diagram, voorbeeld en voorinstellingen aan zonder toestand of opslag te wijzigen.

2026-10-22 · Actieve navigatietabs op smalle schermen

PillTabs accepteert de optionele instelling scrollActiveTabIntoView, standaard false. Bij horizontale tabs maakt deze het actieve directe kind PillTabLink of PillTabButton zichtbaar bij selectie en formaatwijziging. Alleen de tabstrook scrolt; paginapositie en toetsenbordfocus blijven gelijk. LTR en RTL worden direct gecorrigeerd, ook bij verminderde beweging. Verticale tabs en aanroepen zonder deze optie behouden hun gedrag.

Op deze pagina

Componentintegratie2026-10-20 · Onafhankelijke acties in visuele keuzekaarten2026-10-17 · Gedeelde beweging van werktafelpanelen2026-10-17 · Gemeten standaardwaarden voor editor2026-09-30 · Toegankelijkheid van SelectionToolbar2026-09-10 · Identiteitsbadges voor werkruimten2026-09-08 · EmptyState2026-09-08 · SidebarNavigation2026-09-07 - AccountDropdown / SidebarProfile2026-09-07 - FormField / AdminEntityDialog / EditorWorkspace2026-09-07 · WorkspaceLocationSync / ProjectSwitcher2026-09-07 · Uniforme navigatie en afgeronde Qokit-oppervlakken2026-09-07 - ColumnLayoutImporteerpuntenGrens van gemeenschappelijke verantwoordelijkhedenGegenereerde elementinhoudFormulierbesturingselementenLijstselectieMetricskaartenNieuwe API-referentie (Engels; vertaling volgt) · 2026-10Platform Header en FooterCompatibiliteitsstrategieBewerken op volledig schermSidebarToggleSlotEditorHeaderEditorNavigationMenuWorkspaceNavigationMenu / WorkspacePageHeaderEditorViewControlsLanguage / AppearancerequestWorkspaceNavigationWorkspacePanelRevealEditorViewControls / WeergavemodusPlatformHeader.workspaceNavigation2026-09-06 - EditorHeader.preview / EditorViewControls.returnView2026-09-06 · Builder / CMSOp de server gerenderde footer · 2026-09-07EditorHeader.titleControl / FloatingAssistant.presentation2026-09-07 · WorkspaceAssembly2026-09 · Beheerwerkruimten2026-09-08 · Task focusNieuwe API-referentie (Engels; vertaling volgt)Gedeelde gesprekken (Engelse referentie; vertaling volgt)Nieuwe API-referentie (Engels; vertaling volgt) · 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 · EditorItemDisclosureAanvullende API-referentie (Engels; vertaling volgt) · 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 · Rich ActionMenu triggersBesturing voor radius en bereik2026-10-22 · Actieve navigatietabs op smalle schermen