Frame Builder

Frame Builder

In this topic ...

Quick Tips
Specifying Inputs
Related Topics ...

Overview: Creating Forms
HTML Guidelines

Use the Frame builder to specify the content of an HTML frame. We can use the Frame builder whenever we need to display two or more separate HTML pages simultaneously within the same browser window. A common example is a "table of contents" or "navigation" frame located at the top or left of the browser window and a content or text frame to its right. This table of contents frame typically contains buttons or links, which when clicked update the contents of the other frame.
The Frame builder produces at run time the FRAME tag with its source attribute (src) given the appropriate value (for example, frame name="top" src='< =webAppAccess.getActionURL("TopPage")>' /frame , where TopPage is the builder call name of the page to be imported). When the page is displayed, the frame referenced by this tag will display the page from the given source.

Quick Tips

The page on which you place this builder needs to have a frameset defined.
To change the Frame builder's source, select a new value from the WebApp Action Name drop-down menu.
When you specify the control tag for a Frame builder, make sure the control tag is within the Frameset tag...

html
Frameset rows="30%,*"
span name="top" /
span name="bottom" /
/Frameset
/html
where

the top span name is for the Frame builder that displays the top frame
the bottom span name is for the Frame builder that displays the bottom frame

Do not use the Inserted Page builder to insert a page containing one or more frames into another page. We cannot have nested frames within a page..

Specifying Inputs

The Frame 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.
Action Select one of the following for the source of the frame:

Page in the model
A method in the current model - This method needs to call up a page to be displayed in the frame. The method could also return XML data the represents HTML.
An Action List builder in the current model - The actions in the Action List builder need to call up a page to be displayed in the frame.

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.
Action	Select one of the following for the source of the frame: Page in the model A method in the current model - This method needs to call up a page to be displayed in the frame. The method could also return XML data the represents HTML. An Action List builder in the current model - The actions in the Action List builder need to call up a page to be displayed in the frame.