Skip to content
Mog is in active development. The GitHub repo, SDK packages, and community channels are not yet available. Follow for launch updates

ws.smartArt

WorksheetSmartArt

18 methods

add

Promise<string>
add(config: SmartArtConfig): Promise<string>;
ParameterTypeRequired
configSmartArtConfigrequired

Add a SmartArt diagram to the sheet. Returns the object ID.

get

Promise<SmartArtDiagram | null>
get(objectId: string): Promise<SmartArtDiagram | null>;
ParameterTypeRequired
objectIdstringrequired

Get a SmartArt diagram by object ID, or null if not found.

remove

Promise<void>
remove(objectId: string): Promise<void>;
ParameterTypeRequired
objectIdstringrequired

Remove a SmartArt diagram by object ID.

list

Promise<SmartArtDiagram[]>
list(): Promise<SmartArtDiagram[]>;

List all SmartArt diagrams on the sheet.

duplicate

Promise<string>
duplicate(objectId: string): Promise<string>;
ParameterTypeRequired
objectIdstringrequired

Duplicate a SmartArt diagram. Returns the new object ID.

addNode

NodeId | Promise<NodeId>
addNode(
    objectId: string,
    text: string,
    position: NodePosition,
    referenceNodeId: NodeId | null,
  ): NodeId | Promise<NodeId>;
ParameterTypeRequired
objectIdstringrequired
textstringrequired
positionNodePositionrequired
referenceNodeIdNodeId | nullrequired

Add a node to a diagram. Returns the new node ID.

removeNode

void | Promise<void>
removeNode(objectId: string, nodeId: NodeId): void | Promise<void>;
ParameterTypeRequired
objectIdstringrequired
nodeIdNodeIdrequired

Remove a node from a diagram.

updateNode

void | Promise<void>
updateNode(
    objectId: string,
    nodeId: NodeId,
    updates: Partial<SmartArtNode>,
  ): void | Promise<void>;
ParameterTypeRequired
objectIdstringrequired
nodeIdNodeIdrequired
updatesPartial<SmartArtNode>required

Update a node's properties.

moveNode

void | Promise<void>
moveNode(objectId: string, nodeId: NodeId, direction: NodeMoveDirection): void | Promise<void>;
ParameterTypeRequired
objectIdstringrequired
nodeIdNodeIdrequired
directionNodeMoveDirectionrequired

Move a node in the hierarchy.

getNode

SmartArtNode | undefined | Promise<SmartArtNode | undefined>
getNode(
    objectId: string,
    nodeId: NodeId,
  ): SmartArtNode | undefined | Promise<SmartArtNode | undefined>;
ParameterTypeRequired
objectIdstringrequired
nodeIdNodeIdrequired

Get a node by ID.

getDiagram

SmartArtDiagram | undefined | Promise<SmartArtDiagram | undefined>
getDiagram(objectId: string): SmartArtDiagram | undefined | Promise<SmartArtDiagram | undefined>;
ParameterTypeRequired
objectIdstringrequired

Get a diagram by object ID.

getDiagramsOnSheet

SmartArtDiagram[] | Promise<SmartArtDiagram[]>
getDiagramsOnSheet(): SmartArtDiagram[] | Promise<SmartArtDiagram[]>;

Get all diagrams on this sheet.

changeLayout

void | Promise<void>
changeLayout(objectId: string, newLayoutId: string): void | Promise<void>;
ParameterTypeRequired
objectIdstringrequired
newLayoutIdstringrequired

Change the diagram layout.

changeQuickStyle

void | Promise<void>
changeQuickStyle(objectId: string, quickStyleId: string): void | Promise<void>;
ParameterTypeRequired
objectIdstringrequired
quickStyleIdstringrequired

Change the quick style.

changeColorTheme

void | Promise<void>
changeColorTheme(objectId: string, colorThemeId: string): void | Promise<void>;
ParameterTypeRequired
objectIdstringrequired
colorThemeIdstringrequired

Change the color theme.

getComputedLayout

ComputedLayout | undefined | Promise<ComputedLayout | undefined>
getComputedLayout(
    objectId: string,
  ): ComputedLayout | undefined | Promise<ComputedLayout | undefined>;
ParameterTypeRequired
objectIdstringrequired

Get the computed layout for a diagram. Returns cached result if valid.

invalidateLayout

void
invalidateLayout(objectId: string): void;
ParameterTypeRequired
objectIdstringrequired

Invalidate the cached layout for a diagram.

invalidateAllLayouts

void
invalidateAllLayouts(): void;

Invalidate all cached layouts.