CFASSOCIATE |
説明 サブタグデータをベースタグと共に保存できるようにします。この機能は、カスタムタグに対してのみ有効です。
カテゴリ アプリケーションフレームワークタグ
シンタックス
    <cfassociate
       baseTag = "base_tag_name"
       dataCollection = "collection_name">
関連項目 cfapplication、cferror、cflock、cfmodule、『ColdFusion MX 開発ガイド』の第11章の「カスタム CFML タグの作成と使用方法」 の「高レベルのデータ交換」
使用方法 ベースタグ内にサブタグデータを保存するには、このタグをサブタグ内から呼び出します。 ColdFusion では、サブタグ属性がベースタグに渡されると、それらはデフォルト名が AssocAttribs の構造体に保存されます。複数のサブタグを指定できるベースタグ内にサブタグ属性を区別して保存するには、dataCollection 属性に構造体名を指定します。この構造体は、thistag.collectionName という配列に追加されます。 カスタムタグコード内では、attributeCollection 属性を使用してタグに渡された属性は、それぞれ独立した値として保存され、それらの属性がカスタムタグの呼び出し側によって構造体にグループ化されたことは示されません。したがって、呼び出されたタグでは、特定の属性に値を割り当てた場合、サブタグの呼び出し時に使用した attributeCollection 属性内に渡された値が置き換えられます。
例
    <!--- コンテキストを検索します。 --->
    <cfif thisTag.executionMode is "start">
     <!--- 属性を割り当てます。 --->
     <cfassociate baseTag = "CF_TAGBASE">

     <!--- 属性のデフォルト値を定義します。 --->
     <cfparam name = "attributes.happy" default = "yes">
     <cfparam name = "attributes.sad" default = "no">
    ...

BASETAG |
| 必須
ベースタグ名です。

DATACOLLECTION |
| オプション
Default value: "AssocAttribs" ベースタグ内にサブタグデータを保管するための構造体です。