HTML Display Control
  • 24 Jul 2024
  • 2 Minutes to read
  • Dark
    Light

HTML Display Control

  • Dark
    Light

Article summary

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 LocationSetting NameDefault ValueFunction
Common PropertiesName'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 TypeURLAllows selection of HTML's source

URL--Sources HTML based on a URL

URL SourceStaticAllows 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 DataNameBlankPrompts for specified constant URL or Data Name containing the URL

Is Relative To BaseFalseToggles 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 DataBlankPrompts 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 HTMLBlankPrompts for entering the specified HTML via a Rich Text Input dialog window.
Display ModeDisplay Mode In HTML PortalDialogAllows 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 HTMLFalseToggles 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 DisplayWindow Height600Prompts for height of the HTML window.
Window Width800Prompts 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. 

  1. Open the Form.
  2. Save the HTML code contained in the Label and replace the Label control with the HTMLDisplay control.
  3. 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.
  4. In the Flow Designer under the INPUTS category, set the field to Constant. Enter HTML code in the field. 
  5. Debug the Flow to display the results.



For further information on Forms, visit the Decisions Forum.





Was this article helpful?