ShapeReference

Use ShapeReference to make internal references or links on a shape to another slide in the presentation. This allows users to navigate to specific slide by clicking an image, icon, or shape.

Syntax

Place the ShapeReference binding in the shape’s alternative text, that should have a link/reference to another slide.

<<ShapeReference:AltText$ShapeReferencePath>>

Parameters

AltText: Optional possibility to define an alternative text for shape.
ShapeReferencePath: Key defined in the data. The value in the JSON is used to make a connection to the slide. The value of the key needs to be a string, integer, or float value. The value has to be unique from other ShapeReferencePaths and will only be used as a connection ID. This also means that this value will not be visible in the presentation. The ShapeReferencePath in the notes will be removed on generated documents.

On the slide that the link should jump to, place the ShapeReferencePath in the “notes” section on the slide as seen below. If more references are needed, the paths should be separated with a line break.

#-- DocuMotor-References --#
ShapeReferencePath
#-- DocuMotor-References-End --#

Notes

The general logic for creating reference links to specific slides is to create a link that points to a slide with a specific ID. That means that the link should know which slide ID it is pointing to. To apply the ID to the targeted slide the ShapeReferencePath in the notes is relevant since this is where the value from the ShapeReferencePath is defined as the slide’s unique ID. The ShapeReferencePath defined in the ShapeReference binding, in the shape’s alternative text, should be the JSON path to a value that is identical to the value of the ShapeReferencePath defined in the notes of the targeted slide.

Example

Below is an example of how an icon links to a specific slide, where the slide are part of repeated slides accomplished with the Repeat section binding.

Template

Output data

{
    "goToSlideId": 2,
    "repeatedSlides": [
        {
            "title": "Title 1",
             "slideId": 1
        },
        {
            "title": "Title 2",
            "slideId": 2
        },
        {
            "title": "Title 3",
            "slideId": 3
        }
    ]
}

Generated presentation