Skip to Content
Conception

Mises à jour du contrat de design

Journal des modifications concernant les Tokens de design, l'API des composants et le contrat d'intégration publiés par Qokit.

Mises à jour du contrat de design

2026-10-21 · Actions fixes dans les menus défilants

ActionItem.pinned accepte start ou end pour garder les actions et ActionMenu.dropdownHeader hors de la liste défilante. Navigation au clavier et sélection couvrent toutes les zones. Les hôtes de portails peuvent limiter la hauteur avec --qk-menu-available-height, mesurée du côté choisi du déclencheur. Sans pinned, la structure existante est conservée.

2026-10-17 · Point d'entrée de personnalisation des widgets

La personnalisation des widgets de page utilise le point d'entrée d'en-tête partagé entre Projects, Content et les tableaux de bord. CustomizableWidgetLayoutControls ajoute customizeButtonRef et disabledCustomize optionnels ; les contrôles de réduction sont optionnels. CustomizableWidgetLibrary partage la géométrie mobile, la mise au point initiale, Escape et le retour du focus entre les hôtes. La persistance des widgets et les commandes restent gérées par l'hôte. Voir intégration de la personnalisation des widgets.

2026-10-17 · Contrôles de panneau de poste de travail gérés

WorkspaceHeaderPortal accepte startControl et endControl optionnels, avec des cibles d'hôte correspondantes optionnelles. Les vues Managed Files utilisent les mêmes emplacements de panneau d'en-tête et la même géométrie de zone de travail que l'édition et l'aperçu d'un seul actif. Les hôtes existants peuvent continuer à fournir uniquement le titre, le statut et les actions. Voir intégration EditorHeader.

2026-10-17 · Valeurs par défaut de l'éditeur mesuré

useWorkspaceResponsiveProfile ajoute onWidthChange(width) optionnel pour les mesures de la zone de travail disponible. useEditorLayout applique désormais les limites de largeur partagées configurées au stockage hôte également, et readEditorLayout accepte les limites optionnelles en tant que quatrième argument. Les appelants existants conservent leurs valeurs par défaut. Voir Intégration des composants.

2026-09-26 · Creator · Jeux de styles

Espacement précis · 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.

Boutons et liens: 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 → Automatique.

Couleurs avancées: mutedColor, borderColor, buttonTextColor, cardSurfaceColor 与对应 dark* 字段 (--qk-site-color-card-rgb).

2026-09-09 · Raccourci de navigation globale

SidebarNavigation / WorkspaceNavigationMenu: La navigation globale utilise Command+\ sur Mac ou Control+\ sous Windows/Linux, y compris indépendamment dans Creator. T et Shift+T conservent leur rôle dans la disposition de l’éditeur. Les champs modifiables, la composition de texte, les répétitions et les événements déjà traités sont ignorés.

2026-09-08 · EmptyState

La création de projets et d’articles/produits CMS partage EmptyState : centré, transparent, compact et avec des actions pouvant revenir à la ligne. icon, layout, style et description sont facultatifs. Le titre utilise h2 ; migrez les sélecteurs strong vers le slot de skin title. Les actions partagent un conteneur. Les permissions et la création restent gérées par l’hôte.

2026-09-08 · SidebarNavigation

SidebarNavigation précharge les routes de même origine après 180 ms de survol ou lors du focus clavier. Les navigations fixe et contextuelle partagent une limite de 8 destinations par 30 secondes. Le préchargement est suspendu hors ligne, dans les onglets masqués, avec Save-Data ou en 2G ; téléchargements, liens désactivés, nouvelles fenêtres et ancres locales sont exclus. La navigation et la protection des modifications restent inchangées.

2026-09-08 - Primary button foreground

Les boutons principaux arrondis conservent le bleu du Logo #4695D8 et utilisent du texte, des icônes et des indicateurs blancs dans les deux thèmes. Le survol reste légèrement éclairci. Les boutons secondaires et dangereux gardent leurs couleurs sémantiques.

2026-09-07 - AccountDropdown / SidebarProfile

