Skip to Content
Design

Aktualisierungen der Design-Verträge

Protokoll der Änderungen an den öffentlich zugänglichen Design-Tokens, Komponenten-APIs und Integrationsverträgen von Qokit.

Aktualisierungen der Design-Verträge

2026-10-21 · Feste Aktionen in scrollbaren Menüs

ActionItem.pinned akzeptiert start oder end, um Aktionen und ActionMenu.dropdownHeader außerhalb der scrollbaren Liste zu halten. Tastaturnavigation und Auswahl umfassen alle Bereiche. Portal-Hosts können die Höhe mit --qk-menu-available-height begrenzen; gemessen wird auf der gewählten Seite des Auslösers. Ohne pinned bleibt die bisherige Menüstruktur erhalten.

2026-10-17 · Einstiegspunkt zur Widget-Anpassung

Die Seiten-Widget-Anpassung nutzt den gemeinsamen Header-Einstiegspunkt über Projekte, Inhalte und Dashboards hinweg. CustomizableWidgetLayoutControls fügt optionale customizeButtonRef und disabledCustomize hinzu; Zusammenklapp-Steuerungen sind optional. CustomizableWidgetLibrary teilt mobile Geometrie, initialen Fokus, Escape und Fokus-Rückgabe über Hosts hinweg. Die Widget-Persistenz und Befehle bleiben host-eigen. Siehe Widget-Anpassungsintegration.

2026-10-17 · Verwaltete Workbench-Panel-Steuerelemente

WorkspaceHeaderPortal akzeptiert optionale startControl und endControl, mit passenden optionalen Host-Zielen. Verwaltete Datei-Ansichten nutzen dieselben Header-Panel-Slots und Arbeitsbereichsgeometrien wie die Einzelasset-Bearbeitung und Vorschau. Bestehende Hosts können weiterhin nur Titel, Status und Aktionen bereitstellen. Siehe EditorHeader-Integration.

2026-10-17 · Gemessene Editor-Standardwerte

useWorkspaceResponsiveProfile fügt optionale onWidthChange(width) für verfügbare Arbeitsbereichsmessungen hinzu. useEditorLayout wendet nun konfigurierte gemeinsame Breitenlimits auch auf den Host-Speicher an, und readEditorLayout akzeptiert optionale Limits als viertes Argument. Bestehende Aufrufer behalten ihre Standardwerte bei. Siehe Component Integration.

2026-09-26 · Creator · Stilschemata

Feinabstände · v3: site.theme.spacingOverrides 按 desktop/tablet/mobile → sectionPadding (0–240px), pageGutter, cardGap (0–96px). --qk-site-custom-{sectionPadding|pageGutter|cardGap}-{desktop|tablet|mobile}. 980px / 720px.

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

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

2026-09-09 · Tastenkürzel für die globale Navigation

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

2026-09-08 · EmptyState

Projekt- und CMS-Artikel-/Produkterstellung verwenden gemeinsam EmptyState: zentriert, transparent, kompakt und mit umbrechenden Aktionen. icon, layout, style und description sind optional. Der Titel verwendet h2; eigene strong-Selektoren auf den Skin-Slot title umstellen. Mehrere Aktionen nutzen einen gemeinsamen Container. Berechtigungen und Erstellung bleiben beim Host.

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

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.

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 verwenden über --accent-action direkt das Logo-Blau #4695D8, ohne dunklen Verlauf. Beim Hover werden 8% Weiß beigemischt; die Beschriftung nutzt Marken-Tintenfarbe mit 10% Schwarz für gute Lesbarkeit. Navigationsmarkierungen behalten den blauen Markenton und themengerechte Textfarben.

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.

2026-09-05 · WorkspaceNavigationMenu / WorkspacePageHeader

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.

2026-09-05 · 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. Bis 1120px nutzt die Kopfzeile zwei Zeilen und ein Menü mit dem aktuellen Ansichtsmodus. Fokus und Browser-Vollbild sind unabhängig. Navigation wartet auf laufende Speichervorgänge und schützt Entwürfe.

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

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

2026-09-05 · EditorWorkspace / Dialog / Segmented

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.

2026-09 · EditorWorkspace

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.

2026-08 · Kompakte Metrikdichte

  • MetricCard wurde um die optionale density="compact"-API für hochdichte Arbeitsbereiche im operativen Kontext erweitert;
  • die bestehende Standarddichte und die DOM-Semantik bleiben unverändert;
  • kompakte Innenabstände, numerische Skalen und Mindesthöhen werden zentral in den gemeinsamen Komponenten-Stilen definiert, sodass in den Routen keine visuellen Überschreibungen mehr erforderlich sind.

