Manage SmartArt in PowerPoint Presentations Using JavaScript

Overview

SmartArt is a PowerPoint diagram made from nodes, node shapes, and a layout. With Aspose.Slides for Node.js via Java, you can create SmartArt, read text from its nodes, change its layout, inspect hidden nodes, configure organization chart layouts, and create picture organization charts.

Get Text from a SmartArt Object

A SmartArt node can contain one or more shapes. To read the visible text, iterate through SmartArt.getAllNodes, then read the TextFrame returned by SmartArtShape.getTextFrame.

let presentation = new aspose.slides.Presentation("sample.pptx");
try {
    let slide = presentation.getSlides().get_Item(0);
    let shape = slide.getShapes().get_Item(0);

    if (java.instanceOf(shape, "com.aspose.slides.ISmartArt")) {
        let smartArt = shape;
        let nodes = smartArt.getAllNodes();

        for (let nodeIndex = 0; nodeIndex < nodes.size(); nodeIndex++) {
            let node = nodes.get_Item(nodeIndex);
            let nodeShapes = node.getShapes();

            for (let shapeIndex = 0; shapeIndex < nodeShapes.size(); shapeIndex++) {
                let nodeShape = nodeShapes.get_Item(shapeIndex);

                if (nodeShape.getTextFrame() != null) {
                    console.log(nodeShape.getTextFrame().getText());
                }
            }
        }
    }
} finally {
    presentation.dispose();
}

Change the Layout Type of a SmartArt Object

The SmartArt layout controls how nodes are arranged and connected. The following example creates a SmartArt object with the SmartArtLayoutType BasicBlockList value, changes it to the BasicProcess value, and saves the presentation.

let presentation = new aspose.slides.Presentation();
try {
    let smartArt = presentation.getSlides().get_Item(0).getShapes().addSmartArt(
        10, 10, 400, 300, aspose.slides.SmartArtLayoutType.BasicBlockList);

    smartArt.setLayout(aspose.slides.SmartArtLayoutType.BasicProcess);

    presentation.save("ChangeSmartArtLayout_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Check Whether a SmartArt Node Is Hidden

SmartArtNode.isHidden indicates whether the node is hidden in the SmartArt data model. Hidden nodes can exist in the structure even when the selected layout does not display them as visible diagram elements.

The following example adds a node to a SmartArt object that uses the SmartArtLayoutType RadialCycle value and checks the node’s hidden state.

let presentation = new aspose.slides.Presentation();
try {
    let smartArt = presentation.getSlides().get_Item(0).getShapes().addSmartArt(
        10, 10, 400, 300, aspose.slides.SmartArtLayoutType.RadialCycle);

    let node = smartArt.getAllNodes().addNode();
    let isHidden = node.isHidden();

    if (isHidden) {
        console.log("The node is hidden in the SmartArt data model.");
    }

    presentation.save("CheckSmartArtHiddenProperty_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Get or Set the Organization Chart Layout

For SmartArt diagrams that use an organization chart layout, SmartArtNode.getOrganizationChartLayout and SmartArtNode.setOrganizationChartLayout define how child nodes are arranged under a parent node. For example, you can set child nodes to hang from the left, right, or both sides, depending on the selected OrganizationChartLayoutType.

The following example creates an organization chart and sets the layout for the first node to the OrganizationChartLayoutType LeftHanging value.

let presentation = new aspose.slides.Presentation();
try {
    let smartArt = presentation.getSlides().get_Item(0).getShapes().addSmartArt(
        10, 10, 400, 300, aspose.slides.SmartArtLayoutType.OrganizationChart);

    let rootNode = smartArt.getNodes().get_Item(0);
    rootNode.setOrganizationChartLayout(aspose.slides.OrganizationChartLayoutType.LeftHanging);

    presentation.save("OrganizationChartLayout_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Create a Picture Organization Chart

A picture organization chart is a SmartArt layout designed for hierarchy diagrams that include image placeholders. Use the SmartArtLayoutType PictureOrganizationChart value when adding the SmartArt object to a slide.

let presentation = new aspose.slides.Presentation();
try {
    let smartArt = presentation.getSlides().get_Item(0).getShapes().addSmartArt(
        0, 0, 400, 400, aspose.slides.SmartArtLayoutType.PictureOrganizationChart);

    presentation.save("PictureOrganizationChart_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

FAQ

Does SmartArt support mirroring or reversing for RTL languages?

Yes. The SmartArt.setReversed method switches the diagram direction from left-to-right to right-to-left, or back, when the selected SmartArt layout supports reversal.

How can I copy SmartArt to the same slide or to another presentation while preserving formatting?

You can clone the SmartArt shape with ShapeCollection.addClone or clone the whole slide that contains the SmartArt. Both approaches preserve size, position, and formatting.

How do I render SmartArt to a raster image for preview or web export?

Render the slide or the whole presentation to PNG or JPEG. SmartArt is rendered as part of the slide.

How can I find a specific SmartArt object on a slide if there are several?

Set a distinctive Shape.setAlternativeText or Shape.setName value on the SmartArt shape, search for that value in BaseSlide.getShapes, and then check that the matching shape is a SmartArt.