チェック・ボックス・グループ

チェック・ボックスのリストから複数のオプションを選択できます。 静的に、またはサービスを使用して、リストにデータを取り込むことができます。

データ・バインディング

「一般」プロパティーでチェック・ボックス・グループのデータ・バインディングの設定や変更を行います。 チェック・ボックス・グループ・ビューのバインディングは、 ANY (ANY []) のリストとして定義されます。これは、ユーザーが選択したチェック・ボックスを表しますが、実際には、バインディングは、名前と値のプロパティーを持つオブジェクトのようなストリングのリストまたは NameValueペアのリストのいずれかでなければなりません。

構成プロパティー

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

画面サイズ
プロパティー名の横に画面サイズ・アイコン 画面サイズ・アイコン がある構成プロパティーは、画面サイズごとに異なる値を持つことができます。 値を設定しない場合、画面サイズはそのデフォルト値として次に大きい画面サイズの値を継承します。
テーマ定義
テーマ定義は、ビューの色およびスタイルを指定し、その外観を決定します。 ビューのルック・アンド・フィールをテーマ・エディターでプレビューできます。 テーマを参照してください。
以下の表に、チェック・ボックス・グループの外観構成プロパティーをリストします。
表 1. チェック・ボックス・グループの外観構成プロパティー
外観構成プロパティー 説明 データ・タイプ
幅 画面サイズ・アイコン チェック・ボックス・グループ・ビューの幅を指定します。

幅の単位は px (ピクセル)、% (パーセント)、または em で指定できます。 例えば、 50px、 20%、または 0.4emです。 単位タイプが指定されていない場合は、px とみなされます。

 String
ラベルの配置 画面サイズ・アイコン ラベルの配置場所を指定します。 使用可能なオプションは、TopおよびLeftです。
ラベルを左側に配置すると、指定されたビューの幅が変わることにご注意ください。		 String
ラベルの幅 大画面アイコン ラベルの幅です。 幅の単位は px (ピクセル)、% (パーセント)、または em で指定できます。 例えば、50px、20%、または 0.4em のようにします。 単位タイプが指定されていない場合は、px と見なされます。 String
検証マーカーの表示 ビューが無効な場合は、検証アイコンと境界線を表示します。 Boolean
以下の表に、チェック・ボックス・グループの項目構成プロパティーをリストします。
表 2. チェック・ボックス・グループの項目構成プロパティー
項目構成プロパティー 説明 データ・タイプ
項目ルックアップ・モード ユーザーが選択できる項目のリストにデータを取り込むために使用される方式。 注: 必ず正しいオプションを選択してください。そうしないと、リストに正しくデータが取り込まれません。
空で開始
以下を使用して、プログラムで選択リストにデータを取り込みます。appendItem(value, displayText)メソッド。
サービスからの項目
選択リストには、「リスト項目サービス」オプションで指定されたサービスからデータが取り込まれます。
静的リストからの項目
選択リストには、「静的リスト」オプションに入力されたプロパティーによりデータが取り込まれます。
構成オプションからの項目
選択リストには、「項目入力データ」オプションで指定されたビジネス・オブジェクト・リストからデータが取り込まれます。
 String
リスト項目サービス 選択リストに表示される項目のリストにデータを取り込むために使用されるサービス。 このサービスは、項目ルックアップ・モードが「サービスからの項目」の場合に使用されます。 このサービスは、「サービスの入力データ」ビジネス・オブジェクトによって提供されたデータに基づいて選択リストを提供する、適切な Ajax アクセスを伴うサービス・フローです。 このオプションは、ビューをリスト・オブジェクトにバインドする代わりの方法として使用できます。
ヒント: リスト項目サービスでは、 dataという名前の string 型の入力変数と、ビューにバインドされたデータとして結果を出力する resultsという名前の list 型の出力変数の 2 つの変数を使用します。 リスト項目サービスの出力変数名が results ではない場合、使用できるようになる値はありません。
 AJAX Service
サービスの入力データ 選択リストへのデータ取り込みに使用するサービス・フローに渡される、入力データを提供するビジネス・オブジェクト。 このオプションは、項目ルックアップ・モードが「サービスからの項目」の場合に使用されます。 ANY
入力データの変化を無視 サービス入力データの変更時に自動サービス呼び出しを使用不可にします。 このオプションが使用されるのは、「項目ルックアップ・モード」が「サービスからの項目」に設定されたときのみです。 Boolean
項目入力データ 選択リストにデータを取り込むビジネス・オブジェクト・リスト。 このプロパティーは、項目ルックアップ・モードが「構成オプションからの項目」の場合にのみ使用されます。 ANY[]
項目選択データ

 「表示プロパティー」フィールドで、選択リストに表示されるビジネス・オブジェクトのプロパティーを設定します。 データ・マッピング・プロパティーに値が指定されていない場合、デフォルト値は、 「値」プロパティーの場合は name 、 「表示プロパティー」の場合は value になります。 String
  • オプション値プロパティー: String
  • オプションの表示プロパティー: String
静的リスト 選択リストにデータを設定するための項目の静的リスト。 このオプションは静的リストに対してのみ使用します。 このオプションに変数を指定しないでください。 変数リストの場合は、「構成オプションからの項目」ルックアップ・モードを使用します。 NameValuePair[]

例

例えば、職場で必要となる事務用品を、指定された期間にわたって追跡する在庫表を作成するとします。 この在庫表では、事務用品がチェック・ボックス付きの項目リストとして表され、ユーザーはどの事務用品が必要なのかに基づいて、このチェック・ボックスを選択またはクリアします。 チェック・ボックス・リストをページに追加するには、ページのレイアウトにチェック・ボックス・グループ・ビューを追加し、次にこのビューの構成オプションを以下のように設定します。
  1. 「一般」の下で、チェック・ボックス・グループの名前 (例えば、 Needed office supplies:) を指定します。
  2. 「項目」の下:
    • 「項目ルックアップ・モード」 を Items From Static Listに設定します。
    • 「項目リスト」下で「静的リスト」を展開表示し、プラス (+) ボタンを使用して以下の名前と値のペアをリストに追加します。
      名前 値
      1 メモ帳
      2 ペン
      3 プリンターのインク
      4 ファイル・フォルダー
    • 「外観」の下で、 「幅」 を 350pxに設定し、 「ラベルの配置」 を Leftに設定します。
    • 変更内容を保存します。
実行時には、以下の項目で構成される事務用品カテゴリーのリストが表示されます。 このリストでは、同時に 1 つまたは複数の項目を選択できます。
  • メモ帳
  • ペン
  • プリンターのインク
  • ファイル・フォルダー

イベント

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

  • On load: ページのロード時にアクティブ化されます。 例：
    console.log(me.getItemCount())
  • On service items: サービス・フローが項目リストを返すときにアクティブ化されます。 これは、 「項目ルックアップ・モード」 が Items From Serviceに設定されている場合にアクティブになります。 例：
    console.log("CheckboxGroup1 item service retrieved items successfully")
  • On service error: 選択サービスがエラーを返したときにアクティブ化されます。 これは、 「アイテム・ルックアップ・モード」 が Items From Serviceに設定されている場合にアクティブ化されます。 例：
    me.clearItems()
  • On change: バインドされたデータの変更時 (チェック・ボックス・ボタンが選択されている場合など) にアクティブ化されます。 例：
    ${CheckboxGroup2}.reloadServiceItems(me.getSelectedIndices())

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

方法

チェック・ボックス・グループに使用できるメソッドの詳細情報については、 チェック・ボックス・グループ JavaScript API を参照してください。

その他のリソース

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