Skip to Content
Design

Komponentenintegration

Öffentlicher Integrationsvertrag für gemeinsame Komponenten, Patterns, Skins und Stil-Tokens von Qokit.

Komponentenintegration

Qokit verwendet das Modell „gemeinsame Struktur + Skin-Rezept“. Externe Integratoren verlassen sich auf die semantischen und Interaktionsverträge der Komponenten und passen das visuelle Erscheinungsbild über Skins und Tokens an.

2026-10-20 · Unabhängige Aktionen in visuellen Auswahlkarten

Optionen von EditorVisualChoiceGroup unterstützen ein optionales accessory für eigene Kartenmenüs oder Namenseditoren. Die gemeinsame RadioGroup platziert es neben dem nativen Label, damit die Verwaltung einer Karte ihre Auswahl nicht auslöst. Mit afterOptions folgt auf die Optionen eine separate Katalogaktion, etwa zum Erstellen einer Karte. Persistenz, Berechtigungen, Validierung und Fokus nach Austausch oder Entfernen bleiben beim Host. Optionen ohne Zubehör behalten Struktur und Verhalten.

2026-10-17 · Gemeinsame Workbench-Panel-Bewegung

EditorWorkbenchChrome rendert injizierte Start-/End-Spuren durch BuilderWorkbenchFrame, dieselbe Panel-Skelettstruktur, die vom Creator und der Inhaltsebearbeitung verwendet wird. Hosts liefern Inhalt, Sichtbarkeits- und Breitenpräferenzen. Desktop verfolgt und teilt Panel-Opazität/Translation über --qk-sidebar-motion-duration und --qk-sidebar-motion-easing; Ziehen deaktiviert Übergänge, und reduzierte Bewegung schaltet sofort um.

Zusammengeklappte Panels bleiben gemountet, um Entwürfe zu behalten. Der gemeinsame Rahmen wendet sofort inert und aria-hidden an, während das Plattform-Skin den Austritt abschließt, bevor die Sichtbarkeit ausgeblendet wird. Kompakte Panels behalten ihre Overlay-Geometrie während des gesamten Austritts bei; Hosts dürfen keine hidden oder display: none zum Panel-Shell hinzufügen. Explizite Peek-Panels behalten ihr bestehendes interaktives Einblendverhalten bei. Header-Wahlmöglichkeiten stehen in offenen/geschlossenen Zuständen weiterhin zur Verfügung; verwenden Sie EditorPanelChoiceShortcuts.mobileMenu, wenn Telefonziele ein gemeinsames Menü teilen sollen.

2026-10-17 · Gemessene Editor-Standardwerte

useWorkspaceResponsiveProfile akzeptiert optionale onWidthChange(width), wobei dieselbe verfügbare Arbeitsbereichsbreite gemeldet wird, die für responsive Profile nach Abzug des Inline-Padding verwendet wird. Nutzen Sie einen stabilen Callback, um proportionale Standardwerte abzuleiten, ohne einen weiteren Observer hinzuzufügen. useEditorLayout wendet sharedWidths.limits sowohl auf Host-Präferenzen als auch auf gemeinsamen Breiten-Speicher an; readEditorLayout akzeptiert dieselben Limits als optionales viertes Argument. Bestehende Aufrufer behalten ihre Standardgrenzen und -verhalten bei.

2026-09-30 · Barrierefreiheit von SelectionToolbar

SelectionToolbar.ariaLabel benennt die Werkzeugleiste optional als Region. Die Anzahl bleibt eine Live-Statusmeldung. Der Host liefert lokalisierte Beschriftungen und kann mit actionContent die gemeinsamen Komponenten EditorToolGroup und ActionMenu einbinden; Berechtigungsprüfungen und Aktionshandler bleiben beim Host.

2026-09-10 · Identitätsabzeichen für Arbeitsbereiche

ProjectSwitcherProject.badge akzeptiert optionale, nicht interaktive React-Inhalte. Das Abzeichen erscheint neben jedem Eintragsnamen, in der nicht gelisteten Zeile des aktuellen Kontexts und neben dem aktuellen Namen in einem Textauslöser. Reine Symbolauslöser bleiben kompakt; Textauslöser der Plattform blenden das Abzeichen auf Telefonbreite aus, damit der Name des Arbeitsbereichs Platz behält. Im geöffneten Menü bleibt es sichtbar. Der Host liefert korrekt abgegrenzte Daten, lokalisierte Beschriftungen und Darstellungsstile; ohne dieses Feld bleibt das bisherige Erscheinungsbild erhalten.

2026-09-08 · EmptyState

EmptyState zentriert das optionale dekorative icon, title, die optionale description und action auf transparenter Fläche. layout="section" ist der kompakte Standard; layout="workspace" reserviert mehr Platz. Aktionen direkt in action einsetzen, mehrere Buttons in einem Fragment; der Container regelt Abstände und lange Beschriftungen. Der Titel ist h2; den Skin-Slot title statt strong verwenden. Bestehende Root-Klassen bleiben erhalten; skin.vars und style werden unterstützt. Lokalisierung, Berechtigungen, Navigation und Erstellung bleiben beim Host; Suche und Fehler behalten eigene Meldungen und Aktionen.

2026-09-08 · SidebarNavigation

SidebarNavigation lädt gleichursprüngliche Routen nach 180 ms Mausverweilen oder Tastaturfokus vor. Feste und eingeblendete Navigation teilen sich höchstens 8 Ziele pro 30 Sekunden. Offline, in verborgenen Tabs, mit Save-Data oder 2G wird nicht vorgeladen; Downloads, deaktivierte Links, neue Fenster und Anker derselben Seite sind ausgeschlossen. Navigation und Schutz ungespeicherter Änderungen bleiben unverändert.

2026-09-07 - AccountDropdown / SidebarProfile

