複数選択

ユーザーは、項目のリストから複数の項目を一度に選択できます。

データ・バインディング

「構成」プロパティーでビューのデータ・バインディングの設定や変更を行います。 このビューは ANY (List) タイプにバインドできます。

構成プロパティー

「構成」で、ビューの外観および動作プロパティーを設定または変更します。

画面サイズ
プロパティー名の横に画面サイズ・アイコン 画面サイズ・アイコン がある構成プロパティーは、画面サイズごとに異なる値を持つことができます。 値を設定しない場合、画面サイズはそのデフォルト値として次に大きい画面サイズの値を継承します。
テーマ定義
テーマ定義は、ビューの色およびスタイルを指定し、その外観を決定します。 ビューのルック・アンド・フィールをテーマ・エディターでプレビューできます。 テーマを参照してください。
以下の表に、複数選択ビューの外観構成プロパティーを示します。
表 1. 複数選択の外観構成プロパティー
外観構成プロパティー 説明 データ・タイプ
幅画面サイズ・アイコン ビューの幅です。 幅の単位は px (ピクセル)、% (パーセント)、または em で指定できます。 例えば、50px、20%、または 0.4em のようにします。 単位タイプが指定されていない場合は、px と見なされます。 String
サイズ 画面サイズ・アイコン ビュー内のテキストのサイズ、ラベル・テキストのサイズ、およびテキストの周囲の埋め込みの量。 例えば、スマートフォンでテキストとラベルをより読みやすくするには、この構成オプションを Large に設定して、小さい画面サイズを補正することができます。 String
ラベルの配置 画面サイズ・アイコン ビューのラベルの配置場所。 String
ラベルの幅 大画面アイコン ラベルの幅です。 幅の単位は px (ピクセル)、% (パーセント)、または em で指定できます。 例えば、50px、20%、または 0.4em のようにします。 単位タイプが指定されていない場合は、px と見なされます。 String
検証マーカーの表示 ビューが無効な場合は、検証アイコンと境界線を表示します。 Boolean
以下の表に、複数選択ビューの動作構成プロパティーを示します。
表 2. 複数選択の動作構成プロパティー
動作構成プロパティー 説明 データ・タイプ
タブ・インデックス タブ・シーケンスのインデックス。 タブのインデックスは 1 から始まり、スパースに設定することができます。 例えば、1、5、10 などと指定できます。 Integer
以下の表に、複数選択ビューの項目構成プロパティーを示します。
表 3. 複数選択の項目構成プロパティー
項目構成プロパティー 説明 データ・タイプ
項目ルックアップ・モード ユーザーが選択できる項目のリストにデータを取り込むために使用される方式。 注: 必ず正しいオプションを選択してください。そうしないと、リストに正しくデータが取り込まれません。
空で開始
以下を使用して、プログラムで選択リストにデータを取り込みます。appendItem(value, displayText)メソッド。
サービスからの項目
選択リストには、「リスト項目サービス」オプションで指定されたサービスからデータが取り込まれます。
静的リストからの項目
選択リストには、「静的リスト」オプションに入力されたプロパティーによりデータが取り込まれます。
構成オプションからの項目
選択リストには、「項目入力データ」オプションで指定されたビジネス・オブジェクト・リストからデータが取り込まれます。
 String
リスト項目サービス 選択リストに表示される項目のリストにデータを取り込むために使用されるサービス。 このサービスは、項目ルックアップ・モードが「サービスからの項目」の場合に使用されます。 このサービスは、「サービスの入力データ」ビジネス・オブジェクトによって提供されたデータに基づいて選択リストを提供する、適切な Ajax アクセスを伴うサービス・フローです。 このオプションは、ビューをリスト・オブジェクトにバインドする代わりの方法として使用できます。
ヒント: リスト項目サービスでは、 dataという名前の string 型の入力変数と、ビューにバインドされたデータとして結果を出力する resultsという名前の list 型の出力変数の 2 つの変数を使用します。 リスト項目サービスの出力変数名が results ではない場合、使用できるようになる値はありません。
 サービス・フロー
サービスの入力データ 選択リストへのデータ取り込みに使用するサービス・フローに渡される、入力データを提供するビジネス・オブジェクト。 このオプションは、項目ルックアップ・モードが「サービスからの項目」の場合に使用されます。 任意
入力データの変化を無視 サービス入力データの変更時に自動サービス呼び出しを使用不可にします。 このオプションが使用されるのは、「項目ルックアップ・モード」が「サービスからの項目」に設定されたときのみです。 Boolean
項目入力データ 選択リストにデータを取り込むビジネス・オブジェクト・リスト。 このプロパティーは、項目ルックアップ・モードが「構成オプションからの項目」の場合にのみ使用されます。 任意 []
項目選択データ 「表示プロパティー」フィールドで、選択リストに表示されるビジネス・オブジェクトのプロパティーを設定します。 データ・マッピング・プロパティーに値が指定されていない場合、デフォルト値は、 「値」プロパティーの場合は name 、 「表示プロパティー」の場合は value になります。 
SelectDataMapping
ビジネス・データの出力 ビューが複合型にバインドされている場合は、ユーザーが選択するプロパティーが、「表示プロパティー」で指定されたプロパティーおよびビューにバインドされているプロパティーに渡されます。 
SelectDataMapping
静的リスト 選択リストにデータを設定するための項目の静的リスト。 このオプションは静的リストに対してのみ使用します。 このオプションに変数を指定しないでください。 変数リストの場合は、「構成オプションからの項目」ルックアップ・モードを使用します。 NameValuePair[]

