CFCOL |
説明 テーブルの列ヘッダ、幅、配置、およびテキストを定義します。cftable タグ内で使用します。
カテゴリ データ出力タグ
シンタックス
    <cfcol
       header = "column_header_text"
       width = "number_indicating_width_of_column"
       align = "Left"、"Right"、"Center" のいずれか
       text = "column_text">
関連項目 cfcontent、cfoutput、cftable、『ColdFusion MX 開発ガイド』の第40章の「リモートサーバーとの対話」 の「cfftp タグによるファイルオペレーションの実行」
ヒストリ ColdFusion MX: ダイナミックな cfcol ステートメントを構築する機能が追加されました。
使用方法 cftable タグ内には、1 つ以上の cfcol タグを指定する必要があります。また、cfcol タグおよび cftable タグはページ内で隣接させて配置する必要があります。cftable タグ内にネストできるのは、cfcol タグのみです。cftable タグはネストできません。 cfcol の header で指定されるテキストを表示するには、cfcol の header 属性と cftable の colHeader 属性を指定する必要があります。どちらかの属性を一方だけ指定しても、ヘッダは表示させません。ここではエラーは発生しません。
例
    <!--- この例では、クエリーから返される情報を、cfcol および cftable を
    使用して整列する方法を示します。 --->
    <!--- クエリーで cfdocexamples データソースから情報を選択します。 --->
    <cfquery name = "GetEmployees" dataSource = "cfdocexamples">
       SELECT  Emp_ID, FirstName, LastName, EMail, Phone, Department
       FROM Employees
    </cfquery>
    <html>
    <body>
    <h3>cfcol の例</h3>
    <!--- HTMLTable 属性を使用して、cftable を PRE 形式の情報としてではなく
    HTML テーブルとして表示する --->
    <cftable
       query = "GetEmployees"
       startRow = "1" colSpacing = "3"
       HTMLTable colheaders>
    <!--- 各 cfcol タグで、テーブル内の列の幅、ヘッダ情報、セルの
    テキスト/CFML を設定します。 --->
       <cfcol header = "<b>ID</b>"
          align = "Left"
          width = 2
          text  = "#Emp_ID#">
       <cfcol header = "<b>名前と電子メール</b>"
          align = "Left"
          width = 15
          text  = "<a href = 'mailto:#Email#'>#FirstName# #LastName#</A>">
       <cfcol header = "<b>電話番号</b>"
          align = "Center"
          width = 15
          text  = "#Phone#">
    </cftable>

HEADER |
| 必須
列ヘッダのテキストです。この属性を使用する場合は、cftable colHeaders 属性も使用する必要があります。

WIDTH |
| オプション
Default value: "20" 列の幅です。表示されるデータの長さがこの値を越える場合、データは列内に収まるように切り捨てられます。これを避けるには、HTML の table タグを使用します。 前後の cftable タグに htmltable 属性がある場合は、width でテーブル幅のパーセントを指定すると、テキストが切り捨てられません。あるいは、width で文字数を指定します。

ALIGN |
| オプション
Default value: "left" 列の配置です。 left right center

TEXT |
| 必須
二重引用符 (") で区切ったテキストです。表示する内容を決定します。ルールは、cfoutput セクションの場合と同じです。ハイパーリンク、イメージへのリファレンス、入力コントロールなどを埋め込むことができます。