User Guide

Chapter 1: ColdFusion Tags 159

CFPROCESSINGDIRECTIVE

Suppresses extraneous white space, and other output, produced by the CFML within

the tag’s scope.

Syntax <CFPROCESSINGDIRECTIVE

SUPPRESSWHITESPACE="Yes" or "No">

… any CFML tags here …

</CFPROCESSINGDIRECTIVE>

SUPPRESSWHITESPACE

Required. Boolean indicating whether to suppress the white space and other

output generated by the CFML tags within the CFPROCESSINGDIRECTIVE block.

Usage If a CFPROCESSINGDIRECTIVE tag’s scope includes another

CFPROCESSINGDIRECTIVE tag, then the inner tag’s settings override the enclosing

tag’s settings within the body of the inner tag, where they differ. If the enclosing tag

specifies settings that the inner tag does not, those settings remain in effect within the

inner tag’s scope.

CFPROCESSINGDIRECTIVE settings do not apply to templates included via

CFINCLUDE, CFMODULE, custom tag invocation, etc.

Example This example shows the use of a nested <CFPROCESSINGDIRECTIVE> tag. The outer

<CFPROCESSINGDIRECTIVE> tag suppresses unnecessary whitespace during

computation of a large table while the inner <CFPROCESSINGDIRECTIVE> tag honors

all whitespace to output the preformatted table.

… any CFML tags here …

<CFOUTPUT>#interesting_stuff#</CFOUTPUT>

</CFPROCESSINGDIRECTIVE>