| CFTREEITEM | |||
| 説明
cftree タグによって作成されたフォームツリーコントロールに 1 つ以上の要素を挿入します。 |
|||
| カテゴリ
フォームタグ | |||
シンタックス<cftreeitem value = "text" display = "text" parent = "parent_name" img = "filename" imgopen = "filename" href = "URL" target = "URL_target" query = "queryname" queryAsRoot = "yes"、"no" expand = "yes"、"no"> |
|||
| 関連項目
cfapplet、cfform、cfformgroup、cfformitem、cfgrid、cfinput、cfselect、cfslider、cftextarea、cftree、『ColdFusion MX 開発ガイド』の第27章の「cfform タグによるダイナミックフォームの作成」 の「cftree タグによるツリーコントロールの構築」
|
|||
| 使用方法
このタグを使用する場合は、クライアントで Java アプレットをダウンロードする必要があります。アプレットのダウンロードには時間がかかるため、このタグを使用すると、同じ情報を取得するのに HTML の form 要素や cfinput タグを使用する場合よりも処理速度が少し遅くなる可能性があります。 このタグを正しく動作させるには、JavaScript 対応のブラウザを使用する必要があります。 このタグに挿入するためにクエリーを使用しない場合は、単一のツリー項目が作成されます。クエリーを使用する場合は、複数の項目が作成されます。クエリーの各行では、階層的にネストされた項目のセットが列ごとの 1 項目について作成されます。 |
|||
| 例
次の例では、単一の cftreeitem タグおよびクエリーを使用してシンプルなツリーを作成します。 <cfform action = "#cgi.script_name#">
<cftree name = "Employees" height = "400" width = "200">
<cftreeitem value="LastName, FirstName, Emp_ID" query="getEmployees"
queryAsRoot="False">
</cftree>
</cfform>
次の例では、部門別に構成された、組織内の全従業員に関する基本情報を示すツリーを作成します。部門を展開すると、全従業員が表示されます。プラス記号 (+) をクリックすると、追加情報が表示されます。従業員名をクリックすると、同じページに戻り、選択した従業員の ID が表示されます。 <!--- データソースにクエリーを実行して、従業員情報を取得します。--->
<!--- 出力を部門別にグループ化します
(Group By 節にはすべてのフィールドが必要です)。 --->
<cfquery name = "GetEmployees" dataSource = "cfdocexamples">
SELECT Emp_ID, FirstName, LastName, EMail, Phone, Department
FROM Employees
GROUP BY Department, Emp_ID, FirstName, LastName, EMail, Phone
</cfquery>
<html>
<body>
<h3>cftreeitem の例</h3>
<!--- ツリー内のリンクをクリックすると、次の処理が実行されます。
アプリケーション全体で追加処理に ID を使用します。 --->
<cfif isdefined("URL.user_ID")>
<cfoutput>
<!--- URL.cftreeitemkey は選択されたツリー項目の value 属性です。 --->
#URL.cftreeitemKey#; User ID #URL.user_ID# の情報をリクエストしました。
</cfoutput>
<br><br>
</cfif>
<!--- ツリーを表示します。cfform 内に cftree タグが必要です。 --->
<cfform>
<cftree name = "Employees" height = "400" width = "200"
font = "Arial Narrow" highlighthref="No" hscroll="No">
<!--- group 属性を使用する cfoutput タグが部門をループします。 --->
<cfoutput group="Department" query = "GetEmployees">
<cftreeitem value="#Department#" parent="Employees" expand="yes">
<!--- この cfoutput タグが部門のレコードをループします。
cfouput タグには属性は必要ありません。 --->
<cfoutput>
<!--- 部門内の各従業員に対して項目を作成します。
子は展開しません。各従業員名はこのページにリンクし、
クエリー文字列内の従業員 ID を送信します。--->
<cftreeitem value = "#LastName#, #FirstName#"
display = "#LastName#, #FirstName#"
parent = "#Department#" expand="no"
href="#cgi.script_name#?user_id=#emp_id#">
<!--- 各従業員エントリには、ID および ContactInfo の子があります。 --->
<cftreeitem value = "#Emp_ID#" display = "Employee ID:#Emp_ID#"
parent = "#LastName#, #FirstName#">
<!--- 各ノードは固有の値である必要があるため、Emp_ID om 値を使用します。 --->
<cftreeitem value = "#Emp_ID#_ContactInfo"
display = "Contact Information"
parent = "#LastName#, #FirstName#" expand = "No">
<!--- ContactInfo には 2 つの子があります。 --->
<cftreeitem value = "#Phone#" parent = "#Emp_ID#_ContactInfo">
<cftreeitem value = "#Email#" parent = "#Emp_ID#_ContactInfo">
</cfoutput>
</cfoutput>
</cftree>
</cfform>
|
|||