AccountDropdown unterstützt optional compact und preferences: Der kompakte Modus blendet Kennungen und den Erstellungsverlauf aus; standardmäßig bleiben die bisherigen Inhalte erhalten. Appearance und Language verwenden im Kontomenü triggerRole="menuitem". Tastaturnavigation stellt den Fokus wieder her; verschachtelte Sprachdialoge behandeln Escape selbst. SidebarNavigation.searchEnabled ist standardmäßig true; für kurze, feste Navigation eignet sich false. Ein SidebarProfile mit href ohne Menü öffnet in beiden Darstellungsmodi dasselbe Ziel.

2026-09-07 - FormField / AdminEntityDialog / EditorWorkspace

Formulare teilen eine Schriftgrößenskala und umbrechen lange Texte; Pillenformen und Markenfarben bleiben. FormField benennt Gruppen: controlId und die innere Eingabe-id verbinden das Label. SearchField fokussiert nach dem Löschen. Segmented und ControlMenu unterstützen deaktivierte Optionen; deaktivierte ActionMenu-Einträge haben keinen Link. Beschäftigte Buttons behalten Größe und Indikator. AdminEntityDialog prüft Pflichtfelder, E-Mail und JSON, fokussiert Fehler, verhindert doppelte Speicherung und bewahrt Eingaben bei Fehlern. EditorWorkspace bietet ref.focusControl(element) zum Öffnen verborgener Panels vor dem Fokussieren. Reduzierte Bewegung deaktiviert Kontrollübergänge. WorkspaceDialog scrollt lange Inhalte bei sichtbarem Kopf und Aktionen; kurze mobile Dialoge passen sich dem Inhalt an.

2026-09-07 · WorkspaceLocationSync / ProjectSwitcher

Nach einem abgeschlossenen Routenwechsel schließt WorkspaceLocationSync die vorübergehende Bereichsauswahl. Das Ziel zeigt sofort seine Werkzeuge; Such- und Gruppeneinstellungen bleiben erhalten. Bereichsname und Kontext stehen in der Seitenleiste auf getrennten Zeilen. Lange Namen im Kopfbereich werden innerhalb der Schaltfläche gekürzt.

2026-09-07 · Einheitliche Navigation und abgerundete Qokit-Oberflächen

WorkspaceNavigationDock verwendet die Navigation und Berechtigungen des Hosts mit items, fallback, className und onClickCapture. Es lädt keine weitere Sitzung. Die vorhandene Einstellung steuert die erweiterte, Symbol- und ausgeblendete Ansicht; bis 860px bleibt das Navigationsmenü. PlatformHeader.leadingContext erscheint auch im EditorHeader. Kapselförmige Schaltflächen und abgerundete Flächen bleiben erhalten, doppelte Rahmen entfallen.

Auf dem Desktop blendet ein Klick auf das Menü die Seitenleiste aus oder stellt ihren letzten sichtbaren Modus wieder her. Beim Ziehen des Menüs oder des Seitenleistenrands rastet die Ansicht bei ausgeblendet, nur Symbole oder erweitert ein. Links-/Rechtspfeile folgen der Leserichtung. Abgebrochenes Ziehen ändert keine gespeicherten Einstellungen; mobil bleibt das Navigationsmenü.

WorkspaceLocationSync einmal unter Suspense im Next-Layout einbinden. useWorkspaceQueryState(key, defaultValue, validate) liefert [value, setValue, ready]; useWorkspaceQueryRecord(key, defaults, validators) stellt nur deklarierte flache Filter wieder her. Keine Zugangsdaten oder Entwürfe in URLs speichern. WorkspacePage stellt begrenzte Sitzungs-Scrollpositionen wieder her; innere Bereiche verwenden data-workspace-scroll-region und WorkspaceScrollRestoration. Abbrechbare native Zurück-/Vorwärtsnavigation nutzt den Verlassensschutz ohne zusätzliche Verlaufseinträge. AdminEntityDialog behält Eingaben bei Speicherfehlern und erneutem Rendern; Versionen und Speicherergebnisse verantwortet der Host.

Die Verwaltung nutzt feste Schriftrollen: Seitentitel 20px/650, Abschnittstitel 16px/600, Text und Navigation 14px, Feldbeschriftungen 13px, Hinweise 12px. --qk-workspace-body-ink und --qk-workspace-active-ink basieren auf vorhandenen Plattformfarben.

Primäre pillenförmige Buttons behalten das Logo-Blau #4695D8 und verwenden in beiden Designs weiße Texte, Symbole und Ladeindikatoren. Hover hellt weiterhin leicht auf. Sekundäre und gefährliche Aktionen behalten ihre semantischen Farben.

Dropdowns und Arbeitsbereichsumschalter verwenden --menu-option-font-size (14px) und --menu-option-font-weight (500) bei einer Zeilenhöhe von 1.45; ausgewählte Optionen nutzen 600, Metadaten 12px/400. WorkspaceNavigationDock lädt gleichursprüngliche Ziele bei Mauszeigerkontakt oder Tastaturfokus vor und begrenzt die Duplikatverfolgung. Bestehender Verlassensschutz und Host-Routen bleiben wirksam.

2026-09-07 - ColumnLayout

ColumnLayout füllt Desktop-Verwaltungsfenster mit angedockter Navigation, eigenem Inhalts-Scrollbereich und fixierter Seitenwerkzeugleiste. WorkspacePage nutzt flache Abschnitte und gemeinsame Radius-Tokens. Bis 860px bleibt die Navigation eine Schublade, die geschlossen nicht interaktiv ist. Props und Geschäftsverhalten bleiben unverändert. Entfernen Sie doppelte Außenabstände und begrenzen Sie die Lesebreite innerhalb von Formularen.

Import-Einträge

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';
EintragVerwendung
@qokit/components/uiBasis-Komponenten wie Button, Card, Dialog, Menu, Pill usw.
@qokit/components/patternsKombinierte Elemente wie Header, Footer, Workspace, Tabelle, Ressourcen und KI-Assistent
@qokit/components/skins/platformVisuelle Rezepte für Plattform und Workspace
@qokit/components/skins/adminAdmin-Visuelles Rezept
@qokit/components/skins/siteGeneriertes Website-Visuelles Rezept

Grenzen gemeinsamer Zuständigkeiten

