HTML Display Control

Updated on 24 Jul 2024
2 Minutes to read

Print
Share
Dark
Light

Article summary

Did you find this summary helpful?

Thank you for your feedback

Overview

The HTML Display control opens a specified HTML link that can be sourced from a URL, dynamically set via Data Name, or set via a static constant.

Configuration

The following unique settings are available for the HTML Display control found within its Properties tab.

Setting Location	Setting Name				Default Value	Function
Common Properties	Name				'HTMLDisplay#'	Prompts for name of the HTML Display control in the Form.
	Link Name				'Open'	Prompts for name of the HTML link displayed to the
	Source Type				URL	Allows selection of HTML's source
		URL			--	Sources HTML based on a URL
			URL Source		Static	Allows selection of the source of the URL
				Static	--	Prompts for a constant URL that will open every time this Form is initiated. Static value entered in the URL setting.
				Data	--	Prompts for a Data Name for the URL to allow for dynamic mapping. It's name must exactly match the Data Name to reference. Data Name value entered in the URL DataName setting.
			URL / URL DataName		Blank	Prompts for specified constant URL or Data Name containing the URL
			Is Relative To Base		False	Toggles whether control considers the {starthere} for the URL. Set to True if the control should only pass through the {starthere} part of the URL. However, most use cases will leave this False.
		Data			--	Sources HTML based from a Data Name in the Flow allowing for dynamic logic mapping.
			HTML from Data		Blank	Prompts for the Data Name for the HTML. It's name must exactly match the Data Name to reference.
		Static			--	Sources HTML from a provided, static input. It is a constant that all end-users will view.
			Static HTML		Blank	Prompts for entering the specified HTML via a Rich Text Input dialog window.
Display Mode	Display Mode In HTML Portal				Dialog	Allows selection of how the HTML is displayed once the control runs.
		Dialog			--	Opens the HTML in a separate dialog window from the browser.
		Inline			--	Opens the HTML within the control
		InlineEmbed			--	Opens the HTML embedded within the control
	Allow Unsafe HTML				False	Toggles whether the Forms skips sanitizing the HTML for viewing which may prevent unsafe HTML from displaying. Set to True to skip sanitizing allowing for any inputted HTML to display.
Dialog Display	Window Height				600	Prompts for height of the HTML window.
Dialog Display	Window Width				800	Prompts for width of the HTML window.

Displaying iFrame Tagged HTML

Due to the automatic sanitization of HTML, iFrame HTML will not display unless the Allow Unsafe HTML setting is True.

The following example attempts to open the following iFrame HTML with the following screenshot of the control's configuration:

<iframe src="https://documentation.decisions.com/v9/docs" style="border:0px #ffffff none;" name="myiFrame" scrolling="no" frameborder="1" marginheight="0px" marginwidth="0px" height="400px" width="600px" allowfullscreen></iframe>

Debug

Once debugging the Form in Flow, the iFrame HTML will now display since the Allow Unsafe HTML checkbox is set to True.

Display HTML as a Label

Version 6x users that were using HTML for Labels will now have to use the HTML Display control to accomplish similar results.

Open the Form.
Save the HTML code contained in the Label and replace the Label control with the HTMLDisplay control.
Under the COMMON PROPERTIES category, change the Source Type to Data and enter "Label" in the HTML from Data field. Under the DISPLAY MODE category, select InlineEmbed under Display Mode In Html Portal. Click Save and close the Form.
In the Flow Designer under the INPUTS category, set the field to Constant. Enter HTML code in the field.
Debug the Flow to display the results.

For further information on Forms, visit the Decisions Forum.

Was this article helpful?

What's Next

Create Form with Property Grid

Table of contents

Overview 
Configuration
Displaying iFrame Tagged HTML
Display HTML as a Label