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

apex:selectList

ユーザが multiselect 属性の値に応じて、1 つの値または複数の値を一度に選択できるようにするオプションのリストです。

このコンポーネントでは、「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            
27        public PageReference test() {
28            return null;
29        }
30            
31        public List<SelectOption> getItems() {
32            List<SelectOption> options = new List<SelectOption>();
33            options.add(new SelectOption('US','US'));
34            options.add(new SelectOption('CANADA','Canada'));
35            options.add(new SelectOption('MEXICO','Mexico'));
36            return options;
37        }
38            
39        public String[] getCountries() {
40            return countries;
41        }
42            
43        public void setCountries(String[] countries) {
44            this.countries = countries;
45        }
46    }

属性

属性名 属性型 説明 必須項目 API バージョン アクセス
accesskey String selectList にフォーカスを置くキーボードのアクセスキー。selectList にフォーカスがあるときに、ユーザはリストのオプションを選択または選択解除できます。 10.0 global
dir String 生成された HTML コンポーネントの読み取り方向。使用可能な値には「RTL」(右から左) または「LTR」(左から右) があります。 10.0 global
disabled Boolean この selectList を無効な状態で表示するかどうかを指定する boolean 値。true に設定すると、selectList が無効な状態で表示されます。指定されていない場合、この値はデフォルトの false に設定されます。 10.0 global
disabledClass String disabled 属性が true に設定されている場合に、selectList コンポーネントの表示に使用されるスタイルクラス。主に、外部 CSS スタイルシートを使用するときに適用される CSS スタイルを指定するために使用されます。 10.0 global
enabledClass String disabled 属性が false に設定されている場合に、selectList コンポーネントの表示に使用されるスタイルクラス。主に、外部 CSS スタイルシートを使用するときに適用される CSS スタイルを指定するために使用されます。 10.0 global
id String ページの他のコンポーネントが selectList コンポーネントを参照できるようにする識別子。 10.0 global
label String コントロールの横に表示ラベルを表示し、エラーメッセージ内のコントロールを参照できるようにするテキスト値。 23.0
lang String 「en」または「en-US」など、生成された HTML 出力の基本言語。この属性についての詳細は、W3C 仕様を参照してください。 10.0 global
multiselect Boolean ユーザがこの selectList から同時に複数のオプションを選択できるかどうかを指定する boolean 値。true に設定すると、ユーザは同時に複数のオプションを選択できます。指定されていない場合、この値はデフォルトの false に設定されます。multiselect が true の場合、value 属性は string[] 型または文字列の list 型である必要があります。���うでない場合、string 型である必要があります。 10.0 global
onblur String onblur イベントが発生した場合 (フォーカスが selectList コンポーネントから離れた場合) に呼び出される JavaScript。 10.0 global
onchange String onchange イベントが発生した場合 (selectList コンポーネントの値が変更された場合) に呼び出される JavaScript。 10.0 global
onclick String onclick イベントが発生した場合 (ユーザが selectList コンポーネントをクリックした場合) に呼び出される JavaScript。 10.0 global
ondblclick String onclick イベントが発生した場合 (ユーザが selectList コンポーネントをダブルクリックした場合) に呼び出される JavaScript。 10.0 global
onfocus String onfocus イベントが発生した場合 (selectList コンポーネントにフォーカスがある場合) に呼び出される JavaScript。 10.0 global
onkeydown String onkeydown イベントが発生した場合 (ユーザがキーボードのキーを押した場合) に呼び出される JavaScript。 10.0 global
onkeypress String onkeypress イベントが発生した場合 (ユーザがキーボードのキーを押したか、押したままにした場合) に呼び出される JavaScript。 10.0 global
onkeyup String onkeyup イベントが発生した場合 (ユーザがキーボードのキーを放した場合) に呼び出される JavaScript。 10.0 global
onmousedown String onmousedown イベントが発生した場合 (ユーザがマウスボタンをクリックした場合) に呼び出される JavaScript。 10.0 global
onmousemove String onmousemove イベントが発生した場合 (ユーザがマウスポインタを移動した場合) に呼び出される JavaScript。 10.0 global
onmouseout String onmouseout イベントが発生した場合 (ユーザが selectList コンポーネントからマウスポインタを移動した場合) に呼び出される JavaScript。 10.0 global
onmouseover String onmouseover イベントが発生した場合 (ユーザが selectList コンポーネントにマウスポインタを重ねた場合) に呼び出される JavaScript。 10.0 global
onmouseup String onmouseup イベントが発生した場合 (ユーザがマウスボタンを放した場合) に呼び出される JavaScript。 10.0 global
onselect String onselect イベントが発生した場合 (ユーザが selectList コンポーネントのオプションを選択した場合) に呼び出される JavaScript。 10.0 global
readonly Boolean この selectList コンポーネントを参照のみとして表示するかどうかを指定する boolean 値。true に設定すると、リストオプションの選択は変更できません。選択されていない場合、この値はデフォルトの false に設定されます。 10.0 global
rendered Boolean コンポーネントをページに表示するかどうかを指定する boolean 値。指定されていない場合、この値はデフォルトの true に設定されます。 10.0 global
required Boolean この selectList コンポーネントが必須項目であるかどうかを指定する boolean 値。true に設定された場合、ユーザは、リストオプションを少なくとも 1 つ選択する必要があります。選択されていない場合、この値はデフォルトの false に設定されます。 10.0 global
size Integer 同時に表示される selectList オプションの数。この数がオプションの合計数より小さい場合、selectList にスクロールバーが表示されます。指定されていない場合、利用できるすべてのオプションが表示されます。 10.0 global
style String selectList コンポーネントの表示に使用されるスタイル。主に、インライン CSS スタイルを追加するために使用されます。 10.0 global
styleClass String selectList コンポーネントの表示に使用されるスタイルクラス。主に、外部 CSS スタイルシートを使用するときに適用される CSS スタイルを指定するために使用されます。 10.0 global
tabindex String ユーザが Tab キーを繰り返し押したときに、他のページコンポーネントと比較して、この selectList コンポーネントが選択される順序。この値は、ユーザが Tab キーを押したときに選択される最初のコンポーネントを 0 として、0 ~ 32767 の整数である必要があります。 10.0 global
title String ユーザがコンポーネントにマウスポインタを重ねたときにツールチップとして表示されるテキスト。 10.0 global
value Object この selectList に関連付けられているコントローラクラス変数を参照する差し込み項目。たとえば、コントローラクラスの関連付けられている変数の名前が myListSelectionsである場合、value="{!myListSelections}" を使用して変数を参照します。multiselect が true の場合、value 属性は string[] 型または文字列の list 型である必要があります。そうでない場合、string 型である必要があります。 10.0 global