AccountDropdown accepte les options compact et preferences : le mode compact masque les identifiants et l’historique de création ; le contenu existant reste inchangé par défaut. Appearance et Language acceptent triggerRole="menuitem" dans le menu du compte. La navigation au clavier rétablit le focus et les dialogues de langue imbriqués gèrent Échap. SidebarNavigation.searchEnabled vaut true par défaut ; utilisez false pour une navigation courte et fixe. SidebarProfile avec href, sans menu, ouvre la même destination dans les deux modes.

2026-09-07 - FormField / AdminEntityDialog / EditorWorkspace

Les formulaires partagent une échelle typographique et adaptent les textes longs ; formes arrondies et couleurs de marque restent. FormField nomme les groupes : controlId et l’id interne relient le libellé. SearchField rend le focus après effacement. Segmented et ControlMenu acceptent des options désactivées ; les éléments désactivés de ActionMenu n’ont pas de lien. Les boutons occupés conservent taille et indicateur. AdminEntityDialog valide les champs obligatoires, e-mails et JSON, cible les erreurs, bloque les enregistrements répétés et conserve les saisies après échec. EditorWorkspace offre ref.focusControl(element) pour révéler un panneau avant de cibler son champ. Le mouvement réduit désactive les transitions des contrôles. WorkspaceDialog fait défiler le contenu long en gardant titre et actions visibles ; les courts dialogues mobiles suivent la hauteur du contenu.

2026-09-07 · WorkspaceLocationSync / ProjectSwitcher

Après un changement de route, WorkspaceLocationSync ferme le sélecteur temporaire des espaces pour afficher directement les outils de destination. Les préférences de recherche et de sections sont conservées. Le nom du périmètre et son contexte occupent deux lignes ; les noms longs dans l’en-tête sont tronqués dans le bouton.

2026-09-07 · Navigation unifiée et surfaces arrondies Qokit

WorkspaceNavigationDock réutilise la navigation et les droits de l’hôte via items, fallback, className et onClickCapture, sans charger une autre session. La préférence existante pilote les modes déployé, icônes et masqué ; jusqu’à 860px, le tiroir reste disponible. PlatformHeader.leadingContext apparaît aussi dans EditorHeader. Les boutons en capsule et les surfaces arrondies sont conservés ; les bordures répétées disparaissent.

Sur ordinateur, un clic sur le menu masque la barre latérale ou rétablit son dernier mode visible. Faire glisser le menu ou le bord de la barre permet de passer entre les modes masqué, icônes et développé. Les flèches gauche/droite suivent le sens de lecture. Annuler le glissement conserve la préférence enregistrée ; sur mobile, le tiroir de navigation reste utilisé.

Monter WorkspaceLocationSync une fois sous Suspense dans le layout Next. useWorkspaceQueryState(key, defaultValue, validate) renvoie [value, setValue, ready] ; useWorkspaceQueryRecord(key, defaults, validators) restaure uniquement les filtres plats déclarés. Ne pas placer de secrets ni de brouillons dans les URL. WorkspacePage restaure des positions de défilement de session limitées ; les zones internes utilisent data-workspace-scroll-region et WorkspaceScrollRestoration. Les retours natifs annulables réutilisent la protection de sortie sans ajouter d’historique. AdminEntityDialog conserve les saisies après échec ou nouveau rendu ; l’hôte reste responsable des versions et résultats.

La typographie de gestion utilise des rôles fixes : titre de page 20px/650, titre de section 16px/600, texte et navigation 14px, libellés 13px, indications 12px. --qk-workspace-body-ink et --qk-workspace-active-ink dérivent des couleurs existantes.

Les boutons principaux arrondis utilisent directement le bleu du Logo #4695D8 via --accent-action, sans dégradé assombri. Le survol ajoute 8% de blanc ; les libellés utilisent l’encre de marque mélangée à 10% de noir pour rester lisibles. La navigation conserve la même teinte bleue et un texte adapté au thème.

Les menus déroulants et sélecteurs d’espace partagent --menu-option-font-size (14px) et --menu-option-font-weight (500), avec un interligne de 1.45 ; les options sélectionnées utilisent 600 et les métadonnées 12px/400. WorkspaceNavigationDock précharge les destinations de même origine au survol ou au focus clavier, avec une déduplication bornée. Les protections de sortie et les routes hôtes restent actives.

2026-09-07 - ColumnLayout

