User Guide

326 Chapter 2: ColdFusion Tags
Attributes
Attribute Req/Opt Default Description
name Required Name of the parameter (variable) to test (such as "Client.Email " or
"Cookie.BackgroundColor "). If omitted, and if the parameter
does not exist, an error is thrown.
type Optional any The valid format for the data; one of the following. For detailed
information on validation algorithms, see “Validating form data
using hidden fields” in Chapter 28, “Validating Data,” in
ColdFusion MX Developer’s Guide.
• any: any type of value.
• array: an array of values.
• binary: a binary value.
• boolean: a Boolean value: yes, no, true, false, or a number.
• creditcard: a 13-16 digit number conforming to the mod10
algorithm.
• date or time: a date-time value.
• email: a valid e-mail address.
• eurodate: a date-time value. Any date part must be in the format
dd/mm/yy, The format can use /, -, or . characters as delimiters.
• float or numeric: a numeric value.
• guid: a Universally Unique Identifier of the form "
XXXXXXXX-XXXX-
XXXX-XXXX-XXXXXXXXXXXX
" where ‘X’ is a hexadecimal number.
• integer: an integer.
• query: a query object.
• range: a numeric range, specified by the
min and max attributes.
• regex or regular_expression: matches input against
pattern
attribute.
• ssn or social_security_number: a U.S. social security number.
• string: a string value or single character.
• struct: a structure.
• telephone: a standard U.S. telephone number.
• URL: an http, https, ftp, file, mailto, or news URL.
• UUID: a ColdFusion Universally Unique Identifier, formatted
‘
XXXXXXXX-XXXX-XXXX-XXXXXXXXXXXXXXX’, where ‘X’ is a
hexadecimal number. See CreateUUID on page 544.
• USdate: a U.S. date of the format mm/dd/yy, with 1-2 digit days
and months, 1-4 digit years.
• variableName: a string formatted according to ColdFusion
variable naming conventions.
• xml: XML objects and XML strings.
• zipcode: U.S., 5- or 9-digit format ZIP codes.
default Optional Value to set parameter to if it does not exist. Any expression used
for the default attribute is evaluated, even if the parameter exists.
The result is not assigned if the parameter exists, but if the
expression has side effects, they still occur.
max Optional The maximum valid value; used only for
range validation.