PromptPanel akzeptiert optionale referenceReader und lokalisierte referenceCopy-Attribute. Der Reader extrahiert über asynchrone file(File, AbortSignal) und website(url, AbortSignal) die contentExcerpt und truncated-Markierungen; Authentifizierung und API-Zugriff liegen in der Verantwortung des Hosts. Die Komponente verwaltet das Lesen, die Vorschau, Wiederholungen und das Entfernen. Wenn eine gültige URL keinen Anzeigetext hat, ergänzt referenceCopy.websitePrompt die Anfrage automatisch; bei fehlerhaften Formaten wird referenceCopy.errors.url verwendet und das Lesen blockiert. Wenn die URL noch nicht gelesen wurde oder gerade gelesen wird, wartet das Absenden auf den neuesten Inhalt und sendet nur einmal; Änderungen an der Eingabe oder Lesefehler brechen ausstehende Absendeaktionen ab, Wiederholungen stellen alte Absendungen nicht wieder her. Dateien müssen bereit sein, bevor sie gesendet werden können. Vollständige URLs werden automatisch beim Einfügen, beim Verlassen des Fokus oder bei Enter gelesen; die initiale URL wird ebenfalls gelesen und nutzt laufende oder abgeschlossene Ergebnisse. Bei Fehlern wird ein expliziter Wiederholungsversuch angeboten. Das Bearbeiten oder Entfernen einer URL bricht alte Lesevorgänge ab und löscht Ergebnisse. Wenn kein Reader bereitgestellt wird, erfolgt das native Absenden ohne asynchrone Referenzverarbeitung.

Die Aufnahme von Referenzen wurde im September 2026 als optionale und abwärtskompatible Komponentenfunktion hinzugefügt.

Struktur-Komponenten gewährleisten:

  • DOM und semantische Tags;
  • ARIA, Tastatur, Fokus und disabled-Verhalten;
  • Status und grundlegende Interaktionen;
  • Stabile Standard-CSS-Klassen;
  • Benannte Skin-Platzhalter.

Skins können:

  • CSS-Klassen für Platzhalter wie root, header, body, item, action hinzufügen;
  • CSS-Variablen über vars übergeben;
  • Öffentlich freigegebene tone-, layer- oder visuelle Anpassungsschalter der Komponente nutzen.

Skins dürfen keine Daten anfordern, das DOM ändern, Geschäftsregeln halten oder Barrierefreiheitsverhalten umgehen.

Generierte Elementinhalte

Generierte benutzerdefinierte Blöcke verwenden in Schema v2 weiterhin die registrierten html-*-Elemente und verwenden weder ausführbares HTML noch neue Blocktypen. Seit September 2026 stellt @qokit/site-schema bindSiteModuleContent, updateSiteModuleBoundContent und forkSiteModuleContentBindings für die Bindung von Sprachinhalten bereit. Inhaltspfade werden im Modul gespeichert, Besucher-Texte in der Sprachinhalt-Zuordnung; Updates folgen Undo- und Save-Transaktionen. Beim Kopieren oder Verschieben von Elementen über Blockgrenzen hinweg müssen Bindungen abgeleitet werden, um die Quelle nicht zu verändern.

Das optionale extensionRequirements dokumentiert ungelöste Laufzeitbedarfe und ist weder eine Installationsliste noch eine Rechteerteilung. createSiteExtensionHandoff exportiert nicht-ausführbare v1-Entwicklungsanfragen; diese Bedarfe müssen vor der Veröffentlichung einer lauffähigen Website gelöst oder ausdrücklich nach Prüfung ausgeschlossen werden.

Formularsteuerelemente

Gemeinsame Formulare verwenden FormField, um Beschriftungen, Beschreibungen, Pflichtfeld-Metadaten, Fehler und Steuerungs-IDs zu verknüpfen. Textsteuerelemente nutzen Input, mehrzeilige Inhalte Textarea, Auswahlelemente Checkbox, RadioGroup und Switch; bestehende Select und SearchField teilen denselben Größen- und Zustandsvertrag.

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 verknüpft Beschriftungen, Beschreibungen und Fehler über id, aria-describedby, aria-invalid und required mit dem eindeutigen untergeordneten Steuerelement. Verwenden Sie keine zusätzlichen <label>-Wrapper um gemeinsame Steuerelemente.

Input, Textarea, Select und SearchField unterstützen die drei Größen sm, md und lg, entsprechend 40px, 44px und 48px. Einzeilige Steuerelemente verwenden standardmäßig die pill-Form; Textarea nutzt immer die gemeinsame abgerundete Eckenform für mehrzeilige Inhalte. Alle Interaktions- und Fehlerzustände stammen aus gemeinsamen Tokens.

Während der Migration kann weiterhin der alte .qk-field-Vertrag verwendet werden; neue Integrationen sollten gemeinsame Komponenten und benannte Skin-Slots nutzen.

Listen-Auswahl

Seit September 2026 können Listen useWorkspaceSelectionMode({ enabled, resetKey, onClear }) in Kombination mit WorkspaceFilterToolbar.selection verwenden. Dieser Hook ist anfangs inaktiv, setzt sich bei Änderungen des Bereichs oder der Berechtigungen zurück und unterscheidet zwischen dem Leeren der ausgewählten IDs und dem Verlassen des Stapelmodus; Bereichsschlüssel sollten Sammlung, Sprache, Paginierung und Filter umfassen.

Übergeben Sie WorkspaceDataTable.selection nur, wenn der Stapelmodus aktiv ist; Raster- und mobile Checkbox-Steuerelemente nutzen denselben Modus. Die Symbolleiste verwaltet allgemeine Auswahlaktionen, der Nutzer stellt lokalisierte Texte, optionale IDs und berechtigungsgesicherte Domänenaktionen bereit. Das optionale actionContent kann zusätzliche ARIA-Semantik tragen, ersetzt aber keine allgemeinen Steuerelemente oder Bestätigungen. Schreibgeschützte Listen zeigen keinen Stapelmodus an; Dateiauswähler und Vorschlagsprüfungen behalten ihre eigene Semantik.

Diese neuen Funktionen sind optional und abwärtskompatibel; Tabellenauswahl wird weiterhin explizit vom Nutzer gesteuert.

