Éléments d’un Board
Les pages de planche stockent des objets dessinables en elements et leur ordre visuel en elementOrder. Chaque élément a une écurie id, un type et un transform qui enregistre sa position et sa taille sur la toile.
Champs communs aux éléments
| Champ | Type | Description |
|---|---|---|
| id | string | Identifiant de l’élément, unique dans la page. |
| type | BoardElementType | Type d’élément, par exemple text, shape, image, connector, container, table ou group. |
| transform | IBoardElementTransform | Position, dimensions, rotation, échelle, inclinaison et retournement. |
| parentId? | string | Id du contenant ou du groupe parent. |
| laneId? | string | Swimlane id quand l'élément est à l'intérieur d'une nageuse. |
| name? | string | Nom de l’élément lisible par l’utilisateur. |
| description? | string | Métadonnées d’accessibilité ou propres à l’application. |
| visible? | boolean | Indique si l’élément doit être affiché. |
| selectable? | boolean | Indique si l’élément peut être sélectionné dans l’éditeur. |
| locked? | boolean | Indique si la modification est verrouillée. |
| custom? | `Record<string, unknown> | null` |
Types d’éléments
| Type | Données supplémentaires | Utilisation courante |
|---|---|---|
text | text, textStyle, textData | Notes adhésives, libellés et blocs de texte enrichi. |
shape | shapeData | Rectangles, flèches, légendes et formes personnalisées. |
image | source, imageSourceType, crop | Images incorporées. |
connector | connectorData | Lignes et flèches reliées à des points libres ou à des formes. |
container | containerData | Cadres, zones, couloirs, paquetages UML et frontières de système. |
table | tableId | Éléments de tableau fournis par le plugin de tableaux pour Boards. |
chart | chartId | Éléments de graphique. |
media | mediaType, source | Espaces réservés aux contenus audio et vidéo. |
group | children | Collections d’éléments regroupés. |
Conteneurs
Un conteneur détermine quels éléments lui appartiennent par l'intermédiaire de containerData.behavior, et quels éléments il capture par l'entremise de containerData.capturePolicy. Utilisez les méthodes de conteneur Facade pour déplacer les éléments à l'intérieur et à l'extérieur, de sorte que les relations d'ordre et de parent demeurent cohérentes.
board.wrapElementsInContainer(['task-1', 'task-2'], { title: 'Sprint 1',})Couloirs
Une nage est un conteneur qui transporte containerData.swimlane. Chaque voie a un id stable, un titre, une valeur de commande, une taille et un état effondré optionnel.
board.setSwimlaneLanes('lane-board', { orientation: 'horizontal', lanes: [ { id: 'todo', title: 'Todo', order: 0, size: 240 }, { id: 'doing', title: 'Doing', order: 1, size: 240 }, ],})Connecteurs
Les connecteurs se composent de paramètres et de données de routage. Un paramètre peut être un point libre, une limite de forme, un site de connexion ou une ligne de vie. Les données de routing dépendent généralement de la géométrie, donc utilisez les opérations Facade ou les actions d'interface utilisateur lorsque vous modifiez un connecteur.
Que pensez-vous de ce guide ?