User Guide Cancel

cflayoutarea

Last updated on May 30, 2024 | Also applies to ColdFusion

ColdFusion

Open app

CFML Reference User Guide
ColdFusion functions
ColdFusion tags
1. ColdFusion tag summary
2. ColdFusion tags by category
  1. Application framework tags
    1. cfapplication
    2. cfassociate
    3. cferror
    4. cfimport
    5. cfinterface
    6. cflock
    7. cfscript
    8. cfthread
  2. Communications tags
  3. Database manipulation tags
  4. Data output tags
    1. cfchart
    1. cfchartdata
    2. cfchartseries
    3. cfchartset
    4. cfcol
    5. cfcontent
    6. cfdocument
    7. cfdocumentitem
    8. cfdocumentsection
    9. cfflush
    10. cfheader
    11. cflog
    12. cfoutput
    13. cfpresentation
    14. cfpresentationslide
    15. cfpresenter
    16. cfprocessingdirective
    17. cfprint
    18. cfreport
    19. cfreportparam
    20. cfsilent
    21. cftable
  5. Debugging tags
    1. cfdump
    2. cftimer
    3. cftrace
  6. Exception handling tags
    1. cfcatch
    2. cferror
    3. cffinally
    4. cfrethrow
    5. cfthrow
    6. cftry
  7. Extensibility tags
    1. cfchart
    2. cfchartdata
    3. cfchartseries
    4. cfcollection
    5. cfcomponent
    6. cfexecute
    7. cfftp
    8. function
    9. cfindex
    10. cfinterface
    11. cfinvoke
    12. cfinvokeargument
    13. cfobject
    14. cfproperty
    15. cfreport
    16. cfreportparam
    17. cfreturn
    18. cfsearch
    19. cfsharepoint
    20. cfspreadsheet
    21. cfwddx
    22. cfxml
  8. File management tags
    1. cfdirectory
    2. cffile
    3. cffileupload
    4. cfftp
    5. cfzip
    6. cfzipparam
  9. Flow-control tags
    1. cfabort
    2. cfbreak
    3. cfcase
    4. cfcontinue
    5. cfdefaultcase
    6. cfelse
    7. cfelseif
    8. cfexecute
    9. cfexit
    10. cfif
    11. cfinclude
    12. cflocation
    13. cfloop
    14. cfrethrow
    15. cfswitch
    16. cfthrow
    17. cftry
  10. Forms tags
    1. cfapplet
    2. cfcalendar
    3. cffileupload
    4. cfform
    5. cfformgroup
    6. cfformitem
    7. cfgrid
    8. cfgridcolumn
    9. cfgridrow
    10. cfgridupdate
    11. cfinput
    12. cfpdf
    13. cfpdfform
    14. cfpdfformparam
    15. cfpdfparam
    16. cfpdfsubform
    17. cfselect
    18. cfslider
    19. cftextarea
    20. cftree
    21. cftreeitem
  11. Internet Protocol tags
    1. cfajaximport
    2. cfajaxproxy
    3. cfftp
    4. cffeed
    5. cfimap
    6. cfhttp
    7. cfhttpparam
    8. cfldap
    9. cfmail
    10. cfmailparam
    11. cfmailpart
    12. cfpop
    13. cfsprydataset
  12. Page processing tags
    1. cfcache
    2. cfcontent
    3. cfflush
    4. cfheader
    5. cfhtmlhead
    6. cfinclude
    7. cfprocessingdirective
    8. cfsetting
    9. cfsilent
  13. Security tags
  14. Variable manipulation tags
    1. cfcookie
    2. cfdump
    3. cfparam
    4. cfregistry
    5. cfsavecontent
    6. cfschedule
    7. cfset
    8. cfsetting
  15. Other tags
    1. cfimage
    2. cflog
    3. cfregistry
3. Tags a-b
4. Tags c
5. Tags f
6. Tags g-h
  1. cfgraph
  2. cfgraphdata
  3. cfgrid
  4. cfgridcolumn
  5. cfgridrow
  6. cfgridupdate
  7. cfheader
  8. cfhtmlhead
  9. cfhtmltopdf
  10. cfhtmltopdfitem
  11. cfhttp
  12. cfhttpparam
7. Tags i
  1. cfif
  2. cfimage
  3. cfimap
  4. cfimapfilter
  5. cfimpersonate
  6. cfimport
  7. cfinclude
  8. cfindex
  9. cfinput
  10. cfinsert
  11. cfinterface
  12. cfinvoke
  13. cfinvokeargument
8. Tags j-l
9. Tags m-o
10. Tags p-q
  1. cfparam
  2. cfpdf
  3. cfpdfform
  4. cfpdfformparam
  5. cfpdfparam
  6. cfpdfsubform
  7. cfpod
  8. cfpop
  9. cfpresentation
  10. cfpresentationslide
  11. cfpresenter
  12. cfprint
  13. cfprocessingdirective
  14. cfprocparam
  15. cfprocresult
  16. cfprogressbar
  17. cfproperty
  18. cfquery
  19. cfqueryparam
11. Tags r-s
  1. cfregistry
  2. cfreport
  3. cfreportparam
  4. cfrethrow
  5. cfreturn
  6. cfsavecontent
  7. cfschedule
  8. cfscript
  9. cfsearch
  10. cfselect
  11. cfservlet
  12. cfservletparam
  13. cfset
  14. cfsetting
  15. cfsharepoint
  16. cfsilent
  17. cfslider
  18. cfspreadsheet
  19. cfsprydataset
  20. cfstoredproc
  21. cfswitch
12. Tags t
  1. cftable
  2. cftextarea
  3. cftextinput
  4. cfthread
  5. cfthrow
  6. cftimer
  7. cftooltip
  8. cftrace
  9. cftransaction
  10. cftree
  11. cftreeitem
  12. cftry
13. Tags u-z
  1. cfupdate
  2. cfwddx
  3. cfwebsocket
  4. cfwindow
  5. cfxml
  6. cfzip
  7. cfzipparam
CFML Reference
1. Reserved words and variables
2. Ajax JavaScript functions
3. ColdFusion ActionScript functions
4. ColdFusion mobile functions
5. Application.cfc reference
6. Script functions implemented as CFCs
7. ColdFusion Flash Form style reference
8. ColdFusion event gateway reference
9. ColdFusion C++ CFX Reference
10. ColdFusion Java CFX reference
11. WDDX JavaScript Objects
Cloud services

Description

Defines a region within a cflayout tag body, such as an individual tab of a tabbed layout.

Syntax

In a border layout 
<cflayoutarea 
required 
position="bottom|center|left|right|top" 
optional 
align="left|center|justify|right" 
collapsible="false|true" 
initcollapsed="false|true" 
inithide="false|true" 
maxSize="number of pixels" 
minSize="number of pixels" 
name="string" 
onBindError = "JavaScript function name" 
overflow = "auto|hidden" 
size="number of pixels" 
source="URL" 
splitter="false|true" 
style="CSS style specification" 
title="string"> 

area elements 

</cflayoutarea> 

In a hbox or vbox layout 
<cflayoutarea 
optional 
name="string" 
onBindError = "JavaScript function name" 
overflow = "auto|hidden|scroll|visble" 
size="number of pixels" 
source="URL" 
style="CSS style specification"> 

area elements 

</layoutarea> 

In a tab layout 
<cflayoutarea 
optional 
bindonload="false|true" 
closable="false|true" 
disabled="false|true" 
inithide="false|true" 
name="string" 
onBindError = "JavaScript function name" 
overflow = "auto|hidden|scroll|visble" 
refreshOnActivate = "false|true" 
selected="false|true" 
source="URL" 
style="CSS style specification" 
tabTip="text" 
title="string"> 

area elements 

</layoutarea> 

In an accordion layout 
<cflayoutarea 
optional 
bindonload="false|true" 
closable="false|true" 
name="string" 
onBindError = "JavaScript function name" 
overflow = "auto|hidden|scroll|visble" 
refreshOnActivate = "false|true" 
selected="false|true" 
source="URL" 
style="CSS style specification" 
title="string" 
titleicon="icon location"> 

area elements

If you specify a source attribute, all child tags are ignored. If you do not have child tags, close the tag with />.

Note:

You can specify this tag's attribute in an attributeCollection attribute whose value is a structure. Specify the structure name in the attributeCollection attribute and use the tag's attribute name as structure key.

History

ColdFusion 8: Added this tag

Attributes

Attribute	Req/Opt	Default	Applies to	Description
align	Optional	The cflayout tag align attribute value	all	Specifies how to align child controls within the layout area. The following values are valid: center justify left right
bindLoad	Optional	true	tab, accordion	A Boolean value that specifies whether to execute the source attribute expression when the layoutarea is first loaded.
closable	Optional	false	tab	A Boolean value that specifies whether the area can close. Specifying this attribute adds an x icon on the tab or title bar that a user can click to close the area.
collapsible	Optional	false	border, accordion	A Boolean value that specifies whether the area can collapse. Specifying this attribute adds a >> or << icon on the title bar that a user can click to collapse the area. You cannot use this attribute for border layout areas with a position attribute value of center.
disabled	Optional	false	tab	A Boolean value that specifies whether the tab is disabled, that is, whether a user can select the tab to display its contents. Disabled tabs are greyed out. Ignored if the selected attribute value is true.
initCollapsed	Optional	false	border	A Boolean value that specifies whether the area is initially collapsed. You cannot use this attribute for border layout areas with a position attribute value of center. Ignored if the collapsible attribute value is false.
initHide	Optional	false	border, tab, accordion	A Boolean value that specifies whether the area is initially hidden. To show an initially hidden area, use the ColdFusion.Layout.showArea or ColdFusion.Layout.showTab function. You cannot use this attribute for border layout areas with a position attribute value of center.
maxSize	Optional	-1(no maximum size)	border	If the position attribute value is top or bottom, the maximum height of the area, in pixels, that you can set by dragging a splitter. If the position attribute value is left or right, the maximum width of the area. You cannot use this attribute for border layout areas with a position attribute value of center.
minSize	Optional	-1(no minimum size)	border	If the position attribute value is top or bottom, the minimum height of the area, in pixels, that you can set by dragging a splitter. If the position attribute value is left or right, the minimum width of the area. You cannot use this attribute for border layout areas with a position attribute value of center.
name	Optional		all	The name of the layout area.
onBindError	Optional	See Description	all	The name of a JavaScript function to execute if evaluating a bind expression results in an error. The function must take two attributes: an HTTP status code and a message. If you omit this attribute, and have specified a global error handler (by using the ColdFusion.setGlobalErrorHandler function), it displays the error message; otherwise a default error pop-up displays.
overflow	Optional	auto For accordion, if fillheight attribute of the cflayout tag is false, default value is hidden.	all	Specifies how to display child content whose size would cause the control 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. Notes: You cannot use visible or scroll for layout areas in border layouts. 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.
position	Required if the cflayout type is border		border	The position of the area in the layout. Must be one of the following values: top: Position the area across the top of the full layout. bottom: Position the area across the bottom of the full layout. left: Position the area on the left side of the layout, between any visible top and bottom areas. right: Position the area on the right side of the layout, between any visible top and bottom areas. center: Position the area in the space not taken by the top, bottom, left, and right areas. Border style layouts can have at most one layout area of each type.
refreshOnActivate	Optional	false	tab, accordion	true: Refresh the contents of the tab/ accordion panel by running the source bind expression whenever the tab/panel display region shows (for example, when the user selects the tab), in addition to when bind events occur. false: Refresh the tab/accordion panel display region only when the bind expression is triggered by its bind event. To use this attribute, also specify a source attribute.
selected	Optional	first tab is selected	tab, accordion	A Boolean value that specifies whether this tab is initially selected so that its contents appears in the layout.
size	Optional	-1calculate initial size dynamically	border, hbox, vbox	For hbox layouts and border layouts with position attribute values of top or bottom, the initial height of the area. For vbox layouts and border layouts with position attribute values of left or right, the initial width of the area. For hbox and vbox layouts, you can use any valid CSS length or percent format (such as 10, 10% 10px, or 10em) for this attribute. For border layouts, this attribute value must be an integer number of pixels. You cannot use this attribute for border layout areas with a position attribute value of center. ColdFusion automatically determines the center size based on the size of all other layout areas. Note: If a layout area in a border layout contains only AJAX controls such as HTML format cftree tags, specify a size attribute. Otherwise, the AJAX components may not be visible until the layout area is resized.
source	Optional		all	A URL that returns the layout area contents. ColdFusion uses standard page path resolution rules. You can use a bind expression with dependencies in this attribute. If a file specified in this attribute includes tags that use AJAX features, such as cfform, cfgrid, and cfpod, use the cfajaximport tag on the page that includes the cflayoutarea tag. For more information, see cfajaximport. For more information on the source attribute, see Usage.
splitter	Optional	false	border	A Boolean value that specifies whether the layout area has a divider between it and the adjacent layoutarea control. Users can drag the splitter to change the relative sizes of the areas. If this attribute is set to true on a left or right position layout area, the splitter resizes the area and its adjacent area horizontally. If this attribute is set to true on a top or bottom position layout area, the splitter resizes the layout vertically. You cannot use this attribute for border layout areas with a position attribute value of center.
style	Optional		all	A CSS style specification that controls the appearance of the area.
tabTip	Optional		tab	If defined, a tab tip is displayed.
title	Optional; required for tab layouts		border, tab, accordion	For tab layouts, the text to display on the tab. For border layouts, if you specify this attribute, ColdFusion creates a title bar for the layout area with the specified text as the title. By default, border layouts that are not closable or collapsible do not have a title bar. You cannot use this attribute for border layout areas with a position attribute value of center.
{{title}}icon	Optional		accordion	Specifies the location of the icon to display with the title.

Usage

All cflayoutarea tags must be children of cflayout tags and cannot have cflayoutarea tags as immediate children, but they can contain cflayout tags. However, the cflayoutarea tags do not have to be direct children of the cflayout tag; instead, the cflayout tag could have a tag such as cfloop or cfquery as a child, and the cflayoutarea tags could be in the body of the cfloop or cfquery tag. These rules let you create arbitrarily complex combinations of different layouts.

Note:

You cannot put a layout of type border inside a layout of type tab.

If you do not specify a size attribute value, ColdFusion attempts to determine the required size for the layout area contents. However, in some cases, such as when the layout area contains AJAX controls, ColdFusion might not be able to determine the required size, and you must specify the size attribute to make the AJAX control appear. In these cases, a scroll bar appears for the layout area.
You can use a source attribute or a tag body to specify the layout area contents; if you specify both, ColdFusion uses the contents specified by the source attribute and ignores the tag body. If you use a source attribute, an animated icon and the text "Loading..." appears while the contents is being fetched.
If the source attribute specifies a page that defines JavaScript functions, the function definitions on that page must have the following format:

functionName = function(arguments) {function body}

Function definitions that use the following format may not work:

function functionName (arguments) {function body}

However, Adobe recommends that you include all custom JavaScript in external JavaScript files and import them on the application's main page, and not write them inline in code that you get using the source attribute. Imported pages do not have this function definition format restriction.

If you use the source attribute, you can use a bind expression to include form field values or other form control attributes as part of the source specification. You can bind to HTML format form controls only. For detailed information on using bind expressions see Using Ajax Data and Development Features in the Developing ColdFusion Applications. In border type layouts, a center layout area always takes up any space that is not used by the other areas, even if you do not specify a cflayoutarea tag with a center position attribute. Therefore, if you want only two layout areas in either direction, one of the two must be the center area, or you must explicitly size the two areas to take up the full layout area.
When you nest layouts, set the inner layout area initial sizes appropriately to ensure that they appear.Use the following JavaScript functions to enable, disable, show, hide, expand, collapse, and select layout areas:

Function	Description
ColdFusion.Layout.createTab	Creates a tab in an existing tabbed layout.
ColdFusion.Layout.disableTab	Disables the specified tab so it cannot be selected.
ColdFusion.Layout.enableTab	Enables the specified tab so users can select it and display the area contents.
ColdFusion.Layout.hideTab	Hides a tab.
ColdFusion.Layout.selectTab	Selects a tab and displays the layout area contents.
ColdFusion.Layout.showTab	Shows a tab that was hidden using the inithide attribute or the hideTab() function.
ColdFusion.Layout.collapseArea	Collapses an area of a border layout.
ColdFusion.Layout.expandArea	Expands a collapsed area of a border layout.
ColdFusion.Layout.getTabLayout	Hides an area of a border layout.
ColdFusion.Layout.hideArea	Hides an area of a border layout.
ColdFusion.Layout.showArea	Shows an area of a border layout that was hidden using the inithide attribute or the hideArea() function.
ColdFusion.Layout.hideAccordion	Hides an accordion.
ColdFusion.Layout.showAccordion	Shows an accordion that was hidden using the inithide attribute or the hideArea() function.
ColdFusion.Layout.selectAccordion	Selects an accordion and displays the layout area contents.
ColdFusion.Layout.collapseAccordion	Collapses an area of an accordion layout.
ColdFusion.Layout.expandAccordion	Expands a collapsed area of an accordion layout.

When you use the style attribute to specify the background color of a border layout area, specify a height style of 100% to make the background color cover the entire layout area. This is because the style specification applies to an inner content area of the layout area, not the layout area itself, and the 100% specification ensures that the content area takes up all available space in the layout area.

Example

The following example creates a three-tabbed layout and lets you use buttons to dynamically control the second tab.

<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> 
</head> 
<body> 
<h3>Atab</h3> 
<cflayout type="tab" name="thelayout" tabheight="175" style="background-color:##CCffFF; 
color:red; height:200"> 
<cflayoutarea title="Tab 1" style="background-color:##FFAAFF;" closable="true"> 
This is text in layout area 1 
</cflayoutarea> 
<cflayoutarea name="area2" title="Tab 2" inithide="true" 
style="background-color:##FFCCFF" > 
This is text in layout area 2 
</cflayoutarea> 
<cflayoutarea title="Tab 3" style="background-color:##FF99FF;"> 
This is text in layout area 3 
</cflayoutarea> 
</cflayout> 
<br /> 
<cfform> 
<cfinput name="show" width="40" value="show tab" type="button" 
onClick="ColdFusion.Layout.showTab('thelayout', 'area2');"> 
<cfinput name="hide" width="40" value="hide tab" type="button" 
onClick="ColdFusion.Layout.hideTab('thelayout', 'area2');"> 
<cfinput name="enable" width="40" value="enable tab" type="button" 
onClick="ColdFusion.Layout.enableTab('thelayout', 'area2');"> 
<cfinput name="disable" width="40" value="disable tab" type="button" 
onClick="ColdFusion.Layout.disableTab('thelayout', 'area2');"> 
<cfinput name="select" width="40" value="select tab" type="button" 
onClick="ColdFusion.Layout.selectTab('thelayout', 'area2');"> 
</cfform> 
</body> 
</html>

Get help faster and easier

New user?

cflayoutarea

Description

Category

Syntax

See also

History

Attributes

Usage

Example

Get help faster and easier

Share this page

Ask the Community

Contact Us