Metrik-Karten

Neue API-Referenz (Englisch; Übersetzung ausstehend) · 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 zeigt standardmäßig ein statisches Bild. motion="breathe" reserviert unsichtbar den Platz und blendet das Logo einmal mit einer 4,8 Sekunden langen Atemanimation ein, sobald die Seite geladen und mindestens die Hälfte sichtbar ist. Header und Footer warten nicht zusätzlich. motionVisibilityDelayMs ergänzt optional eine durchgehende Sichtbarkeitsdauer und ist standardmäßig null. motionOnceKey teilt den Wiedergabestatus bei erneutem Einbinden im selben Dokument; Header und Footer haben getrennte Schlüssel. Navigation, Themenwechsel und Zurückscrollen starten keine Wiederholung; vollständiges Neuladen setzt den Status zurück. Reduzierte Bewegung, deaktiviertes JavaScript oder fehlende Sichtbarkeitsbeobachtung zeigen das statische Logo. motion="reveal" bleibt ein Alias.

PlatformHeader.autoHideOnScroll ist standardmäßig false; PublicPlatformHeader aktiviert es. Beim Herunterscrollen verschwindet der Header, beim Hochscrollen oder nahe dem Seitenanfang erscheint er wieder. Offene Header-Menüs und Fokus im Header halten ihn sichtbar. Arbeitsbereichs- und Editorheader bleiben fest.

PlatformHeader ist die Header-Struktur ohne Geschäftsstatus. PublicPlatformHeader kombiniert darauf Marken-Entry-Punkte, öffentliche Navigation, Sprache, Thema, Anmeldung, „Jetzt erleben“ und mobiles Menü. Der anonyme Plattformstatus und die Dokumentationswebsite nutzen diese Kombination direkt gemeinsam.

Die öffentliche Navigation wird einheitlich über buildPublicHeaderNavItems(copy, links) generiert („Ressourcen / Preise / Neuigkeiten“). Integratoren lösen nur URLs innerhalb der aktuellen Anwendung, der Dokumentationswebsite und der Plattform auf und sollten Menüreihenfolgen oder Texte nicht erneut definieren. Auch der angemeldete Plattform-Header nutzt dieselbe Generierungsfunktion.

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

Die zugrunde liegende navItems unterstützt weiterhin link, scroll und menu. menu unterstützt am Desktop Klick, Tastatur, Escape und Klick außerhalb zum Schließen; mobil erweitert MobileHeaderMenu dies zu Link-Gruppen.

SiteFooter ist die Footer-Struktur; Plattform und Dokumentationswebsite nutzen PublicPlatformFooter, um den äußeren Shell, Marken-Entry-Punkt, Links, Themen- und Sprachsteuerungen einheitlich zu kombinieren. Cross-Domain-Integrationen wandeln relative Plattform-Links über resolveCompanyHref in absolute Adressen um.

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

Geschäftsanwendungen dürfen Header-, Footer-DOM oder öffentliche Navigationsarrays nicht kopieren; für unterschiedliche visuelle Darstellungen sollen PlatformHeaderSkin, SiteFooterSkin oder entsprechende Plattform-Skins verwendet werden.

Kompatibilitätsstrategie

  • Neue optionale Attribute und Skin-Platzhalter gelten als abwärtskompatible Änderungen;
  • Das Löschen von Attributen, das Ändern der Standardsemantik oder das Verändern von DOM-/Tastaturverhalten gelten als zerstörerische Änderungen;
  • Zerstörerische Änderungen müssen im Changelog dokumentiert werden und Migrationsbeispiele enthalten;
  • Verlassen Sie sich nicht auf nicht öffentlich freigegebene interne Klassen, Verzeichnisse oder Routenstrukturen;
  • Wenn zwei oder mehr Integrationspunkte dieselben Überschreibungen benötigen, sollten diese als öffentlicher Skin oder Token angehoben werden.

Bearbeitung im Vollbild

EditorWorkspace verbindet einen Vollbilddialog mit Fokusverwaltung und responsiven Bereichen. dirty bestätigt das Verwerfen von Änderungen, busy verhindert das Schließen beim Speichern und onSave verarbeitet Strg/Cmd+S. Berechtigungen, Daten, Speichern und Veröffentlichen liegen bei der Anwendung.

view / onViewChange wechseln zwischen edit, focus und preview, ohne den Dokumenteditor zu ersetzen. preview liefert die Vorschau; previewPanel nutzt ein vorhandenes Panel. layout unterstützt writing, structure und canvas. storageKey merkt sich Panelbreiten und eingeklappte Panels, keine Dokumentdaten.

onSaveAndClose gibt nach bestätigtem Speichern true, bei Fehlern false, nach Navigation durch den Host handled und bei ausstehender Validierungsentscheidung pending zurück. Fehler lassen den Editor offen. closeBehavior="collapse" setzt voraus, dass der Host den Entwurf behält. EditorSaveStatus zeigt bestätigte Zustände. EditorViewControls, EditorLeaveDialog und useEditorLayout sind auch einzeln kombinierbar.

Tastaturmigration: Segmented hat einen Tab-Stopp; Pfeile / Home / End wechseln die Auswahl. Dialog respektiert Escape in untergeordneten Overlays. Danach verlässt der Editor zuerst Fokus oder Vorschau, bevor er schließt. LivePreviewToolbar.exitControl nimmt die gemeinsamen Ansichtssteuerungen auf. Speichern, Veröffentlichen und Berechtigungen bleiben beim 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 platziert den Schalter der Seitenleiste im Arbeitsbereichskopf. Verwende einen Slot mit einer linken Seitenleiste. SidebarNavigation verwaltet weiterhin Zustand, Tastenkürzel und mobile Navigation; ohne Slot bleiben die bisherigen Bedienelemente erhalten. Der Schalter im Kopfbereich schließt auch die mobile Navigation; danach kehrt der Fokus zu diesem Schalter zurück.

EditorHeader