例: 静的リストからの項目

Grocery list というラベルの複数選択ビューがあり、選択した 「項目ルックアップ・モード」 が 「静的リストからの項目」であるとします。 「静的リスト」では、以下の名前と値のペアが定義されています。
表 4。 静的リスト
名前 値
1 牛乳
2 パン
3 バナナ
4 米
以下の結果が表示されます。

例: ビジネス・オブジェクトを使用した項目へのデータの取り込み

この例では、Customer ビジネス・オブジェクトを使用して、選択リストの名のリストにデータを取り込みます。 ユーザーが複数の名前を選択すると、対応するレコードがテーブルに表示されます。

Customer ビジネス・オブジェクトの構造を以下に示します。
  • String 型のパラメーター。
  • String 型のパラメーター。
  • String 型のパラメーター。
Customer ビジネス・オブジェクトのデフォルト値を以下に示します。
var autoObject = [];
autoObject[0] = {};
autoObject[0].ID = "000";
autoObject[0].firstName = "Pierre";
autoObject[0].lastName = "de Fermat";
autoObject[1] = {};
autoObject[1].ID = "001";
autoObject[1].firstName = "Isaac";
autoObject[1].lastName = "Newton";
autoObject[2] = {};
autoObject[2].ID = "002";
autoObject[2].firstName = "John";
autoObject[2].lastName = "Venn";
autoObject

クライアント・サイド・ヒューマン・サービスには、タイプのプライベート変数 outputList があります。 出力タイプには 2 つのストリング・パラメーターがあります。 複数選択ビューは、ビューのデータ出力が格納される outputList にバインドされます。

ページに含まれる複数選択ビューには、次のプロパティーがあります。
  • 「一般」の下で、 「バインディング」 を outputListに設定します。
  • 「構成」 > 「項目」で、 「項目ルックアップ・モード」 を以下のように設定します。
  • 「構成」 > 「項目」で、 「項目入力データ」 を以下のように設定します。
  • 「構成」 > 「項目」 > 「項目選択データ」の下で、以下のようにします。
    • 「値プロパティー」には、指定します。
    • 「表示プロパティー」には、次のように指定します。
  • 「構成」 > 「項目」 > 「ビジネス・データの出力」の下で、以下のようにします。
    • 「値プロパティー」には、指定します。
    • 「表示プロパティー」には、次のように指定します。
テーブル・ビューには、以下のプロパティーがあります。
  • タイトル付きの 2 つの列
  • 「一般」の下で、 Label が設定されます。
  • 「一般」の下で、 「バインディング」 が次のように設定されます。
ヒント: 表を素早く作成するには、 outputList 変数をページ上にドラッグします。
実行時の結果は次のようになります。
これは、複数の選択を行った後の結果です。
選択した値は Value2 列に表示されます。これは、 「出力ビジネス・データ」の下の 「表示プロパティー」 オプションで指定されているプロパティーです。 このプロパティーは、値によって渡されます。 「表示プロパティー」として入力すると、選択した名前が Value1 列に表示されます。

イベント

「イベント」プロパティーでビューのイベント・ハンドラーの設定や変更を行います。 イベントをプログラムでトリガーするかユーザーがビューと対話したときにトリガーするように設定できます。 イベントを定義およびコーディングする方法については、 ユーザー定義イベントを参照してください。

複数選択ビューには以下のタイプのイベント・ハンドラーがあります。

  • : ページのロード時にアクティブ化されます。 例：

  • : バインドされたデータが変更されたときにアクティブ化されます。 例：

  • : サービス・フローが項目リストを返したときにアクティブ化されます。 「項目ルックアップ・モード」が「サービスからの項目」に設定されている場合にのみアクティブ化されます。

  • : サービス・フローがサービス・エラーを返したときにアクティブ化されます。 「項目ルックアップ・モード」が「サービスからの項目」に設定されている場合にのみアクティブ化されます。

特定のイベントによっては、JavaScript ロジックを使用してビューの効果を変更できます。 ビューを使用したイベントの使用について詳しくは、トピック「 ユーザー定義イベント」を参照してください。

方法

複数選択に使用できるメソッドの詳細情報については、 複数選択 JavaScript API を参照してください。

その他のリソース

Coach またはページの作成方法については、 Coach の作成を参照してください。
標準プロパティー (「一般」、 「構成」、 「位置決め」、 「可視性」、および 「HTML 属性」) について詳しくは、 「プロパティーの表示」を参照してください。