ColdFusion.Layout.selectTab

Description

Selects the specified tab and displays its layout area.

Function syntax

ColdFusion.Layout.selectTab(layout, layoutArea)

See also

cflayout, cflayoutarea, ColdFusion.Layout.createTab, ColdFusion.Layout.disableTab, ColdFusion.Layout.enableTab, ColdFusion.Layout.hideTab, ColdFusion.Layout.showTab, Using layouts in the Developing ColdFusion Applications

History

ColdFusion 8: Added this function

Parameters

Parameter

Description

layout

The name attribute of the tabbed layout that contains the area to select.

layoutArea

The name attribute of the tab layout area to select.

Returns

This function does not return a value.

Usage

This function has no effect on a disabled tab.

Example

The following code lets you select each of the two tabs in a layout.

<html xmlns="http://www.w3.org/1999/xhtml"> 
<head> 
</head> 
 
<body> 
<cflayout type="tab" name="mainTab" tabheight="300px" style="width:400px"> 
    <cflayoutarea title="First Tab" name="tab1"> 
        <h2>The First Tab</h2> 
        Here are the contents of the first tab.  
    </cflayoutarea> 
     
    <cflayoutarea title="Second Tab" name="tab2"> 
        <h2>The Second Tab</h2> 
        This is the content of the second tab. 
    </cflayoutarea> 
</cflayout> 
 
<p> 
Use these links to test selecting tabs via JavaScript:<br /> 
<a href="" onClick="ColdFusion.Layout.selectTab('mainTab','tab1'); 
    return false;">Click here to select tab 1.</a><br /> 
<a href="" onClick="ColdFusion.Layout.selectTab('mainTab','tab2'); 
    return false;">Click here to select tab 2.</a><br /> 
</p> 
 
</body> 
</html>