EditorHeader übernimmt Logo, Konto und globales Menü des Hosts in den aktiven Editor. startControl und endControl steuern die Seitenbereiche, center die Ansicht und actions das Speichern. PlatformHeader.editorActions verwendet die responsive Navigation sowie Sprach- und Designauswahl. onNavigate muss ungespeicherte Änderungen klären, bevor der Callback ausgeführt wird. Auf schmalen Bildschirmen nutzt die Kopfzeile zwei Zeilen; Untermenüs behandeln Escape zuerst.

WorkspaceHeaderPortal.startControl und endControl platzieren verwaltete Seiten-Panel-Toggler in den entsprechenden Slots des Hosts. Hosts bieten optionale startTarget und endTarget neben Titel, Status und Aktionen an. Die Dateien-Bibliothek und der Einzelasset-Arbeitsbereich nutzen workAreaControls; die Asset-Vorschau behält den vollständigen Header, sodass Identität, Rückkehraktion und Panel-Ziele verfügbar bleiben. ProjectWorkspace besitzt die gemeinsamen linken Navigations-/Konversationsauswahlen für Inhalte und Dateien. Dateien registriert seine gespeicherten Ressourcenpanel-Dimensionen über useProjectResourcePanel, portiert Navigation über ProjectContentTools und liefert nur seine rechte Inspektorsteuerung über ProjectToolbar.endControl. Konversation nutzt dieselbe linke Spur und eingebetteten Komponisten über Projektbereiche hinweg; kompakte Ressourcen-, Konversations- und Inspektor-Aufgaben sind gegenseitig ausschließend.

EditorNavigationMenu

EditorNavigationMenu zeigt die vollständige SidebarNavigation des Hosts als überlagernde Seitenleiste mit Berechtigungen und Projektkontext, ohne die Arbeitsfläche zu verschieben. Sprache und Design stehen unten; Untermenüs verarbeiten Escape zuerst. Fokus und Browser-Vollbild sind unabhängig. Navigation wartet auf laufende Speichervorgänge und schützt Entwürfe.

WorkspaceNavigationMenu / WorkspacePageHeader

Die globale Navigation verwendet Command+\ auf dem Mac oder Control+\ unter Windows/Linux, auch unabhängig innerhalb von Creator. T und Shift+T steuern weiterhin das Editorlayout. Eingabefelder, Texteingabekomposition, Wiederholungen und bereits verarbeitete Ereignisse werden ignoriert. Hinweise am Auslöser und aria-keyshortcuts zeigen die Kombination; die globale Navigation belegt das einzelne T nicht mehr.

Angemeldete Arbeitsbereiche verwenden PlatformHeader.workspaceActions für einen gemeinsamen Konto- und Navigationsbereich bei jeder Breite. WorkspacePageHeader vereinheitlicht Titel und Aktionen. WorkspaceNavigationMenu zeigt die aktuelle Seitenleiste mit Berechtigungen und Kontext; EditorNavigationMenu bleibt als kompatibler Alias erhalten. Studio behält seine Werkzeugleiste. Öffentliche Kopfbereiche bleiben unverändert.

WorkspaceNavigationGuard schützt die globale Navigation mit dirty, busy, error und optional onSave. Erst ein bestätigter Speichererfolg mit true erlaubt das Verlassen; Fehler erhalten den Entwurf. Language.onBeforeChange(apply) ermöglicht denselben Schutz vor einem Sprachwechsel. Formularfelder sind während des Speicherns deaktiviert.

Die Desktop-Navigation bietet eine erweiterte Seitenleiste, Symbole und automatisches Ausblenden. Seitenleiste und ausklappbare Navigation teilen Such- und Gruppenstatus. Bei präzisen Zeigern öffnet die Randberührung nach 300ms eine Vorschau, die 320ms nach dem Verlassen schließt; ein Klick hält sie offen. Touch- und Tastatursteuerung bleiben verfügbar. Dialog verwendet standardmäßig modal={true} und autoFocus={true}; die Vorschau setzt beide auf false, um Eingabefokus und Scrollen zu erhalten.

EditorViewControls

Eine Schaltfläche wechselt in beide Richtungen: Beim Bearbeiten zeigt sie Fokus, im Fokus Bearbeiten. Klicken oder T drücken; E führt weiterhin direkt zum Bearbeiten. In schmalen Kopfzeilen bleibt die Schaltfläche sichtbar; Vorschau, Vollbild und weitere Aktionen stehen unter Mehr.

EditorViewControls trennt Bearbeiten/Fokus vom nativen Vollbild. Die Vorschau ist ein eigener Schalter und kehrt zum vorherigen Bearbeitungsmodus zurück; useEditorWorkMode erhält diesen Modus für eigene Beenden-Aktionen. Die Werte edit/focus/preview bleiben gültig. Die Vorschau verwendet nun einen button mit aria-pressed statt eines radio in der Modusgruppe. Vollbild startet nur durch einen Klick und umfasst Navigation und Dialoge im Anwendungswurzelelement; ohne Unterstützung wird die Aktion ausgeblendet.

Language / Appearance

Language und Appearance variant="menu" unterstützen optional layout="row" für Beschriftung, aktuellen Wert und Pfeil. Das kompakte Standardlayout und der Schutz beim Sprachwechsel bleiben erhalten. SiteHeaderCopy.helpResources und contactSupport beschriften optional Hilfelinks im Arbeitsbereich.

requestWorkspaceNavigation

Seiten mit einer Seitenleisten-Schaltfläche blenden die zusätzliche Menüschaltfläche im Kopfbereich auch im eingeklappten und mobilen Layout aus. Editoren und Seiten ohne Seitenleiste behalten sie. requestWorkspaceNavigation(returnFocusTarget?) und useWorkspaceNavigationState() werden aus @qokit/components/patterns/WorkspaceNavigation importiert: Die Anfrage schaltet das registrierte Menü um und gibt ohne verfügbares Menü false zurück. Das optionale Element erhält beim Schließen den Fokus. Vor weiteren Zugängen .available prüfen. Die vorhandene Schaltfläche oder diese API statt der DOM-Position der entfernten Schaltfläche verwenden.

WorkspacePanelReveal

