GETBASETAGLIST |
説明 親タグから開始して、先祖タグの名前を取得します。
戻り値 大文字の先祖タグの名前をカンマで区切ったリストの文字列。リストの最初の要素は現在のタグです。現在のタグがネストされている場合は、次の要素が親タグになります。トップレベルのタグに対してこの関数が呼び出されると、空の文字列が返されます。先祖タグからデータが得られない場合 (GetBaseTagData を参照)、その名前は返されません。
カテゴリ その他の関数
関数のシンタックス
    GetBaseTagList()
関連項目 GetBaseTagData、『ColdFusion MX 開発ガイド』の第11章の「カスタム CFML タグの作成と使用方法」 の「高レベルのデータ交換」
使用方法 この関数は、先祖タグリスト内の次のようなタグ、または終了タグは表示しません。 cfif、cfelseif、cfelse cfswitch、cfcase、cfdefaultcase cftry、cfcatch この関数は、次のような条件でのみ次のようなタグを表示します。 cfloop: query 属性を使用している場合 cfoutput: 複雑な式を持つ子タグが 1 つでもある場合 cfprocessingdirective: pageencoding 以外にその他の属性が 1 つでもある場合
例
    <!--- この例は、GetBaseTagList 関数の使用方法を示しています。
    通常は、カスタムタグ内で使用します。 --->
    <cfif thisTag.executionMode is "start">
       <!--- タグのコンテキストスタックを取得
       リストには "CFIF,MYTAGNAME..." のように表示されます。 --->
       <cfset ancestorList = GetBaseTagList()>
        <br><br>GetBaseTagList の出力のダンプ:<br>
       <cfdump var="#ancestorList#"><br><br>
       <!--- 現在のタグ名を出力 --->
       <cfoutput>これはカスタムタグ #ListGetAt(ancestorList,1)# です。</cfoutput><br>
       <!--- このタグがループ内でネストされているかどうかを調べる --->
       <cfset inLoop = ListFindNoCase(ancestorList, "cfloop")>
       <cfif inLoop>
          cfloop タグのコンテキスト内で実行中です。<br>
       </cfif>
    </cfif>