ColdFusion.Layout.disableTab

ColdFusion

Open app

Description

Disables the specified tab so it cannot be selected.

Function syntax

ColdFusion.Layout.disableTab(layout, layoutArea)

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>

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

Get help faster and easier

New user?