| CFSELECT | |||||
| 説明
ドロップダウンリストボックスのフォームコントロールを構築します。cfform タグ内で使用します。クエリーから、または HTML option タグを使用して、リストにデータを挿入できます。 |
|||||
| カテゴリ
フォームタグ | |||||
シンタックス<cfselect name = "name" label = "label" style = "style specification" size = "integer" required = "yes"、"no" message = "text" onError = "text" multiple = "yes"、"no" query = "queryname" value = "text" display = "text"> group = "query column name queryPosition = "above"、"below" selected = "value or list" onKeyUp = "JavaScript or ActionScript" onKeyDown = "JavaScript or ActionScript" onMouseUp = "JavaScript or ActionScript" onMouseDown = "JavaScript or ActionScript" onChange = "JavaScript or ActionScript" onClick = "JavaScript or ActionScript" visible = "Yes"、"No" enabled = "Yes"、"No" tooltip = "tip text" height = "number of pixels" Flash の場合のみ width = "number of pixels" Flash の場合のみ > HTML オプションタグ (省略可能) </cfselect> |
|||||
| 関連項目
cfapplet、cfcalendar、cfform、cfformgroup、cfformitem、cfgrid、cfinput、cfslider、cftextarea、cftree、『ColdFusion MX 開発ガイド』の第26章の「データの取得および形式設定について」 |
|||||
| ヒストリ
ColdFusion MX 7:
次の表は、ColdFusion が直接使用する属性のリストです。このリストに記載されていない HTML select タグ属性もすべてサポートされ、ブラウザに直接渡されます。
|
|||||
| 使用方法
このタグには終了タグが必要で、HTML option 子タグおよび optgroup 子タグを含めることができます。 選択したリストボックスの項目をポストバック全体にわたって確実に保持するには、cfform の preserveData 属性をクエリーから生成されたリストと共に使用します (この方法は、クエリーから挿入されたデータでのみ機能します)。 cfform の preserveData 属性が true でフォームが同じページに送信される場合に、コントロール用のデータがクエリーから挿入されると、cfselect コントロール用に送信された選択肢が Selected 属性の値の代わりに使用されます。正規の HTML の option タグが挿入されるコントロールの場合、開発者は Selected 属性を適切な option タグに動的に追加する必要があります。 group オプションでは、SQL GROUP BY シンタックスを使用したクエリーが生成され、group 列のフィールド名の下にあるインデントされたリストに各グループの value 列エントリが配置されます。このオプションにより、各エントリの HTML optgroup タグが group 列に生成されます。 </option> 終了タグがある cfselect タグ本文内の各 HTML option タグを閉じます。このタグを閉じないで queryPosition="below" を指定した場合、クエリーからの最初の項目がリストに表示されないことがあります。 このタグを正しく動作させるには、JavaScript 対応のブラウザを使用する必要があります。 詳細については、cfform タグのエントリを参照してください。 |
|||||
| 例
次の例では、部門別にグループ化された全従業員のリストから 1 人以上の従業員名を選択します。選択した名前とその従業員の電子メールアドレスが表示されます。全従業員のデータを取得するオプションもあります。 <!--- 従業員名をデータベースから取得します。 --->
<!--- SQL を使用して、姓名を指定する Name フィールドを作成します。 --->
<cfquery name = "GetAllEmployees" dataSource = "cfdocexamples"
cachedwithin="#createTimeSpan(0,1,0,0)#">
SELECT Emp_ID, EMail, Phone, Department, FirstName, LastName, FirstName +' '
+lastName as Name
FROM Employees
GROUP BY Department, Emp_ID, EMail, Phone, FirstName, LastName, FirstName
</cfquery>
<h2>cfselect の例</h2>
<!-- フォームが送信された場合、cfif ステートメントは true です。
選択した名前を示します。 --->
<cfif IsDefined("form.employeeid")>
<!--- フォームは送信されました。 --->
<h4>次の従業員を選択しました。</h3>
<cfif form.employeeid IS "">
<!--- [すべてを選択] オプションを選択しました。全従業員を表示します。 --->
<cfoutput query="GetAllEmployees">
#name#<br>
Email:#email#<br><br>
</cfoutput>
<cfelse>
<!--- クエリーオブクエリーを使用して、選択したユーザーのデータを取得します。
Form.employeeid は、選択した従業員 ID のカンマ区切りリストです。 --->
<cfquery name = "GetSelectedEmployees" dbtype="query">
SELECT Emp_ID, EMail, Phone, Department, FirstName, LastName, FirstName
+' ' +lastName as Name
FROM GetAllEmployees
WHERE Emp_ID in (#form.employeeid#)
</cfquery>
<!--- クエリーから名前と電子メールアドレスを表示します。 --->
<cfoutput query="GetSelectedEmployees">
#firstName# #lastName#<br>
Email:#email#<br>
<br>
</cfoutput>
</cfif>
</cfif>
<!--- cfform タグで現在のページに戻ります。 --->
<h3>従業員を 1 人以上選択します。</h3>
<cfform action = "#CGI.SCRIPT_NAME#">
<!--- cfselect を使用して、部門別にグループ化された、クエリーの LastName 列を表示します。
複数選択が可能です。--->
<cfselect
name = "employeeid"
size = "15"
multiple="yes"
required = "Yes"
message = "Select one or more employee names"
query = "GetAllEmployees"
group="Department"
display ="name"
value ="emp_id"
queryPosition="Below">
<!--- 全従業員を選択するオプションを追加します。 --->
<option value = "">Select All</option>
</cfselect><br><br>
<input type="Submit">
</cfform>
|
|||||