| Sun ONE Application Framework Tag Library Reference
|
   
|
<jato:frameSrc>
Renders the src and name attributes for a HTML <frame> tag.
This tag is only valid when enclosed by both an HTML <form> element and a useViewBean, containerView, or tiledView tag. This tag may not contain any body content.
NOTE: This tag does not attempt to entirely replace the HTML <frame> tag because HTML editors will not allow you to edit your frameset in a WYSIWYG fashion without the presence of HTML <frame> tags. Therefore, this tag is designed to supply the HTML <frame> tag with a dynamic src value only.
Example:
<frameset rows="30%,70%">
<frame <jato:frameSrc name="Frame1" location="internal" /> >
<frame <jato:frameSrc name="Frame2" location="external" /> >
</frameset>
The above would be rendered into the following HTML:
<frameset rows="30%,70%">
<frame src="...(JATO page)..." name="Frame1" >
<frame src="/blank.html" name="Frame2" >
</frameset>
|
Attribute Name
|
Description
|
Notes
|
|
defaultValue
|
The value to use, if the DisplayField view peer's value is null.
For a frameSrc tag, "value" refers to a JATO page name when the location attribute is "internal". If the location attribute is "external", then the "value" refers to an arbitrary non-JATO URL.
|
RTExpr
|
|
name
|
The name of the DisplayField peer. This peer must be a child of the current parent ContainerView, TiledView, or ViewBean. The DisplayField name is resolved relative to the current parent view.
The view peer must be of type <JATO package>.view.DisplayField
This name may be a qualified view path, using forward slashes ("/") as delimiters. All components in the path except the last must refer to a ContainerView or a derivative of ContainerView (such as TiledView). Both relative and absolute paths are possible. If a name path begins with a forward slash, the name is assumed to be relative to the root view (the ViewBean). If the path does not begin with a forward slash, the name is assumed to refer to a child relative to the current container. Two dots ("..") may be used to refer to the container that is the parent of the current container.
Examples:
/header/orderList/customerName (absolute from root view)
orderList/customerName (relative to current container)
../footer/orderList/customerName (relative to parent)
|
Req
|
|
location
|
Valid values: "internal" or "external"
A value of "internal" specifies that the source document for this frame will be a JATO page in the current application.
A value of "external" specifies that the source document for this frame will be an arbitrary URL external to the current application.
If not specified, "internal" is assumed.
|
|
|
|
This tag does not support any JavaScript events.
You can add JavaScript directly in the HTML <frame> element that contains this tag.
|
|
| Sun ONE Application Framework Tag Library Reference
|
817-4361-10
|
|
Copyright © 2003, Sun Microsystems, Inc. All rights reserved.