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>
WIDTH  
  オプション
 
Default value: "20"

列の幅です。表示されるデータの長さがこの値を越える場合、データは列内に収まるように切り捨てられます。これを避けるには、HTML の table タグを使用します。

前後の cftable タグに htmltable 属性がある場合は、width でテーブル幅のパーセントを指定すると、テキストが切り捨てられません。あるいは、width で文字数を指定します。

ALIGN  
  オプション
 
Default value: "left"

列の配置です。

  • left
  • right
  • center
TEXT  
  必須
 

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