Siebel Developer's Reference > Tags >

swe:togglebar, swe:for-each-toggle, swe:togglelink, swe:togglename

Purpose

SWE supports showing toggle applets. Links to navigate between the toggle applets can be rendered either as a drop-down select control or as links or tabs.

The toggle selection control can be rendered in any applet template using the new tag <swe:togglebar>. This tag works similarly to the <swe:viewbar> and <swe:for-each-screen> tags.

swe:togglebar

Syntax

swe:togglebar

Usage

<swe:togglebar type="xxx" property="zzz">

Attributes

Type. This can have one value: "Select." If the type is set to "Select" the togglebar will be rendered as a HTML Select control showing the set of applets that can be toggled to. The applet titles are used as values in the select control.

Property. This attribute is to be used only when the type is set to "Select" (will not have any effect in other cases). This attribute can have a value of "FormattedHtml", in which case the HTML Select control is rendered. If this attribute is not specified, this tag acts as a conditional tag to show its contents if there are toggle applets defined. The <swe:this> tag will be used within the body of this tag in this case to render the select control.

If the applet does not have toggle applets defined, this tag and its contents are skipped.

When the type attribute is not set to "Select,"<swe:for-each-toggle>, <swe:togglelink>, and <swe:togglename> tags can be used within the body of the <swe:togglebar> tag to create toggle links or tabs similar to the use of <swe:for-each-view>, <swe:viewlink>, and <swe:viewname> tags.

swe:for-each-toggle

Purpose

Iterates over the number of toggle applets to show its contents.

Attributes

None.

swe:togglelink

Usage

<swe:togglelink state="xxx" property="yyy">

Attributes

State. This is optional. Can have value "Active" or "Inactive." If state is "Active" this tag will be used only if the current applet title being rendered is the currently active applet. If state is "Inactive" this tag will be used only if the current applet title being rendered is not the currently active applet. If not specified, the tag will be shown for all applets.

Property. This is optional. Can have only one value, "FormattedHtml," which will output the HTML for creating a link to toggle to the applet. If this attribute is not specified, then no output will be generated.

swe:togglename

Purpose

Outputs the title of the applet.

Usage

<swe:togglename/>

Examples

To show the toggle applets as a select control:

<swe:togglebar type="Select" >

<table>

<tr>

<td> <swe:control id="1" property="DisplayName"> </td>

<td> <swe:this property="FormattedHtml"/> </td>

</tr>

</table>

</swe:togglebar>

where the control is used to create a label like "Show:" before the select control.

To show the toggle applets as tabs or links:

<swe:togglebar>

<table>

<tr>

<td><swe:togglelink property="FormattedHtml"> <swe:togglename> </swe:togglelink> </td>

</tr>

</table>

</swe:togglebar>


 Siebel Developer's Reference 
 Published: 23 October 2003