Die globale Navigation verwendet ein Menüsymbol, Editor-Werkzeuge gerichtete Panelsymbole. useWorkspacePanelReveal({ temporary: true }) öffnet Werkzeuge im Fokusmodus per Klick oder Tastatur. toggle(trigger?) und close(true) erhalten Layout und Arbeitsmodus und geben den Fokus zurück. Der Bildschirmrand öffnet die globale Navigation, Werkzeuge reagieren bei ihren Schaltflächen. Die Vorschau verbirgt Panel-Schalter und bietet eine ausdrückliche Rückkehr zum vorherigen Bearbeitungsmodus.

EditorViewControls / Ansichtsmodus

EDITOR_VIEW_SHORTCUTS → Tooltip + aria-keyshortcuts

EditorHeader verwaltet auch EDITOR_TOOLBAR_SHORTCUTS: Command/Control+S aktiviert den sichtbaren EditorSaveButton, Shift+P öffnet EditorStatusAction shortcut="publish" und Shift+M das Werkzeugmenü. Die Befehle verwenden dieselben aktivierten Steuerelemente wie Mausklicks; die Veröffentlichung erfordert eine ausdrückliche Aktion im Panel. Nur die aktive sichtbare Kopfzeile reagiert. Untermenüs, Dialoge, Texteingabekomposition und Wiederholungsereignisse sperren die Befehle; in Eingabefeldern ist nur Speichern erlaubt. Hinweise und aria-keyshortcuts teilen die Definitionen. Ein eigenes toolsControl setzt aria-keyshortcuts={EDITOR_TOOLBAR_SHORTCUTS.tools.aria} am Auslöser. ActionMenu.triggerKeyShortcuts ergänzt Attribut und Hinweis, registriert aber keinen globalen Befehl.

Panelbefehle: Shift+A (Hinzufügen), Shift+L (Seiten/Ebenen), Shift+K (Unterhaltung), Shift+C (Inhalt), Shift+D (Design), Shift+G (globaler Stil). CMS ergänzt bei Verfügbarkeit Shift+S (Einstellungen), Shift+E (SEO), Shift+H (Verlauf). shortcut-Metadaten in EditorChoiceControl, EditorViewTabs und ActionMenu liefern gemeinsame Hinweise. EditorPanelChoiceShortcuts und EditorViewControls.compactActions erhalten Aktionen auch in eingeklappten Telefonmenüs. EditorPanelShortcuts.commands registriert bestehende Aktionen ohne zusätzliche Steuerelemente. Versteckte, inert, deaktivierte und Vorschauzustände sowie Überlagerungen bleiben berücksichtigt. Nichtmodale Telefonseitenleisten desselben Arbeitsbereichs erlauben Panelwechsel; Menüs und modale Dialoge blockieren weiterhin. Unmodifizierte Tasten behalten ihr Verhalten.

Ansichtsmodus
EBearbeiten
TBearbeiten ↔ Fokus
VVorschau / Zur Bearbeitung
FVollbild öffnen / Vollbild beenden

Nur der aktive Editor verarbeitet diese Tasten. Texteingabe, IME-Komposition, gehaltene Tasten sowie offene untergeordnete Dialoge oder Menüs wechseln den Modus nicht.

PlatformHeader.workspaceNavigation

PlatformHeader.workspaceNavigation platziert die globale Navigation vor dem Logo; workspaceActions und editorActions enthalten die Kontoaktionen. Arbeitsbereiche verwenden den vorhandenen Seitenleistenschalter, Editoren platzieren den rechten Werkzeugschalter vor dem Avatar. Auf schmalen Bildschirmen stehen Navigation, Marke, Titel und Avatar über den Bearbeitungswerkzeugen und Speichern. Die DOM-Reihenfolge folgt dem Layout; die rahmenlose Milchglasoptik bleibt erhalten.

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

EditorHeader.preview zeigt nur center als kompakte Vorschauleiste ohne Rahmen; Logo, Konto, Speichern und Bereichsschalter bleiben eingebunden, aber verborgen. Mit einer separaten LivePreviewToolbar kann der Editor-Kopf ausgeblendet werden; EditorViewControls.returnView (edit oder focus) stellt den vorherigen Modus wieder her. Rückkehr und unabhängiges Vollbild bleiben zugänglich; der Website-Kopf bleibt sichtbar.

2026-09-06 · Builder / CMS

Builder und CMS verwenden BuilderWorkspace, EditorCatalog und EditorComponentSettings gemeinsam für Bereiche, Einfügegrafiken und Darstellungsoptionen. Vorlagen wenden zusammengehörige Einstellungen gemeinsam an und erhalten Inhalte; Speichern und Rückgängig bleiben Aufgabe der jeweiligen Anwendung. Die Bedienelemente nutzen das Plattformdesign, die Inhalte das Websitedesign.

SiteFooterLayout erhält ein explizites locale und ein einsprachiges copy. Server-Komponenten rendern die gemeinsame Footer-Struktur; die Steuerelemente für Design und Sprache sowie der QR-Dialog bleiben Client-Komponenten. Die bestehenden Schnittstellen SiteFooter und PublicPlatformFooter werden weiterhin unterstützt.

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

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

Bereite domainübergreifende Links in copy.companyLinks auf dem Server auf. Mit controls passt du den Bereich für interaktive Steuerelemente an.

EditorHeader.titleControl / FloatingAssistant.presentation

EditorHeader.titleControl und EditorWorkspace.titleControl können den Titel durch das gemeinsame Projektmenü ersetzen. Einen beschreibenden title und den Schutz ungespeicherter Änderungen bei der Navigation beibehalten. FloatingAssistant.presentation="embedded" zeigt einen benannten Bereich im Host-Panel ohne schwebenden Auslöser oder Hintergrund an; Standard bleibt floating. Der Host steuert Position und Sichtbarkeit, der Assistent Gesprächszustand und Berechtigungen.

2026-09-07 · WorkspaceAssembly

WorkspaceAssembly markiert ausgehende Karten und eingehende Bereiche ohne zusätzliche Layoutbox. Bei direkten Kindselektoren gehört workspaceAssemblyAttributes(part, index, phase) auf das vorhandene DOM-Element. EditorHeader.assemble und BuilderWorkspacePanels.assemble liefern die Editormarkierungen.