ColumnLayout remplit les fenêtres de gestion avec une navigation ancrée, un défilement indépendant et une barre de page fixe. WorkspacePage utilise des sections plates et des Tokens de rayon partagés. Jusqu’à 860px, la navigation reste un tiroir, inactif une fois fermé. Propriétés et comportements métier restent inchangés. Supprimez les marges extérieures doubles et limitez la largeur dans les formulaires.

2026-09-05 · WorkspaceNavigationMenu / WorkspacePageHeader

Les espaces connectés utilisent PlatformHeader.workspaceActions pour partager le compte et la navigation à toutes les largeurs. WorkspacePageHeader harmonise titres et actions. WorkspaceNavigationMenu affiche la barre latérale courante avec ses droits et son contexte ; EditorNavigationMenu reste un alias compatible. Studio conserve sa barre d’outils. Les en-têtes publics gardent leur présentation.

WorkspaceNavigationGuard protège la navigation globale avec dirty, busy, error et onSave facultatif. Seul un enregistrement confirmé renvoyant true autorise le départ ; un échec conserve le brouillon. Language.onBeforeChange(apply) permet la même protection avant un changement de langue. Désactivez les champs pendant l’enregistrement.

2026-09-05 · EditorNavigationMenu

EditorNavigationMenu reprend toute la SidebarNavigation de l’hôte dans un panneau superposé, avec les permissions et le contexte du projet, sans déplacer le canevas. Langue et thème restent en bas ; les sous-menus traitent Échap en premier. Jusqu’à 1120px, l’en-tête occupe deux lignes et le menu indique la vue actuelle. Concentration et plein écran du navigateur sont indépendants. La navigation attend les sauvegardes en cours et protège les brouillons.

2026-09-05 · EditorHeader

EditorHeader conserve le logo, le compte et le menu global dans l’éditeur actif. startControl et endControl commandent les panneaux latéraux, center les vues et actions l’enregistrement. PlatformHeader.editorActions réutilise la navigation responsive, la langue et le thème. onNavigate doit traiter les modifications non enregistrées avant d’exécuter son rappel. Sur écran étroit, l’en-tête occupe deux lignes ; les sous-menus traitent Escape en premier.

2026-09-05 · SidebarToggleSlot

SidebarToggleSlot place la commande du volet latéral dans l’en-tête. Utilisez un seul emplacement avec un volet gauche. SidebarNavigation conserve l’état, les raccourcis et le volet mobile ; sans emplacement, les commandes restent à leur place. Le bouton de l’en-tête ferme également le volet mobile ; le focus revient ensuite à ce même bouton.

2026-09-05 · EditorWorkspace / Dialog / Segmented

view / onViewChange passent entre edit, focus et preview sans remplacer l’éditeur. preview fournit l’aperçu ; previewPanel réutilise un panneau. layout accepte writing, structure et canvas. storageKey mémorise les largeurs et les panneaux repliés, jamais le document.

onSaveAndClose renvoie true après confirmation de l’enregistrement, false en cas d’échec, handled si l’hôte a déjà navigué, ou pending si la validation attend une décision. L’échec garde l’éditeur ouvert. Réserver closeBehavior="collapse" aux hôtes qui conservent le brouillon. EditorSaveStatus affiche un état confirmé. EditorViewControls, EditorLeaveDialog et useEditorLayout peuvent aussi être composés séparément.

Migration clavier : Segmented occupe un seul arrêt Tab et utilise les flèches / Home / End. Dialog respecte Échap traité par une superposition enfant ; l’éditeur quitte ensuite la concentration ou l’aperçu avant de se fermer. LivePreviewToolbar.exitControl accepte les commandes de vue partagées. Enregistrement, publication et autorisations restent gérés par l’hôte.

2026-09 · EditorWorkspace

EditorWorkspace associe une boîte de dialogue plein écran, la gestion du focus et des panneaux adaptatifs. dirty demande confirmation avant de perdre les modifications, busy bloque la fermeture pendant la sauvegarde et onSave gère Ctrl/Cmd+S. Les autorisations, les données, la sauvegarde et la publication relèvent de l’application.

