Bookshelf Home | Contents | Index | Search | PDF |
Siebel Developer's Reference > Tags >
swe:frame, swe:frameset
Rather than using the HTML
<frame>
and<frameset>
tags, Siebel applications use the<swe:frameset>
(swe:frameset
) and<swe:frame>
(swe:frame
) tags. This is so that SWE is aware of the frame names, and can control refresh and the targeting of URLs. SWE frames and framesets can be used in the following situations:
- Container page templates. A container page template is used to create the frame definition document for the application.
Note the following implementation details of
<swe:frame>
and<swe:frameset>
tags in container pages:
- The contents of a frame using the
<swe:include>
tag does not have to be defined, though it is recommended. The contents can be placed directly into the body of the<swe:frame>
tag.- The contents of the
<swe:frame>
have to be complete HTML documents, that is, they should contain the HTML document structure tags like<html>
,<head>
,<body>,
and so on. This includes the view templates also.- The contents of the
<swe:frame>
tag when the type is "View" should contain only the<swe:current-view/>
tag.- View templates. Frames can be used in a View template to create a frame definition document to show the Applets in the View. SWE will refresh these frames only when one or more of the Applets contained in a frame has new data.
NOTE: You can use frames in a View template only if frames are also used in the container page and there is a separate frame in the container page for the View.
Note the following implementation details of frameset definitions in View templates:
swe:frameset
Purpose
This tag is analogous to the HTML frameset tag and is used to define the set of frames contained in the document. This tag is rendered by SWE as an HTML
<frameset>
tag. The body of this tag can only contain the<swe:frame>
tags described below.Usage
<swe:frameset htmlAttr="xxx"> ... </swe:frameset>
Attribute
htmlAttr. This attribute can be used to specify the attributes for the HTML
<frameset>
tag.swe:frame
Purpose
This tag is used to mark the beginning and end of the contents to be placed into a frame. SWE renders this tag as an HTML
<frame>
tag, with its src attribute set to a SWE URL that will retrieve the contents of the frame. This tag should be placed within the body of the<swe:frameset>
tag.Usage
<swe:frame type="xxx" name="yyy"> .... </swe:frame>
Attributes
Type. The type attribute is used to indicate the nature of the contents of the frame. SWE uses this information to decide when to refresh this frame. SWE currently supports the following values for this attribute (more will be supported later).
Name. This attribute can be used only when the type of the frame is Page. In this case you can use this attribute to optionally specify a name for the frame. For other frame types, SWE will generate standard names for the frames.
SWE supports nested framesets. In this case the
<swe:frame>
tag will contain a<swe:frameset>
tag, and the Type attribute of the outer<swe:frame>
tag is set to Page.
Bookshelf Home | Contents | Index | Search | PDF |
Siebel Developer's Reference Published: 23 October 2003 |