apex:selectList
ユーザが multiselect 属性の値に応じて、1 つの値または複数の値を一度に選択できるようにするオプションのリストです。
このコンポーネントを使用して、sObject の項目に対応しないコントローラメソッドのユーザ入力を取得します。sObject 項目で使用できるのは、<apex:inputfield> と apex:outfield のみです。
このコンポーネントでは、「html-」プレフィックスを使用した HTML パススルー属性がサポートされています。パススルー属性は、生成された <select> タグに適用されます。
例
1<!-- Page: -->
2<apex:page controller="sampleCon">
3 <apex:form>
4 <apex:selectList value="{!countries}" multiselect="true">
5 <apex:selectOptions value="{!items}"/>
6 </apex:selectList><p/>
7
8 <apex:commandButton value="Test" action="{!test}" rerender="out" status="status"/>
9 </apex:form>
10
11 <apex:outputPanel id="out">
12 <apex:actionstatus id="status" startText="testing...">
13 <apex:facet name="stop">
14 <apex:outputPanel>
15 <p>You have selected:</p>
16 <apex:dataList value="{!countries}" var="c">{!c}</apex:dataList>
17 </apex:outputPanel>
18 </apex:facet>
19 </apex:actionstatus>
20 </apex:outputPanel>
21</apex:page>
22
23/*** Controller: ***/
24 public class sampleCon {
25 String[] countries = new String[]{};
26 //If multiselect is false, countries must be of type String
27 //String countries;
28
29 public PageReference test() {
30 return null;
31 }
32
33 public List<SelectOption> getItems() {
34 List<SelectOption> options = new List<SelectOption>();
35 options.add(new SelectOption('US','US'));
36 options.add(new SelectOption('CANADA','Canada'));
37 options.add(new SelectOption('MEXICO','Mexico'));
38 return options;
39 }
40
41 public String[] getCountries() {
42 //If multiselect is false, countries must be of type String
43 return countries;
44 }
45
46 public void setCountries(String[] countries) {
47 //If multiselect is false, countries must be of type String
48 this.countries = countries;
49 }
50 }属性
| 属性名 | 属性型 | 説明 | 必須かどうか | API バージョン | 通用範囲 |
|---|---|---|---|---|---|
| accesskey | String | selectList にフォーカスを置くキーボードのアクセスキー。selectList にフォーカスがあるときに、ユーザはリストのオプションを選択または選択解除できます。 | 10.0 | グローバル | |
| dir | String | 生成された HTML コンポーネントの読み取り方向。可能な値には「RTL」 (右から左) または「LTR」 (左から右) などがあります。 | 10.0 | グローバル | |
| disabled | Boolean | この selectList を無効な状態で表示するかどうかを指定する boolean 値。true に設定すると、selectList が無効な状態で表示されます。指定されていない場合、この値はデフォルトの false に設定されます。 | 10.0 | グローバル | |
| disabledClass | String | disabled 属性が true に設定されている場合に、selectList コンポーネントの表示に使用されるスタイルクラス。主に、外部 CSS スタイルシートを使用するときに適用される CSS スタイルを指定するために使用されます。 | 10.0 | グローバル | |
| enabledClass | String | disabled 属性が false に設定されている場合に、selectList コンポーネントの表示に使用されるスタイルクラス。主に、外部 CSS スタイルシートを使用するときに適用される CSS スタイルを指定するために使用されます。 | 10.0 | グローバル | |
| id | String | ページの他のコンポーネントが selectList コンポーネントを参照できるようにする識別子。 | 10.0 | グローバル | |
| label | String | コントロールの横に表示ラベルを表示し、エラーメッセージ内のコントロールを参照できるようにするテキスト値。 | 23.0 | ||
| lang | String | 「en」または「en-US」など、生成された HTML 出力の基本言語。この属性についての詳細は、W3C 仕様を参照してください。 | 10.0 | グローバル | |
| multiselect | Boolean | ユーザがこの selectList から同時に複数のオプションを選択できるかどうかを指定する boolean 値。true に設定すると、ユーザは同時に複数のオプションを選択できます。指定されていない場合、この値はデフォルトの false に設定されます。multiselect が true の場合、value 属性は string[] 型または文字列の list 型である必要があります。そうでない場合、string 型である必要があります。 | 10.0 | グローバル | |
| onblur | String | onblur イベントが発生した場合 (フォーカスが selectList コンポーネントから離れた場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onchange | String | onchange イベントが発生した場合 (selectList コンポーネントの値が変更された場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onclick | String | onclick イベントが発生した場合 (ユーザが selectList コンポーネントをクリックした場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| ondblclick | String | onclick イベントが発生した場合 (ユーザが selectList コンポーネントをダブルクリックした場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onfocus | String | onfocus イベントが発生した場合 (selectList コンポーネントにフォーカスがある場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onkeydown | String | onkeydown イベントが発生した場合 (ユーザがキーボードのキーを押した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onkeypress | String | onkeypress イベントが発生した場合 (ユーザがキーボードのキーを押したか、押したままにした場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onkeyup | String | onkeyup イベントが発生した場合 (ユーザがキーボードのキーを放した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onmousedown | String | onmousedown イベントが発生した場合 (ユーザがマウスボタンをクリックした場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onmousemove | String | onmousemove イベントが発生した場合 (ユーザがマウスポインタを移動した場合) に呼び出���れる JavaScript。 | 10.0 | グローバル | |
| onmouseout | String | onmouseout イベントが発生した場合 (ユーザが selectList コンポーネントからマウスポインタを移動した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onmouseover | String | onmouseover イベントが発生した場合 (ユーザが selectList コンポーネントにマウスポインタを重ねた場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onmouseup | String | onmouseup イベントが発生した場合 (ユーザがマウスボタンを放した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onselect | String | onselect イベントが発生した場合 (ユーザが selectList コンポーネントのオプションを選択した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| readonly | Boolean | この selectList コンポーネントを参照のみとして表示するかどうかを指定する boolean 値。true に設定すると、リストオプションの選択は変更できません。選択されていない場合、この値はデフォルトの false に設定されます。 | 10.0 | グローバル | |
| rendered | Boolean | コンポーネントをページに表示するかどうかを指定する boolean 値。指定されていない場合、この値はデフォルトの true に設定されます。 | 10.0 | グローバル | |
| required | Boolean | この selectList コンポーネントが必須項目であるかどうかを指定する boolean 値。true に設定された場合、ユーザは、リストオプションを少なくとも 1 つ選択する必要があります。選択されていない場合、この値はデフォルトの false に設定されます。 | 10.0 | グローバル | |
| size | Integer | 同時に表示される selectList オプションの数。この数がオプションの合計数より小さい場合、selectList にスクロールバーが表示されます。指定されていない場合、利用できるすべてのオプションが表示されます。 | 10.0 | グローバル | |
| skipValidationInRepeat | Boolean | 選択された値の検証をスキップするかどうかを指定する boolean 値。繰り返しコンポーネント内にある selectList の値を選択したときに検証エラーが発生する場合は、true に設定します。 | |||
| style | String | selectList コンポーネントの表示に使用されるスタイル。主に、インライン CSS スタイルを追加するために使用されます。 | 10.0 | グローバル | |
| styleClass | String | selectList コンポーネントの表示に使用されるスタイルクラス。主に、外部 CSS スタイルシートを使用するときに適用される CSS スタイルを指定するために使用されます。 | 10.0 | グローバル | |
| tabindex | String | ユーザが Tab キーを繰り返し押したときに、他のページコンポーネントと比較して、この selectList コンポーネントが選択される順序。この値は、ユーザが Tab キーを押したときに選択される最初のコンポーネントを 0 として、0 ~ 32767 の整数である必要があります。 | 10.0 | グローバル | |
| title | String | ユーザがコンポーネントにマウスポインタを重ねたときにツールチップとして表示されるテキスト。 | 10.0 | グローバル | |
| value | Object | この selectList に関連付けられているコントローラクラス変数を参照する差し込み項目。たとえば、コントローラクラスの関連付けられている変数の名前が myListSelections である場合、value="{!myListSelections}" を使用して変数を参照します。multiselect が true の場合、value 属性は string[] 型または文字列の list 型である必要があります。そうでない場合、string 型である必要があります。 | 10.0 | グローバル |