await startWorkspaceAssembly(navigate, destinationPathname) erst nach erfolgreicher Erstellung aufrufen: sichtbare Teile erfassen, einmal navigieren und Ziel oder passendes Ladeskelett in höchstens 720 ms zusammensetzen. Das Ziel braucht eine eingehende canvas-Markierung; useWorkspaceAssemblyPending() hält die Ladefläche bis zum Abschluss der Schnappschüsse eingebunden. Daten und Code währenddessen vorladen. Reduzierte Bewegung oder fehlende Unterstützung führen direkt zum Ziel. Langsame oder unterbrochene Übergänge geben Schnappschüsse frei und setzen die Navigation fort. Markierungen animieren weder Bearbeitung noch Neuladen oder Verlauf. Das Muster bereinigt temporäre Stile; Fehler, Idempotenz und Ladezustand bleiben beim Host.

2026-09 · Verwaltungsbereiche

WorkspacePage und WorkspaceLayout unterstützen variant: overview, list, detail, settings oder editor. WorkspaceFormFooter ordnet die vom Host gelieferten actions, message, tone und busy an; Daten speichert der Host.

Schmale Tabellen (WorkspaceDataTable, AdminDataTable) zeigen standardmäßig beschriftete Datensätze mit Auswahl, eigenen Kopfzeilen und Aktionen. Vergleichsmatrizen verwenden mobileLayout="scroll". WorkspaceFilterToolbar zeigt Suche und Filter vor Sortierung und Ansicht. Seitenleisten verwenden h2; die Seite verwendet h1.

2026-09-08 · Task focus

useSidebarTaskFocus(active) blendet die Navigation während einer konzentrierten Aufgabe vorübergehend aus. Beim Verlassen wird die vorherige Ansicht wiederhergestellt, sofern der Nutzer den Modus nicht selbst geändert hat. Gespeicherte Einstellungen bleiben beim automatischen Ausblenden erhalten.

Neue API-Referenz (Englisch; Übersetzung ausstehend)

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.

Der Web-Adapter reicht auch FloatingAssistantPanel.composerAttachments weiter. Der Slot zeigt vom Host verwaltete Anhänge innerhalb des Nachrichtenformulars vor dem Textfeld. Der Host steuert Rasterposition und Versand: Ablegen bereitet den Anhang vor, Erfolg entfernt nur den gesendeten Anhang, Fehler behalten ihn für einen erneuten Versuch.

Gemeinsame Gesprächskomponenten (englische Referenz; Übersetzung ausstehend)

@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 verwendet InlineNotice für kompakte Aufgabenstatus, Fehler, Ausweichverfahren und Speicherbestätigungen in Unterhaltungen. Übergib einen lokalisierten title sowie optional description, tone und action. Beide Zeilen verwenden die Schriftgröße für Beschriftungen, einen kleinen Abstand und eine transparente Fläche; der Farbton hebt den Status hervor, während ergänzender Text zurückhaltend bleibt. Die Standardwerte role="status" und aria-atomic="true" lassen die gesamte Aktualisierung gemeinsam vorlesen; verwende role="alert" für Fehler, die eine Aktion erfordern. Vom Assistenten verfasster Fließtext bleibt 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.

Neue API-Referenz (Englisch; Übersetzung ausstehend) · 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, fachliche controls, advanced-Optionen, bedingtes reset, Ressourcen-result und ergänzende summary.
  • presentation: view, anzeigen controls und options wie sichtbare Spalten und Seitengröße. Die Seiten-Widget-Anpassung gehört in die Seiten-Header-Aktionen.
  • 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.

Verwenden Sie query.result={{ label, count, total?, locale? }} für Ressourcenname und Ergebniszahl. WorkspaceResultSummary zeigt „Name · Anzahl“ und ergänzt „/ Gesamt“ nur bei einer verlässlichen, abweichenden ungefilterten Gesamtzahl; Zahlen werden passend zur UI-Sprache formatiert und bidirektional isoliert. Lassen Sie result weg, solange die Anzahl unbekannt ist; null ist gültig. Ergänzen Sie über derselben Liste keine weitere Namens- und Zählzeile. AdminFilterBar.result akzeptiert dasselbe Objekt. Seitentitel, sinnvolle Abschnittstitel, Paginierung und Auswahlzahlen behalten ihre Rollen; query.summary dient anderen Einheiten, Suchkontext oder Aktualität.

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.

Ergänzende API-Referenz (Englisch; Übersetzung ausstehend) · 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.

Auswahl- und Menüoptionen unterstützen annotation für einen Punkt in der Designfarbe und dessen lokalisierte Bedeutung im zugänglichen Namen. Der Auslöser von ControlMenu zeigt auch den Punkt der aktiven Option; triggerAnnotation: null beschränkt ihn auf das Menü. Wird eine bereits ausgewählte, aktivierte Option erneut gewählt, ruft das Menü onReselect auf. Native Optionen zeigen die Anmerkung neben der Beschriftung; hidden entfernt einen Platzhalter aus der Auswahlliste. Der Host bestimmt den markierten Wert und die Aktion; das gemeinsame Steuerelement leitet keine Vererbung ab und schreibt keine Daten.

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

Platzieren Sie CustomizableWidgetLayoutControls in den Seiten-Header-Aktionen nach der kontextuellen Hilfe und vor der primären Aktion, einschließlich auf Mobilgeräten. Verwenden Sie lokalisierte copy.customize, um die Aktion explizit zu benennen (z. B. „Widgets anpassen“). Derselbe Icon-nur-Einstiegspunkt exponiert aria-pressed und aria-expanded und wird während der Bearbeitung zu copy.done. customizeButtonRef exponiert optional den Trigger für die Host-Fokus-Wiederherstellung; disabledCustomize deaktiviert den Einstiegspunkt, ohne seine Geometrie zu ändern. Liefern Sie onCollapseToggle und areWidgetsCollapsed nur für Hosts, die das Zusammenklappen von Widgets unterstützen; deren Auslassen rendert nur den Anpassungseinstiegspunkt.

