Siebel Developer's Reference > Siebel Web Engine Tags >

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

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.

swe:togglebar

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

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 is rendered as an HTML Select control showing the set of applets to which the user can toggle. 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 (it has no 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 is 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 the swe:for-each-view, swe:viewlink, and swe:viewname tags.

swe:for-each-toggle

This tag iterates over the number of toggle applets to show its contents.

Attributes

None

swe:togglelink

This tag creates a toggle link.

Usage

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

Attributes

State. (Optional) Can have value Active or Inactive. If state is Active, this tag is used only if the current applet title being rendered is the currently active applet. If state is Inactive, this tag is used only if the current applet title being rendered is not the currently active applet. If not specified, the tag is shown for all applets.

Property. (Optional) Can have only one value, FormattedHtml, which generates the HTML for creating a link to toggle to the applet. If this attribute is not specified, then no output is generated.

swe:togglename

This tag 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>