cfform タグ内で使用します。ColdFusion フォーム内にグリッドコントロール (データのテーブル) を作成します。グリッド列および行のデータを指定するには、cfgridcolumn タグと cfgridrow タグを使用するか、query 属性を使用した上で必要に応じて cfgridcolumn タグを併用します。

フォームタグ

cfapplet、 cfcalendar、cfgridcolumn、cfgridrow、cfgridupdate、cfform、cfformgroup、cfformitem、cfgrid、cfinput、cfselect、cfslider、cftextarea、cftree

ColdFusion MX 7:

• format 属性が追加され、Flash 形式と XML 形式の出力がサポートされるようになりました。
• enabled、onChange、style、tooltip、および visible の各属性が追加されました (Flash 形式の場合のみ)。

ColdFusion MX: rowHeaderWidth 属性が変更されました。ColdFusion では、rowHeaderWidth 属性を使用しません。この属性は省略できます。

このタグは、cfform タグブロックの内部で使用する必要があります。

アプレット形式のグリッドでは、クライアントが Java アプレットをダウンロードする必要があります。また、クライアントに最新の Java プラグインがインストールされていない場合、アプレット形式のグリッドを表示するために最新の Java プラグインをダウンロードしなければならないこともあります。Flash 形式のグリッドでは Flash コントロールを使用します。このツリーは、HTML 形式の cfform タグに埋め込むことができます。このタグを Flash 形式またはアプレット形式のいずれかで正しく動作させるには、JavaScript 対応のブラウザを使用する必要があります。

cfgrid には、cfquery からのデータを挿入できます。cfgrid 本文で cfgridcolumn タグを何も指定しない場合、ColdFusion は次のものを備えたグリッドを生成します。

• クエリーの各列用の列。
• テーブルの列名にあるハイフンやアンダースコア記号がスペースに置き換えられて作成された、各列のデフォルトのヘッダ。先頭の文字とスペースの後ろの文字は大文字に変更されます。他の文字はすべて小文字です。

このタグには終了タグが必要です。

このタグは、HTML フォームコントロールと同様に、フォームのアクションページに送信されるデータにフォーム変数を設定することでデータを返します。このデータはタグの SelectMode 属性値によって異なるため、返されるフォーム変数もこの属性の値によって異なります。

一般に、返されるデータは次のいずれかのカテゴリに当てはまります。

• 単純な選択オペレーションから返される簡単なデータ
• 挿入、更新、および削除オペレーションから返される複雑なデータ

フォーム変数が cfform のアクションページに返すデータには、ユーザーが選択したセルについての情報が含まれます。このデータは、一般に、Form スコープ内の ColdFusion 変数という形でアクションページ内で使用できます。この変数には form.#GridName#.#ColumnName# というネーミング規則が適用されます。

SelectMode 属性の値に応じて、次のフォーム変数が返されます。

• SelectMode="single"

form.#GridName#.#ColumnName# = "SelectedCellValue"

• SelectMode="column"

form.#GridName#.#ColumnName# = "ValueOfCellRow1, 
ValueOfCellRow2, ValueOfCellRowN"

• SelectMode="row"

form.#GridName#.#Column1Name# = "ValueOfCellInSelectedRow"
form.#GridName#.#Column2Name# = "ValueOfCellInSelectedRow"
form.#GridName#.#ColumnNName# = "ValueOfCellInSelectedRow"

ユーザーがグリッドに行った挿入、更新、または削除の操作をアクションページに通知するために、グリッドからは大量のデータが返されます。ほとんどの場合、cfgridupdate タグを使用してフォーム変数からデータを自動的に収集できます。このタグはデータの収集、SQL 呼び出しの記述、およびデータソースの更新を行います。

cfgridupdate を使用できない場合は (たとえば、返されたデータを複数のデータソースに分散する必要がある場合など)、フォーム変数を読み取るコードを記述する必要があります。このモードでは、ColdFusion により各 cfgrid に対して、次の Form スコープの配列変数が作成されます。

form.#GridName#.#ColumnName#
form.#GridName#.original.#ColumnName#
form.#GridName#.RowStatus.Action