Août 2026 · Densité des métriques compacte

  • Ajout d'une API density="compact" optionnelle pour MetricCard, destinée aux espaces de travail opérationnels à haute densité ;
  • La densité par défaut et la sémantique du DOM restent inchangées ;
  • Les marges internes compactes, l'échelle des valeurs et la hauteur minimale sont désormais centralisées dans les styles des composants partagés, éliminant ainsi la nécessité de surcharges visuelles au niveau des routes.

Juillet 2026 · Contrôles de formulaire unifiés

  • Ajout de FormField, Input, Textarea, Checkbox, RadioGroup et Switch à @qokit/components/ui ;
  • La structure partagée FormField associe désormais les étiquettes, les descriptions, les messages d'erreur, les indicateurs de champ obligatoire et les références ARIA ;
  • Input, Textarea, Select et SearchField sont unifiés autour des tailles 40px, 44px et 48px, avec des jetons d'interaction partagés ;
  • Ajout de recettes Skin pour les plateformes, l'Admin et les sites générés pour les nouveaux composants de base des formulaires ;
  • Les styles existants .qk-field sont conservés comme chemin de migration rétrocompatible.

2026-07 · Typographie des tailles de bouton

  • Ajout de trois Tokens sémantiques : --button-font-size-sm, --button-font-size-md et --button-font-size-lg ;
  • Les valeurs sm, md et lg de Button sont désormais fixes à 14px, 15px et 16px respectivement pour la taille du texte, et n'héritent plus de la taille de police du Header, du Dialog ou du conteneur de page ;
  • Si le Skin du site nécessite un ajustement de la typographie des boutons, il doit écraser le Token sémantique correspondant, plutôt que de réécrire font-size via une classe de route.

2026-07 · Structure de navigation publique de la plateforme

  • Ajout de PlatformHeader sans dépendance d'authentification, permettant à la plateforme et au site de documentation de partager la même structure sémantique ;
  • Ajout de PublicPlatformHeader et buildPublicHeaderNavItems, permettant à l'état anonyme de la plateforme et au site de documentation de réutiliser la même combinaison de Header public et de configuration de navigation ;
  • HeaderNavItem introduit le type menu : le Header de bureau utilise un menu déroulant fermable, tandis que le Header mobile se développe automatiquement en groupes de liens ;
  • SiteFooter ajoute les options brandHref et controls, supportant différents scénarios d'intégration tels que les documents publics ;
  • Ajout de PublicPlatformFooter, permettant à la plateforme et au site de documentation de partager le même Footer Shell, tout en autorisant la résolution des liens de la plateforme entre domaines ;
  • Il s'agit d'APIs optionnelles rétrocompatibles ; la logique d'état du Header plateforme existante et les contrôles par défaut du Footer restent inchangés.

2026-07 · Guide de design public

  • Séparation du contrat de design public et des spécifications internes d'implémentation de l'IA ;
  • Publication des Tokens visuels, de l'importation des composants, des limites Skeleton/Skin, des exigences pour Button, Card et l'accessibilité ;
  • Clarification que les changements cassants des composants doivent fournir des instructions de migration ;
  • La recherche, le Sitemap et les sorties LLM ne contiennent que des éléments pouvant être dépendus publiquement.

Notes de compatibilité

  • Les propriétés optionnelles, les emplacements de Skin optionnels et les Tokens sémantiques ajoutés sont généralement rétrocompatibles ;

  • La suppression ou le renommage de propriétés, ainsi que le changement du comportement par défaut du DOM/sémantique/clavier, constituent des changements cassants ;

  • Les changements cassants indiqueront sur cette page l'étendue de l'impact, l'API alternative et les étapes de migration.

  • 2026-09-06: La navigation de bureau propose une barre développée, des icônes et le masquage automatique. SidebarNavigation / WorkspaceNavigationMenu / Dialog

  • 2026-09-06: EditorViewControls sépare Édition/Concentration du plein écran natif. EditorViewControls

  • 2026-09-06: Language et Appearance variant="menu" acceptent layout="row" pour afficher le libellé, la valeur actuelle et une flèche. La disposition compacte par défaut et la protection du changement de langue restent inchangées. SiteHeaderCopy.helpResources et contactSupport nomment les liens d’aide facultatifs de l’espace de travail. Language / Appearance

  • 2026-09-06: Les pages avec panneau latéral retirent le bouton de menu en double ; le bouton existant et l’API de navigation restent disponibles. WorkspaceNavigation

  • 2026-09-06: La navigation globale utilise une icône de menu, les outils des icônes de panneaux directionnels. WorkspacePanelReveal / EditorViewControls

  • 2026-09-06: Mode d’affichage · E / T / V / F · Segment.shortcut. EditorViewControls

  • 2026-09-06: PlatformHeader.workspaceNavigation place la navigation globale avant le logo PlatformHeader.workspaceNavigation

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