CustomizableWidgetLibrary besitzt die gemeinsame Bibliotheksüberschrift, Zurücksetzen/Schließen-Aktionen, responsives Scroll-Layout, initialen Fokus auf die Schaltfläche „Schließen“ und Escape-Verarbeitung. Das Schließen gibt den Fokus an das aufrufende Steuerelement zurück, wenn der Fokus noch innerhalb der Bibliothek liegt; Klicks außerhalb behalten ihr Ziel-Fokus bei. Hosts behalten Widget-Definitionen, Hinzufügen/Entfernen/Reihenfolge/Größenänderung-Befehle, Persistenz und Zurücksetzungssemantik bei. CMS- und Admin-Klassen-Slots bleiben für Domain-Hooks verfügbar, dürfen aber keine separaten Bibliotheksoberflächen oder mobilen Layouts definieren.

2026-10-17 · Rich ActionMenu-Auslöser

ActionMenu.renderTrigger kann eine reiche Steuerung wie SelectableTile wiederverwenden. Sie empfängt aria-expanded, aria-haspopup, disabled und onClick; verteilen Sie diese auf den tatsächlichen Auslöser. Der Host behält die Selektionssemantik und das Erscheinungsbild der Steuerung bei. Portal-Positionierung, Tastaturnavigation im Menü, Deaktivierung, Fokusrückgabe und optionale mobile Sheets verbleiben in der Verantwortung von ActionMenu. Die Standard-Schaltflächen- und Symbolauslöser bleiben unverändert.

Radius- und Bereichsregler

RangeNumber aus @qokit/components/ui/RangeNumber verbindet einen nativen Schieberegler mit einem präzisen numerischen Input. Übergeben werden label, value, min, max, optional step und unit sowie onChange. Ein undefinierter Wert erscheint als Strich für gemischte Werte; jede Eingabe setzt eine begrenzte Zahl. Mit onCommit fasst der Host fortlaufende Änderungen in seiner Rückgängig-Historie zusammen. disabled, Tastaturnavigation, kompakte Dichte, RTL und Fokusdarstellung werden gemeinsam genutzt; die Speicherung bleibt beim Host. RangeNumberSkin bietet Slots für Wurzel, Regler, Eingabe und Einheit.

EditorRadiusControl aus @qokit/components/patterns/EditorRadiusControl kombiniert eine Live-Formvorschau, vier Eingaben für physische Ecken, RangeNumber und optionale Formvorlagen. value und onChange verwenden die CSS-Kurzschreibweise border-radius; der Host übersetzt cornerLabels und Vorlagennamen. Auch bei RTL gilt die Reihenfolge oben links, oben rechts, unten rechts, unten links. max begrenzt die Bearbeitung auf Pixelwerte; ohne diese Angabe bleiben CSS-Einheiten und elliptische Ecken erhalten. Ein gemischter Radius zeigt erst nach gemeinsamer Einstellung aller vier Ecken einen einzelnen Zahlenwert. EditorRadiusControlSkin passt Wurzel-, Diagramm-, Vorschau- und Vorlagen-Slots an, ohne Zustand oder Speicherung zu ändern.

2026-10-22 · Aktive Navigationstabs auf schmalen Bildschirmen

PillTabs akzeptiert optional scrollActiveTabIntoView mit Standardwert false. Bei horizontalen Tabs wird das aktive direkte Kind PillTabLink oder PillTabButton bei Auswahl und Größenänderung sichtbar gemacht. Nur die Tab-Leiste scrollt; Seitenposition und Tastaturfokus bleiben gleich. LTR und RTL werden mit sofortiger Korrektur unterstützt, auch bei reduzierter Bewegung. Vertikale Tabs und Aufrufer ohne diese Option behalten ihr Verhalten.

Auf dieser Seite

Komponentenintegration2026-10-20 · Unabhängige Aktionen in visuellen Auswahlkarten2026-10-17 · Gemeinsame Workbench-Panel-Bewegung2026-10-17 · Gemessene Editor-Standardwerte2026-09-30 · Barrierefreiheit von SelectionToolbar2026-09-10 · Identitätsabzeichen für Arbeitsbereiche2026-09-08 · EmptyState2026-09-08 · SidebarNavigation2026-09-07 - AccountDropdown / SidebarProfile2026-09-07 - FormField / AdminEntityDialog / EditorWorkspace2026-09-07 · WorkspaceLocationSync / ProjectSwitcher2026-09-07 · Einheitliche Navigation und abgerundete Qokit-Oberflächen2026-09-07 - ColumnLayoutImport-EinträgeGrenzen gemeinsamer ZuständigkeitenGenerierte ElementinhalteFormularsteuerelementeListen-AuswahlMetrik-KartenNeue API-Referenz (Englisch; Übersetzung ausstehend) · 2026-10Plattform-Header und -FooterKompatibilitätsstrategieBearbeitung im VollbildSidebarToggleSlotEditorHeaderEditorNavigationMenuWorkspaceNavigationMenu / WorkspacePageHeaderEditorViewControlsLanguage / AppearancerequestWorkspaceNavigationWorkspacePanelRevealEditorViewControls / AnsichtsmodusPlatformHeader.workspaceNavigation2026-09-06 - EditorHeader.preview / EditorViewControls.returnView2026-09-06 · Builder / CMSAuf dem Server gerenderter Footer · 2026-09-07EditorHeader.titleControl / FloatingAssistant.presentation2026-09-07 · WorkspaceAssembly2026-09 · Verwaltungsbereiche2026-09-08 · Task focusNeue API-Referenz (Englisch; Übersetzung ausstehend)Gemeinsame Gesprächskomponenten (englische Referenz; Übersetzung ausstehend)Neue API-Referenz (Englisch; Übersetzung ausstehend) · 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 · EditorItemDisclosureErgänzende API-Referenz (Englisch; Übersetzung ausstehend) · 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-AuslöserRadius- und Bereichsregler2026-10-22 · Aktive Navigationstabs auf schmalen Bildschirmen