Passer au contenu principal

Aide-mémoire des diagrammes en couloirs Mermaid

Mermaid n’a pas de couloirs natifs. Utilisez un sous-graphe par rôle ; préférez une séquence pour les messages ou architecture-beta pour des groupes d’infrastructure.

Créer avec l’outil Éditeur d’organigrammes Mermaid →

Démarrage rapide

Créez un sous-graphe par rôle, puis reliez leurs actions avec les ids des nœuds.

flowchart LR
  subgraph author ["Auteur"]
    direction TB
    A["Brouillon"] --> B["Réviser"]
  end
  subgraph reviewer ["Relecteur"]
    direction TB
    C["Vérifier"] --> D["Approuver"]
  end
  A --> C
  C --> B
  B --> D

Chargement…

Référence de syntaxe

Référence de syntaxe
SyntaxeSignification
flowchart LR / flowchart TBUtilisez flowchart ; swimlane n’est pas un mot-clé de diagramme valide.
subgraph laneId ["Role"] / endGroupe les actions d’un rôle ; ids de couloirs et nœuds doivent différer.
direction TB / direction LRDemande une direction interne ; les liens externes peuvent la remplacer.
A --> B / A -->|Handoff| BRelie les actions de couloirs distincts et libelle le passage.
laneA --> laneB / A ~~~ BLes liens entre groupes et invisibles influencent l’ordre sans fixer les coordonnées.
style laneId fill:#f5f5f5,stroke:#a1a1a1Style directement le fond et le bord du sous-graphe.
classDef / class A name / A:::nameApplique des styles réutilisables aux actions.
%% / accTitle: / accDescr:Commentaires et descriptions accessibles ; le reste de flowchart reste disponible.

Structure par responsabilité

Chaque action appartient à un rôle. Les ids de groupe identifient les rôles, ceux des nœuds les actions. Relier les groupes entiers préserve mieux leur direction.

flowchart LR
  subgraph writer ["Rédacteur"]
    direction TB
    A["Plan"] --> B["Brouillon"]
  end
  subgraph editor ["Éditeur"]
    direction TB
    C["Révision"] --> D["Valider"]
  end
  writer --> editor

Chargement…

Passages entre couloirs

Les liens entre actions représentent des passages précis, mais peuvent faire hériter au groupe la direction globale.

flowchart TB
  subgraph requester ["Demandeur"]
    direction LR
    A["Soumettre"] --> B["Répondre"]
  end
  subgraph approver ["Responsable d’approbation"]
    direction LR
    C["Évaluer"] --> D["Approuver"]
  end
  A -->|Demande| C
  C -->|Modifications| B
  B --> D

Chargement…

Fonds et styles

style modifie le couloir et classDef les actions. Gardez texte et bords lisibles ; la couleur complète le nom du rôle.

flowchart LR
  subgraph drafting ["Rédaction"]
    A["Rédiger"]:::action
  end
  subgraph checking ["Vérification"]
    B["Révision"]:::action
  end
  A --> B
  style drafting fill:#f5f5f5,stroke:#a1a1a1
  style checking fill:#d3e5ff,stroke:#0070f3
  classDef action fill:#ffffff,stroke:#171717,color:#171717

Chargement…

Espacement sans couloirs fixes

rankSpacing sépare les passages et nodeSpacing les actions. Mermaid contrôle ordre, largeur et positions ; divisez les processus longs.

---
config:
  flowchart:
    nodeSpacing: 40
    rankSpacing: 70
---
flowchart LR
  subgraph drafting ["Rédaction"]
    A["Rédiger"]
  end
  subgraph review ["Révision"]
    B["Vérifier"]
  end
  A --> B

Chargement…

Erreurs fréquentes

Commencer par swimlane

Commencez par flowchart et créez des sous-graphes.

Syntaxe incorrecte : correction ci-dessous

swimlane
  Author --> Reviewer
flowchart LR
  subgraph author ["Auteur"]
    A["Brouillon"]
  end
  subgraph reviewer ["Relecteur"]
    B["Vérifier"]
  end
  A --> B

Chargement…

Supposer des largeurs égales

Les groupes s’adaptent au contenu ; les liens invisibles ne créent pas de grille fixe.

Limites

  • Ordre et largeur se contrôlent indirectement ; la disposition peut réordonner les nœuds.
  • Les connexions entre couloirs peuvent remplacer la direction interne.
  • Les processus longs deviennent vite encombrés.
  • architecture-beta décrit l’infrastructure, les séquences les messages ; aucun n’offre de couloirs natifs.

Foire aux questions

Mermaid a-t-il des couloirs natifs ?
Non : cette référence approche les couloirs avec des sous-graphes flowchart.
Puis-je fixer des largeurs égales ?
Il n’existe pas d’option native ; contenu et disposition déterminent les largeurs.
Quand préférer une séquence ?
Quand l’essentiel est de savoir qui envoie chaque message et dans quel ordre.