EditorHeader.preview affiche seulement center comme barre de prévisualisation compacte sans bordure ; logo, compte, sauvegarde et panneaux restent montés mais masqués. Avec une LivePreviewToolbar séparée, masquez l’en-tête de l’éditeur et utilisez EditorViewControls.returnView (edit ou focus) pour retrouver le mode précédent. Gardez le retour accessible et le plein écran indépendant ; l’en-tête du site reste visible.

2026-09-06 · Builder / CMS

Builder et CMS partagent BuilderWorkspace, EditorCatalog et EditorComponentSettings pour les panneaux, les illustrations d’insertion et les réglages visuels. Les préréglages appliquent ensemble les options liées et préservent le contenu ; chaque application gère l’enregistrement et l’annulation. Les commandes suivent le thème de la plateforme et le contenu celui du site.

2026-09-06 - EditorViewControls

Un seul bouton permet les deux sens : en édition, il affiche Concentration ; en concentration, Modifier. Cliquez ou appuyez sur T ; E revient directement à l’édition. Sur les en-têtes étroits, le bouton reste visible ; aperçu, plein écran et actions supplémentaires sont dans Plus. EditorViewControls

2026-09 · Espaces de gestion

Les tableaux étroits (WorkspaceDataTable, AdminDataTable) affichent des fiches étiquetées avec sélection, en-têtes personnalisés et actions. Utilisez mobileLayout="scroll" pour les matrices comparatives. WorkspaceFilterToolbar place recherche et filtres avant tri et affichage. La barre latérale utilise h2, la page h1.

2026-09-08 · Task focus

useSidebarTaskFocus(active) masque temporairement la navigation pendant une tâche demandant de la concentration. À la sortie, il rétablit le mode précédent, sauf si l’utilisateur le modifie explicitement. Le masquage automatique conserve la préférence enregistrée.

Nouvelles références API (anglais ; traduction à venir)

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.

Nouvelles références API (anglais ; traduction à venir) · 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.

Sur cette page

Mises à jour du contrat de design2026-10-21 · Actions fixes dans les menus défilants2026-10-17 · Point d'entrée de personnalisation des widgets2026-10-17 · Contrôles de panneau de poste de travail gérés2026-10-17 · Valeurs par défaut de l'éditeur mesuré2026-09-26 · Creator · Jeux de styles2026-09-09 · Raccourci de navigation globale2026-09-08 · EmptyState2026-09-08 · SidebarNavigation2026-09-08 - Primary button foreground2026-09-07 - AccountDropdown / SidebarProfile2026-09-07 - FormField / AdminEntityDialog / EditorWorkspace2026-09-07 · WorkspaceLocationSync / ProjectSwitcher2026-09-07 · Navigation unifiée et surfaces arrondies Qokit2026-09-07 - ColumnLayout2026-09-05 · WorkspaceNavigationMenu / WorkspacePageHeader2026-09-05 · EditorNavigationMenu2026-09-05 · EditorHeader2026-09-05 · SidebarToggleSlot2026-09-05 · EditorWorkspace / Dialog / Segmented2026-09 · EditorWorkspaceAoût 2026 · Densité des métriques compacteJuillet 2026 · Contrôles de formulaire unifiés2026-07 · Typographie des tailles de bouton2026-07 · Structure de navigation publique de la plateforme2026-07 · Guide de design publicNotes de compatibilité2026-09-06 - EditorHeader.preview / EditorViewControls.returnView2026-09-06 · Builder / CMS2026-09-06 - EditorViewControls2026-09 · Espaces de gestion2026-09-08 · Task focusNouvelles références API (anglais ; traduction à venir)Nouvelles références API (anglais ; traduction à venir) · 2026-102026-10-08 · Workspace title navigation