Description

Selects the specified tab and displays its layout area.

Function syntax

ColdFusion.Layout.selectTab(layout, layoutArea)

See also

cflayoutcflayoutareaColdFusion.Layout.createTabColdFusion.Layout.disableTabColdFusion.Layout.enableTab

ColdFusion.Layout.hideTabColdFusion.Layout.showTabUsing layouts in Controlling Ajax user interface layout 

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>

 

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy