Lucee Tag Reference
<cfsetting>
Controls various aspects of page processing, such as the output of HTML code in pages. One
benefit of this option is managing whitespace that can occur in output pages served by CFML.
Body
This tag may have a body.
Example
<cfsetting [enablecfoutputonly=any] [info=string] [listen=boolean] [requesttimeout=number] [showdebug=boolean] [showdebugoutput=boolean] [showdoc=boolean] [showmetric=boolean]> [</cfsetting>]
This tag is also supported within cfscript
<cfscript> setting [enablecfoutputonly=any] [info=string] [listen=boolean] [requesttimeout=number] [showdebug=boolean] [showdebugoutput=boolean] [showdoc=boolean] [showmetric=boolean] { [...] } </cfscript>
Attributes
The attributes for this tag are fixed. Except for the following attributes no other attributes are allowed.
| Name | Type | Required | Description |
|---|---|---|---|
| enablecfoutputonly | any | No | Yes, No or Reset. When set to Yes, cfsetting blocks output of HTML that resides outside cfoutput tags. When used multiple times, this setting is cumulative, so enabling it twice, requires to it to be turned off twice. Use `reset`, to reset that count and re-enable output of html outside cfoutput tags. |
| info | string | No | name of variable created for all information for this tag. |
| listen | boolean | No | do log all action, so it can report more detail with info. |
| requesttimeout | number | No | number of seconds. Time limit, after which CFML processes the page as an unresponsive thread. Overrides the timeout set in the Lucee Administrator. |
| showdebug | boolean | No | Yes or No. When set to No, showDebug suppresses debugging information that would otherwise display at the end of the generated page. |
| showdebugoutput | boolean | No | This Attribute is deprecated |
| showdoc | boolean | No | Yes or No. When set to No, showDoc suppresses documentation/reference information that would otherwise display at the end of the generated page. |
| showmetric | boolean | No | Yes or No. When set to No, showMetric suppresses metric information that would otherwise display at the end of the generated page. |