User Guide

154 Chapter 2: ColdFusion Tags
sort Optional No The sort button performs simple text sort on
column. User can sort columns by clicking
column head or by clicking sort buttons. Not
valid with
selectmode=browse.
• Yes: sort buttons display on grid control
• No
font Optional Font of column data in the grid control.
fontSize Optional Size of text in the grid control, in points.
italic Optional No • Yes: displays grid control text in italic
• No
bold Optional No • Yes: displays grid control text in bold
• No
textColor Optional Black Color of text in grid control; hex or text.
Hex value or supported named color; see name
list in the Usage section.
For a hex value, use the form "
##xxxxxx", where
x = 0-9 or A-F; use two pound signs or none.
For a list of the supported named colors, see
cfchart on page 70.
href Optional URL o r query column name that contains a
URL to hyperlink each grid cell with.
hrefKey Optional The query column to use for the value appended
to the
href URL of each cell, instead of the cell's
value.
target Optional Target of
href URL.
appendKey Optional Yes • Yes: When used with
href, appends
"GFGRIDKEY=" and the value of the cell to
each cell's URL.
• No
highlightHref Optional Yes • Yes: highlights links associated with a
cfgrid
with an
href attribute value
• No
onValidate Optional A JavaScript function to validate user input. The
form object, input object, and input object value
are passed to routine, which returns True if
validation succeeds; False otherwise.
onError Optional A JavaScript function to execute if validation
fails.
gridDataAlign Optional Left • Left: left-aligns data within column.
• Right: right-aligns data within column.
• Center: center-aligns data within column.
gridLines Optional Yes • Yes: enables row and column rules in grid
control
• No
Attribute Req/Opt Default Description