ColdFusion.Layout.disableTab

Description

Disables the specified tab so it cannot be selected.

Function syntax

ColdFusion.Layout.disableTab(layout, layoutArea)

See also

cflayout, cflayoutarea, ColdFusion.Layout.createTab, ColdFusion.Layout.enableTab, ColdFusion.Layout.showArea, ColdFusion.Layout.hideTab, ColdFusion.Layout.selectTab, 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 disable.

layoutArea

The name attribute of the tab layout area to disable.

Returns

This function does not return a value.

Usage

This function has no effect on the currently selected tab. A disabled tab appears grayed out.

Example

The following example lets you enable and disable a tab by clicking a link.

<html xmlns="http://www.w3.org/1999/xhtml"> 
<head> 
</head> 
 
<body> 
<!--- The tabheight attribute sets the height of all tab content areas. ---> 
<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 disabling/enabling via JavaScript.  
Note that you cannot disable the currently selected tab.<br /> 
<a href="" onClick="ColdFusion.Layout.enableTab('mainTab','tab1'); 
    return false;">Click here to enable tab 1.</a><br /> 
<a href="" onClick="ColdFusion.Layout.disableTab('mainTab','tab1'); 
    return false;">Click here to disable tab 1.</a><br /> 
</p> 
</body> 
</html>