É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

ChampTypeDescription
idstringIdentifiant de l’élément, unique dans la page.
typeBoardElementTypeType d’élément, par exemple text, shape, image, connector, container, table ou group.
transformIBoardElementTransformPosition, dimensions, rotation, échelle, inclinaison et retournement.
parentId?stringId du contenant ou du groupe parent.
laneId?stringSwimlane id quand l'élément est à l'intérieur d'une nageuse.
name?stringNom de l’élément lisible par l’utilisateur.
description?stringMétadonnées d’accessibilité ou propres à l’application.
visible?booleanIndique si l’élément doit être affiché.
selectable?booleanIndique si l’élément peut être sélectionné dans l’éditeur.
locked?booleanIndique si la modification est verrouillée.
custom?`Record<string, unknown>null`

Types d’éléments

TypeDonnées supplémentairesUtilisation courante
texttext, textStyle, textDataNotes adhésives, libellés et blocs de texte enrichi.
shapeshapeDataRectangles, flèches, légendes et formes personnalisées.
imagesource, imageSourceType, cropImages incorporées.
connectorconnectorDataLignes et flèches reliées à des points libres ou à des formes.
containercontainerDataCadres, zones, couloirs, paquetages UML et frontières de système.
tabletableIdÉléments de tableau fournis par le plugin de tableaux pour Boards.
chartchartIdÉléments de graphique.
mediamediaType, sourceEspaces réservés aux contenus audio et vidéo.
groupchildrenCollections 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.

TypeScript
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.

TypeScript
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 ?

© 2026 DreamNum Co., Ltd.