JSON API - cloneElement

CONTENTS

LAYOUTS

TEMPLATES

PPTXPATH

FORMAT CONVERSION

PPTXUTILITIES

PPTXCUSTOMIZER

customizeElementStyles

PERFORMANCE

zipStream

cloneElement

PREMIUM

TRIAL / ADVANCED

Clones elements in the PowerPoint presentation.

Note

You are reading the JSON API documentation. For the PHP API method please go to cloneElement.

JSON data

{
    "referenceNode": {
        "target": "string",
        "type": "string",
        "contains": "string",
        "occurrence": number|array|string,
        "attributes": object,
        "parent": "string",
        "rootParent": "string",
        "customQuery": "string"
    },
    "options": {
        "name": "string"
    }
}

Key	Description
target	slide (default value)
type	audio image paragraph run shape (text box) (default value) slide table table-row video
contains	Contains a text string. For paragraph, run, shape, table, table-row types.
occurrence	(number) exact occurrence from 1 (array) occurrences (string) range of contents (e.g.: "2..9", "2..", "..9"), "first()", "last()"
attributes	Contains a specific attribute key and value. Node or descendant attributes.
parent	Immediate children (default as '/', any parent) or any other parent (a:tbl/, p:sp/...).
rootParent	Root parent. Default as p:spTree for slide elements and p:presentation for presentation elements.
customQuery	Custom XPath query, overwrites any other reference.
name	Custom internal name. If not set, a random name is generated.

Code samples

Example #1

{
    "template": "template.pptx",
    "actions": [
        {
            "action": "cloneElement",
            "data": {
                "referenceNode": {
                    "type": "slide",
                    "occurrence": 2
                }
            }
        },
        {
            "action": "cloneElement",
            "data": {
                "referenceNode": {
                    "type": "slide",
                    "occurrence": 4
                }
            }
        }
    ]
}

A template can be a local file, a Base64 string, or a remote file.

Release notes

phppptx 5.0:
- new action.