ColdFusion.Layout.selectTab

ColdFusion

Open app

Description

Selects the specified tab and displays its layout area.

Function syntax

ColdFusion.Layout.selectTab(layout, layoutArea)

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>

Get help faster and easier

New user?