この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

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 グローバル