<cfhtmltopdfitem> specifies the action items for a PDF document created by the <cfhtmltopdf> tag. The type attribute takes the following values:
Data output tags
<cfhtmltopdfitem> type = header/footer/pagebreak isBase64 = "yes|no" showonprint = "yes|no" align = "left|right|center" evalAtPrint = "true|false" marginleft = "number" marginright = "number" margintop = "number" marginbottom = "number" opacity = "number” numberformat = "LOWERCASEROMAN|NUMERIC|UPPERCASEROMAN" image = " URL|pathname absolute or relative to web root" </cfhtmltopdfitem>
Attribute |
Req/Opt |
Default |
Description |
---|---|---|---|
type |
Required |
none |
Specifies the action:
Note: When the type is "header", the marginbottom attribute will not be supported. Similarly, when type is "footer", the margintop attribute will not be supported. |
isBase64 |
Optional |
|
Yes/No. Use this only when the image attribute is given a base64 image string. |
showonprint |
Optional |
|
Show or hide header/footer when the document is printed. |
align |
Optional |
Center |
Alignment of the text. Left, Right, or Center. |
evalAtPrint |
Optional |
false |
If set to true, then the content of cfhtmltopdfitem is evaluated after the PDF has been generated and the page numbers are available for each page. This allows you to have some conditional code inside the cfhtmltopdfitem. Note: If evalAtPrint=true, the numberformat attribute must be set to numeric. |
marginleft |
Optional |
1.0 |
Left margin in inches (default) or centimeters. To specify the left margin in centimeters, include the unit=cm attribute. |
marginright |
Optional |
1.0 |
Right margin in inches (default) or centimeters. To specify the left margin in centimeters, include the unit=cm attribute. |
margintop |
Optional |
0.5 |
Top margin in inches (default) or centimeters. To specify the left margin in centimeters, include the unit=cm attribute. |
marginbottom |
Optional |
0.5 |
Bottom margin in inches (default) or centimeters. To specify the bottom margin in centimeters, include the unit=cm attribute. |
opacity |
Optional |
10 |
Opacity of the header/footer. Specify a valid number. A number between 1 and 10. |
numberformat |
Optional |
Numeric |
The page number format to be used. LOWERCASEROMAN|NUMERIC|UPPERCASEROMAN |
image |
Optional |
|
The image file name or object to be used as header or footer. The following parameters are supported:
|
<cfhtmltopdf destination="myPDF.pdf" source="http://somesite.com" overwrite="true"> <cfhtmltopdfitem type="header"> Page: _PAGENUMBER of _LASTPAGENUMBER </cfhtmltopdfitem> <cfhtmltopdfitem type="pagebreak" /> <cfhtmltopdfitem type="footer" image="test.jpg"> </cfhtmltopdfitem> </cfhtmltopdf>
This tag supports very limited HTML in its body. This tag only supports these 5 HTML tags: <body>, <p>, <i>, <b> and <span>.
The complete reference of HTML supported is listed here.
You can access the following scope variables in <cfhtmltopdfitem> content:
_CURRENTPAGENUMBER - Add current page number.
Sign in to your account