cfgridcolumn

Used with the cfgrid tag in a cfform. Use this tag to specify
column data in a cfgrid control. The font and alignment
attributes used in cfgridcolumn override global font or
alignment settings defined in cfgrid.

  <cfgridcolumn name="">

 cfgridcolumn(name="");

This tag requires Adobe ColdFusion 3 and up.  Not supported on Lucee, etc.

Discouraged: The use of tags generating UI is generally discouraged by the CFML community. See: https://static.raymondcamden.com/cfuitherightway/cfgrid/index.html

Attribute Reference

name string
Required

Name of grid column element. If grid uses a query, column
name must specify name of a query column.

header string

Column header text. Used only if cfgrid colHeaders = "Yes".

width numeric

Column width, in pixels.

font string
Default: arial

Font of data in column.
Values:
  • arial
  • times
  • courier
  • arialunicodeMS

fontsize numeric

Size of text in column.

italic boolean
Default: false

Yes: displays grid control text in italics
Values:
  • true
  • false

bold boolean
Default: false

Yes: displays grid control text in bold
Values:
  • true
  • false

bgcolor string

Background color of control. For a hex value, use the form:
textColor = "##xxxxxx", where x = 0-9 or A-F; use two hash
signs or none.
Values:
  • black
  • red
  • blue
  • magenta
  • cyan
  • orange
  • darkgray
  • pink
  • white
  • lightgray
  • yellow

textcolor string

Text color for control. For a hex value, use the form:
textColor = "##xxxxxx", where x = 0-9 or A-F; use two hash
signs or none.
Values:
  • black
  • red
  • blue
  • magenta
  • cyan
  • orange
  • darkgray
  • pink
  • white
  • lightgray
  • yellow

href string

URL or query column name that contains a URL to hyperlink
each grid column with.

hrefkey string

The query column to use for the value appended to the href
URL of each column, instead of the column's value.

target string

Frame in which to open link specified in href.

select boolean

Yes: user can select the column in grid control.
Values:
  • true
  • false

display boolean

No: hides column
Values:
  • true
  • false

type string

image: grid displays image that corresponds to value in
column (a built-in CFML image name, or an image in
cfide\classes directory or subdirectory referenced with
relative URL). If image is larger than column cell, it is
clipped to fit. Built-in image names
Values:
  • string_noCase
  • Boolean
  • numeric
  • date
  • combobox
  • image

headerfont string

Font of data in column.

headerfontsize numeric

Size of text in column.

headeritalic boolean

Yes: displays grid control text in italics
Values:
  • true
  • false

headerbold boolean

Yes: displays grid control text in bold
Values:
  • true
  • false

headertextcolor string

Text color for control. For a hex value, use the form:
textColor = "##xxxxxx", where x = 0-9 or A-F; use two hash
signs or none.
Values:
  • black
  • red
  • blue
  • magenta
  • cyan
  • orange
  • darkgray
  • pink
  • white
  • lightgray
  • yellow

dataalign string

Column data alignment
Values:
  • left
  • right
  • center

headeralign string

Column header text alignment
Values:
  • left
  • right
  • center

numberformat string

Format for displaying numeric data in grid. See
numberFormat mask characters.

values string

Formats cells in column as drop-down list boxes; specify
items in drop-down list. Example:
values = "arthur, scott, charles, 1-20, mabel"

valuesdisplay string

Maps elements in values attribute to string to display in
drop-down list. Delimited strings and/or numeric range(s).

valuesdelimiter string

Maps elements in values attribute to string to display in
drop-down list. Delimited strings and/or numeric range(s).

mask string

A mask pattern that controls the character pattern
that the form displays or allows users to input and
sends to ColdFusion.
For currency type data, use currency symbol.
For text or numeric type data use:
- A = [A-Za-z]
- X = [A-Za-z0-9]
- 9 = [0-9]
- ? = Any character
- all other = the literal character
For date type data use Ext.Date masks.

headerIcon string

Header Icon for grid column

Links more information about cfgridcolumn

Examples
Sample code using the cfgridcolumn tag

Signup for cfbreak to stay updated on the latest news from the ColdFusion / CFML community. One email, every friday.

Fork me on GitHub