Skip to main content
Version: 4.3

ElementOverlayProps

Props for the ElementOverlay component.

Properties​

cell?​

readonly optional cell?: ID | Cell<Attributes<Selectors>, ModelSetOptions> | null;

Element the overlay attaches to — a dia.Cell instance or a cell id. Required when used outside renderElement; pass null to unmount the overlay. Inside renderElement, omit this prop: the element is taken from context. Passing cell there is ambiguous, so the overlay renders nothing and logs a warning.


children​

readonly children: ReactNode;

Overlay content rendered over the element.


className?​

readonly optional className?: string;

CSS class name applied to the overlay container.


dx?​

readonly optional dx?: number;

Horizontal pixel offset from the computed position.

Default​

0

dy?​

readonly optional dy?: number;

Vertical pixel offset from the computed position.

Default​

0

origin?​

readonly optional origin?: OverlayPosition;

Which point of the overlay aligns to the attachment point.

Default​

'top-left'

position?​

readonly optional position?: OverlayPosition;

Where on the element's bbox the overlay attaches.

Default​

'top-left'

rotateWithElement?​

readonly optional rotateWithElement?: boolean;

When true, the overlay rotates together with the element. When false, the overlay stays upright and positions against the axis-aligned rotated bounding box.

Default​

false

scaleWithPaper?​

readonly optional scaleWithPaper?: boolean;

When true, the overlay scales together with the paper (zoom).

Default​

false

style?​

readonly optional style?: CSSProperties;

Inline styles applied to the overlay container.