ColdFusion.Layout.createTab

Description

Creates a new tab and layout area in a ColdFusion tabbed layout.

Function syntax

ColdFusion.Layout.createTab(layout, layoutArea, Title, URL [, configObject])

History

ColdFusion 8: Added this function

Parameters

Parameter	Description
`layout`	The `name` attribute of the tabbed layout in which to add the tab
`layoutArea`	The name to assign to the layout area that is created for the new tab. Must be unique on the page.
`title`	The text to display on the tab. You can use HTML mark-up to control the title appearance.
`URL`	The URL from which to get the layout area contents. This attribute can use URL parameters to pass data to the page. ColdFusion uses standard page path resolution rules to locate the page.
`configObject`	An object containing window configuration parameters. For details, see "Usage".

Returns

This function does not return a value.

Usage

This function dynamically creates tabs in a tabbed layout; it is equivalent to putting a cflayoutarea tag inside a cflayout tag with a type attribute of tag. The configuration parameter defines tab characteristics; it can have any or all of the following entries:

Entry	Default	Description
align	The cflayout tag align attribute value	Specifies how to align child controls within the layout area. The following values are valid: `center` `justify` `left` `right`
callbackhandler		A function that will be called when the layout tab body has loaded. This function must not take any arguments.
closable	false	A Boolean value specifying whether the user can close the window. If `true`, the tab has an X close icon.
disabled	false	A Boolean value specifying whether the tab is disabled, that is, whether user can select the tab to display its contents. Disabled tabs are greyed out. Ignored if there is a `true` `selected` entry.
errorhandler		A function that will be called if an error occurs in loading the tab body. This function must take two arguments: The HTTP status code, or -1 if the error is not a HTTP error An error message
inithide	false	A Boolean value specifying whether the tab is initially hidden. To show an initially hidden tab, use the ColdFusion.Layout.showTab function.
overflow	auto	Specifies how to display child content whose size would cause the tab layout area to overflow the window boundaries. The following values are valid: `auto`: Show scroll bars when necessary. `hidden`: Do not allow access to overflowing content. `scroll`: Always show horizontal and vertical scroll bars, even if they are not needed. `visible`: Content can display outside the bounds of the layout area. Note: In Internet Explorer, layout areas with the visible setting expand to fit the size of the contents, rather than having the contents extend beyond the layout area.
selected	false	A Boolean value specifying whether this tab is initially selected so that its contents appears in the layout.
style		A CSS style specification that controls the appearance of the layout area.

Example

The following example creates a tabbed layout with one tab. When you click the button it creates a second tab that is immediately visible and selected.

The main page looks as follows:

<html>
<head>
</head>
<body>
<cfform name="layouts">
    <cfinput type="button" name="CreateTab" 
        onClick="ColdFusion.Layout.createTab('tabLayout','tab2',
            'Tab 2','_tabUrl.cfm',{inithide:false,selected:true})" 
        value="Create Tab">
</cfform>

<cflayout type="tab" name="tabLayout">
    <cflayoutarea name="tab1" title="Tab 1" align="left">
        Default Tab
    </cflayoutarea>
</cflayout>
</body>
</html>

The _tabURL.cfm page looks as follows:

<h3>Tab 2</h3>
This is a simple tab

Adobe ColdFusion 8

ColdFusion.Layout.createTab

Related Information

Help Resource Center