JSON API - addHtml

CONTENTS

LAYOUTS

TEMPLATES

PPTXPATH

FORMAT CONVERSION

PPTXUTILITIES

PPTXCUSTOMIZER

customizeElementStyles

PERFORMANCE

zipStream

addHtml

PREMIUM

TRIAL / ADVANCED

Inserts HTML and CSS into the PowerPoint presentation.

Note

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

JSON data

{
    "html": "string",
    "position": {
        "placeholder": {
            "name": "string",
            "descr": "string",
            "position": number,
            "type": "string"
        },
        "new": {
            "coordinateX": number,
            "coordinateY": number,
            "sizeX": number,
            "sizeY": number,
            "name": "string",
            "order": number,
            "textBoxStyles": {
                /* check addTextBox styles */
            }
        }
    },
    "options": {
        "disableWrapValue": boolean,
        "forceNotTidy": boolean,
        "insertMode": "string",
        "parseCSSVars": boolean,
        "useHtmlExtended": boolean
    }
}

Key	Description
html	HTML and CSS content to be transformed.
placeholder	The content is added in a placeholder of the layout. One of the following options can be used to get the text box. "name" name. "descr" alt text (descr) value. "position" position by order. 0 is the first order position. "type" title (Title), body (Body), ctrTitle (Centered Title), subTitle (Subtitle).
new	A new position is generated. "coordinateX" EMUs (English Metric Unit). "coordinateY" EMUs (English Metric Unit). "sizeX" EMUs (English Metric Unit). "sizeY" EMUs (English Metric Unit). "name" internal name. If not set, a random name is generated. "order" set the display order. Default after existing contents. 0 is the first order position. If the order position doesn't exist add after existing contents. "textBoxStyles" See addTextBox for text box styles.
disableWrapValue	If true disable using a wrap value with Tidy to prevent extra blank spaces. Default as false.
forceNotTidy	Default as false. If true, avoid using Tidy. Only recommended if Tidy can't be installed.
insertMode	Insert mode if the position contains an existing content: append replace Default as append.
parseCSSVars	If true parses CSS variables.
useHtmlExtended	If true allows using HTML Extended tags. Default as false. Only available in Premium licenses.

Code samples

Example #1

{
    "actions": [
        {
            "action": "addHtml",
            "data": {
                "html": "<p style=\"font-size: 48px;\"><b>Lorem ipsum</b></p>",
                "position": {
                    "placeholder": {
                        "name": "Title 1"
                    }
                }
            }
        },
        {
            "action": "addHtml",
            "data": {
                "html": "<style>p {font-family: Arial;font-style: italic;text-decoration: underline;color: #2CA87A;}</style><p>Lorem ipsum with <br>Arial font</p>",
                "position": {
                    "placeholder": {
                        "name": "Subtitle 2"
                    }
                }
            }
        },
        {
            "action": "addHtml",
            "data": {
                "html": "<style>p {background-color: #AEBF7A;}.c1 {text-decoration: underline;font-size: 16pt;}</style><p><b>phppptx</b> can transform <span class=\"c1\">HTML to PPTX</span>.<a href=\"https://www.phppptx.com\">Link to phppptx</a></p>",
                "position": {
                    "new": {
                        "coordinateX": 770000,
                        "coordinateY": 507000,
                        "sizeX": 7000000,
                        "sizeY": 450000,
                        "textBoxStyles": {
                            "border": {
                                "color": "FF0000",
                                "dash": "dash",
                                "width": 48575
                            }
                        }
                    }
                }
            }
        }
    ]
}

Release notes

phppptx 5.0:
- new action.