Class: SharedCanvasState

Defined in: diagram/sharedCanvasState.ts:79

Stores common state and settings for multiple canvases.

Properties

Property	Modifier	Type	Description
defaultElementTemplate	readonly	ElementTemplate	Default element template to use as a fallback.
defaultLayout	readonly	LayoutFunction	Default layout algorithm function to use if it's not specified explicitly.
defaultLinkTemplate	readonly	LinkTemplate	Default link template to use as a fallback.
events	readonly	Events<SharedCanvasStateEvents>	Event for the shared canvas state.
renameLinkProvider	readonly	undefined | RenameLinkProvider	A strategy to rename diagram links (change labels).

Accessors

highlighter

Get Signature

get highlighter(): undefined | CellHighlighter

Defined in: diagram/sharedCanvasState.ts:210

Returns active highlight for the diagram cells.

Experimental: this feature will likely change in the future.

Returns

undefined | CellHighlighter

---

widgets

Get Signature

get widgets(): ReadonlyMap<string, CanvasWidgetDescription>

Defined in: diagram/sharedCanvasState.ts:150

Live collection of canvas widgets rendered on each canvas.

Returns

ReadonlyMap<string, CanvasWidgetDescription>

Methods

findAllCanvases()

findAllCanvases(): CanvasApi[]

Defined in: diagram/sharedCanvasState.ts:133

Returns all canvases that use this shared state.

Returns

CanvasApi[]

---

findAnyCanvas()

findAnyCanvas(): undefined | CanvasApi

Defined in: diagram/sharedCanvasState.ts:142

Returns any canvas that uses this shared state or undefined if none found.

Returns

undefined | CanvasApi

---

setCanvasWidget()

setCanvasWidget(key, widget): void

Defined in: diagram/sharedCanvasState.ts:161

Adds, changes or removes a canvas widget from being rendered on the canvases.

Parameters

Parameter	Type	Description
key	string	unique key for a widget
widget	null | CanvasWidgetDescription	widget description with a target widget layer to render on or null to remove the widget

Returns

void

---

setHandlerForNextDropOnPaper()

setHandlerForNextDropOnPaper(handler): void

Defined in: diagram/sharedCanvasState.ts:182

Sets the handler for the next drop event from drag-and-drop operation on a canvas.

Experimental: this feature will likely change in the future.

Parameters

Parameter	Type
handler	undefined | (e) => void

Returns

void

---

setHighlighter()

setHighlighter(value): void

Defined in: diagram/sharedCanvasState.ts:216

Sets or removes an active highlight for the diagram cells.

Experimental: this feature will likely change in the future.

Parameters

Parameter	Type
value	undefined | CellHighlighter

Returns

void

---

tryHandleDropOnPaper()

tryHandleDropOnPaper(e): boolean

Defined in: diagram/sharedCanvasState.ts:194

Tries to run previously set drop handler on a canvas, then removes the handler if it was set.

Experimental: this feature will likely change in the future.

Parameters

Parameter	Type
e	CanvasDropEvent

Returns

boolean

true if a handler was set, otherwise false