HTML Builder

HTML Builder

In this topic ...

Specifying Inputs
Related Topics ...

Overview: Creating Pages
HTML Guidelines

Use the HTML builder to incorporate an entire block of HTML into a model. The HTML builder provides a way to profile the HTML block you are inserting. For example, you might want to present a welcoming paragraph and set of web URLs to one group of users, and present a different text and set of URLs to another group of users.

Specifying Inputs

The HTML builder takes the inputs described in the table below. For help on inputs common to many or all builders such as those in the Properties and HTML Attributes input groups, see "Using the Builder Call Editor."

Input name Description
Name Enter a name for this builder call. The designer tool displays this name in the builder call list.
Page Location Use the Page Location input to specify the page or pages on which this builder call will act.
See "Locating Control Builders on Pages" for detailed documentation about the Page Location input and page location syntax.
HTML Do one of the following:

Enter an indirect reference to a source, such as a variable.

Enter the HTML directly.

If you use a variable as a source of HTML, the variable must be of type XMLData.
Advanced
Handle Target Element These Advanced inputs are useful when we need to embed HTML into JSP code.
Use this input to determine how the Builder deals with the target element. We can choose:

Add - To insert the parsed value as a child of the target element.
Replace - To completely replace the target element with the parsed version.

Parse Behavior Use this input to determine if HTML is fully parsed so tags are available to other builders or included as-is.
The default (Let builder decide) behaviour will include the HTML as-is if the HTML begins with "<%" (ie, assumed to be JSP), otherwise it will do the full HTML parse
Fully parsing the HTML (Parse All HTML) allows tags to be visible to subsequent builders
If the supplied HTML has multiple top-level nodes (instead of one), the HTML parse will break, and "include as-is" should be selected.
Choose:

Parse all HTML - To fully parse HTML
Include HTML as is - To disable the parse function.
Let Builder Decide - To allow the Builder to determine if the HTML begins with "<%" then to just include it as-is.
Note that If you have HTML where an end tag is missing, The default behaviour will still show this as broken. To fix this problem set the Parse Behaviour to, "Include HTML as-is".

Input name	Description
Name	Enter a name for this builder call. The designer tool displays this name in the builder call list.
Page Location	Use the Page Location input to specify the page or pages on which this builder call will act. See "Locating Control Builders on Pages" for detailed documentation about the Page Location input and page location syntax.
HTML	Do one of the following: Enter an indirect reference to a source, such as a variable. Enter the HTML directly. If you use a variable as a source of HTML, the variable must be of type XMLData.
Advanced
Handle Target Element	These Advanced inputs are useful when we need to embed HTML into JSP code. Use this input to determine how the Builder deals with the target element. We can choose: Add - To insert the parsed value as a child of the target element. Replace - To completely replace the target element with the parsed version.
Parse Behavior	Use this input to determine if HTML is fully parsed so tags are available to other builders or included as-is. The default (Let builder decide) behaviour will include the HTML as-is if the HTML begins with "<%" (ie, assumed to be JSP), otherwise it will do the full HTML parse Fully parsing the HTML (Parse All HTML) allows tags to be visible to subsequent builders If the supplied HTML has multiple top-level nodes (instead of one), the HTML parse will break, and "include as-is" should be selected. Choose: Parse all HTML - To fully parse HTML Include HTML as is - To disable the parse function. Let Builder Decide - To allow the Builder to determine if the HTML begins with "<%" then to just include it as-is. Note that If you have HTML where an end tag is missing, The default behaviour will still show this as broken. To fix this problem set the Parse Behaviour to, "Include HTML as-is".