2026-07 · Einheitliche Formularsteuerelemente

  • @qokit/components/ui wurde um FormField, Input, Textarea, Checkbox, RadioGroup und Switch erweitert;
  • die gemeinsame FormField-Struktur verknüpft Labels, Beschreibungen, Fehlermeldungen, Pflichtfeld-Status und ARIA-Referenzen;
  • Input, Textarea, Select und SearchField wurden auf die Größen 40px, 44px und 48px sowie auf gemeinsame Interaktions-Tokens vereinheitlicht;
  • für die neuen Formular-Grundkomponenten wurden Skin-Rezepte für die Plattform, Admin und generierte Websites hinzugefügt;
  • die bestehenden .qk-field-Stile bleiben als abwärtskompatibler Migrationspfad erhalten.

2026-07 · Typografie für Schaltflächengrößen

  • Drei semantische Tokens hinzugefügt: --button-font-size-sm, --button-font-size-md, --button-font-size-lg;
  • Die sm, md und lg von Button verwenden nun fest 14px, 15px bzw. 16px Schriftgröße und erben nicht mehr die Schriftgröße von Header, Dialog oder Seitencontainern;
  • Wenn Site-Skins die Schaltflächentypografie anpassen möchten, sollten sie das entsprechende semantische Token überschreiben, anstatt font-size über Routen-CSS-Klassen neu zu definieren.

2026-07 · Plattformübergreifende Navigationsstruktur

  • Hinzufügen von PlatformHeader ohne Abhängigkeit von Anmeldestatus; Plattform und Dokumentationswebsite nutzen dieselbe semantische Struktur;
  • Hinzufügen von PublicPlatformHeader und buildPublicHeaderNavItems, sodass der anonyme Status der Plattform und die Dokumentationswebsite denselben öffentlichen Header-Komplex und dieselbe Navigationskonfiguration teilen;
  • HeaderNavItem unterstützt nun den menu-Typ: Desktop-Header verwenden ein schließbares Dropdown-Menü, mobile Header erweitern sich automatisch zu Link-Gruppen;
  • SiteFooter fügt optionale brandHref und controls hinzu, um verschiedene Integrationszenarien wie öffentliche Dokumentation zu unterstützen;
  • Hinzufügen von PublicPlatformFooter, sodass Plattform und Dokumentationswebsite denselben Footer-Shell teilen und plattformübergreifend Links auflösen können;
  • Alle oben genannten sind abwärtskompatible optionale APIs; die ursprüngliche Header-Zustandslogik der Plattform und die Standardsteuerelemente des Footers bleiben unverändert.

2026-07 · Öffentliche Design-Richtlinien

  • Trennung der öffentlichen Design-Verträge von internen KI-Implementierungsspezifikationen;
  • Veröffentlichung von visuellen Tokens, Komponenten-Importen, Grenzen von Skeleton/Skin, Button, Card und Barrierefreiheitsanforderungen;
  • Klare Vorgabe, dass zerstörerische Komponentenänderungen Migrationshinweise enthalten müssen;
  • Öffentliche Suche, Sitemap und LLM-Ausgaben enthalten nur Inhalte, die extern abhängig gemacht werden dürfen.

Kompatibilitätsangaben

  • Neue optionale Attribute, optionale Skin-Platzhalter und semantische Tokens sind in der Regel abwärtskompatibel;

  • Das Löschen oder Umbenennen von Attributen sowie das Ändern des standardmäßigen DOM-/semantischen/Tastaturverhaltens gelten als zerstörerische Änderungen;

  • Zerstörerische Änderungen werden auf dieser Seite mit Beschreibung des Einflussbereichs, alternativen APIs und Migrationsschritten dokumentiert.

  • 2026-09-06: Die Desktop-Navigation bietet eine erweiterte Seitenleiste, Symbole und automatisches Ausblenden. SidebarNavigation / WorkspaceNavigationMenu / Dialog

  • 2026-09-06: EditorViewControls trennt Bearbeiten/Fokus vom nativen Vollbild. EditorViewControls

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

  • 2026-09-06: Seiten mit Seitenleiste entfernen die doppelte Menüschaltfläche; vorhandene Schaltfläche und Navigations-API bleiben verfügbar. WorkspaceNavigation

  • 2026-09-06: Die globale Navigation verwendet ein Menüsymbol, Editor-Werkzeuge gerichtete Panelsymbole. WorkspacePanelReveal / EditorViewControls

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

  • 2026-09-06: PlatformHeader.workspaceNavigation platziert die globale Navigation vor dem Logo PlatformHeader.workspaceNavigation

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.

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

2026-09 · Verwaltungsbereiche

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)

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

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

Neue API-Referenz (Englisch; Übersetzung ausstehend) · 2026-10

2026-10-08 · Workspace title navigation

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

Auf dieser Seite