更新、挿入、または削除情報が含まれているテーブルの各行は、それぞれの配列に並行したエントリを持つことになります。変更情報をすべて確認するには、次のようにして配列を反復処理します。送信された cfform 上で cfgrid と共に機能するようにするには、GridName 変数をそのグリッドの名前に設定し、ColNameList をグリッド列のリストに設定します。

<cfloop index="ColName" list="#ColNameList#">
   <cfif IsDefined("form.#GridName#.#ColName#")>   
      <cfoutput><br>form.#GridName#.#ColName#:<br></cfoutput>
      
      <cfset Array_New = form.[#GridName#][#ColName#]>
      <cfset Array_Orig = form[#GridName#]['original'][#ColName#]>
      <cfset Array_Action = form[#GridName#]RowStatus.Action>
      
      <cfif NOT IsArray(Array_New)>
         <b>フォーム変数は配列ではありません。</b><br>
      <cfelse>
         <cfset size = ArrayLen(Array_New)>
         <cfoutput> 
         生成された配列のサイズは #size# です。<br>
         コンテンツ : <br>
         </cfoutput>
         
         <cfif size IS 0>
            <b>配列は空です。</b><br>
         <cfelse>
            <table BORDER="yes">
               <tr> 
                  <th>ループインデックス</TH>
                  <th>アクション</TH>
                  <th>古い値</TH>
                  <th>新規の値</TH>
               </tr>
               <cfloop index="LoopCount" from="1" to=#size#>   
                   <cfset Val_Orig   = Array_Orig[#LoopCount#]>   
                   <cfset Val_New    = Array_New[#LoopCount#]>   
               <cfset Val_Action   = Array_Action[#LoopCount#]>
               <cfoutput>
               <tr>
                  <td>#LoopCount#</td>
                  <td>#Val_Action#</td>
                  <td>#Val_Orig#</td>
                  <td>#Val_New#</td>
               </tr>
               </cfoutput>
               </cfloop>
            </table>            
         </cfif>         
      </cfif>   

   <cfelse>
      <cfoutput>form.#GridName#.#ColName# が設定されていません。</cfoutput><br>   
   </cfif>   
</cfloop>

href 属性を使用してグリッド項目付きの URL を指定するときには、追加するキー値を 1 つのグリッド項目に制限するか、1 つのグリッド列またはグリッド行に拡大するかが selectMode 属性の値によって決まります。リンクされているグリッド項目をユーザーがクリックすると、cfgridkey 変数が次の形式で URL に追加されます。

http://myserver.com?cfgridkey=selection

appendKey 属性を no に設定すると、グリッド値は URL に追加されません。

selection の値は、selectMode および属性の値によって決まります。

• hrefKey 属性を指定した場合、selection はこの属性で指定した列のフィールド名となります。それ以外の場合は、次のいずれかです。
• selectMode="Single" の場合、selection はクリックした列の値となります。
• selectMode="Row" の場合、selection は、クリックした行に含まれる列の値をカンマで区切ったリストとなります (行内の最初のセルから順に含まれます)。
• selectMode="Column" の場合、selection は、クリックした列に含まれる行の値をカンマで区切ったリストとなります (列内の最初のセルから順に含まれます)。

次の例では、cfdocexamples データベース内の CourseList テーブルにある利用可能なコースのセットを表示する Flash フォームを作成します。cfgrid タグを使用するさらに複雑な例については、cfgridcolumn、cfgridrow、およびcfgridupdateを参照してください。

<!--- データベースにクエリーを実行し、グリッドの埋め込みを行います。 --->
<cfquery name = "GetCourses" dataSource = "cfdocexamples">
SELECT Course_ID, Dept_ID, CorNumber,
CorName, CorLevel
FROM  CourseList
ORDER by Dept_ID ASC, CorNumber ASC
</cfquery>

<h3>cfgrid の例</h3>
<I>現在利用可能なコース</i>
<!--- cfgrid は cfform タグの内部で使用する必要があります。 --->
<cfform>
   <cfgrid name = "FirstGrid" format="Flash"
      height="320" width="580"
      font="Tahoma" fontsize="12"
      query = "GetCourses">
   </cfgrid>
</cfform>