ラジオ・ボタン・グループ

ユーザーは、ラジオ・ボタンのリストからオプションを 1 つ選択できます。 静的に、またはサービスを使用して、リストにデータを取り込むことができます。

ラジオ・ボタン・グループ・ビューを使用すると、単一選択ビューとは別の方法で、使用可能な項目のリストから項目を 1 つだけ選択することができます。

データ・バインディング

「一般」プロパティーでラジオ・ボタン・グループ・ビューのデータ・バインディングの設定や変更を行います。 ビューは、単純なデータ型 (例えば、文字列、ブール、整数、10 進数) にバインドできます。 バインディングは、選択した値で更新されます。

構成プロパティー

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

画面サイズ
プロパティー名の横に画面サイズ・アイコン 画面サイズ・アイコン がある構成プロパティーは、画面サイズごとに異なる値を持つことができます。 値を設定しない場合、画面サイズはそのデフォルト値として次に大きい画面サイズの値を継承します。
テーマ定義
テーマ定義は、ビューの色およびスタイルを指定し、その外観を決定します。 ビューのルック・アンド・フィールをテーマ・エディターでプレビューできます。 テーマを参照してください。
以下の表に、ラジオ・ボタン・グループ・ビューの外観構成プロパティーをリストします。
表 1. ラジオ・ボタン・グループの外観構成プロパティー
外観構成プロパティー 説明 データ・タイプ
幅 画面サイズ・アイコン ビューの幅です。 幅の単位は px (ピクセル)、% (パーセント)、または em で指定できます。 例えば、50px、20%、または 0.4em のようにします。 単位タイプが指定されていない場合は、px と見なされます。 String
ラベルの配置 画面サイズ・アイコン ビューのラベルの位置。 使用可能なオプションは、LeftおよびRightです。
ラベルの左配置では、ビューの指定された幅が変更されることに注意してください。		 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[]

例

年齢範囲選択用のラジオ・ボタン・グループを UI ページに追加するには、ラジオ・ボタン・グループ・ビューをページのレイアウトに追加し、その構成オプションを以下の例のように設定します。
  1. 「一般」の下で、ラジオ・ボタン・グループのラベル (例えば、 Age range:) を指定します。
  2. 「項目」の下:
    • 「項目ルックアップ・モード」 を Items From Static Listに設定します。
    • 「静的リスト」を展開し、プラス (+) ボタンを使用して、以下の名前と値のペアをリストに追加します。
      名前 値
      25 GB 25 歳以下
      40 40 歳以下
      64百万 64 歳以下
      65 65 歳以上
    • 「外観」の下で、 「幅」 を 200pxに設定し、 「ラベルの配置」 を Topに設定します。
    • 変更内容を保存します。
実行時には、追加されたラジオ・ボタン・グループに、以下の選択可能なオプションが表示されます。
  • 25 歳以下
  • 40 歳以下
  • 64 歳以下
  • 65 歳以上

イベント

「イベント」プロパティーでビューのイベント・ハンドラーの設定や変更を行います。 イベントをプログラムでトリガーするかユーザーがビューと対話したときにトリガーするように設定できます。 イベントを定義およびコーディングする方法については、 ユーザー定義イベントを参照してください。
  • On load: ページのロード時にアクティブ化されます。 例：
    console.log(me.getItemCount())
  • On service items: サービス・フローが項目リストを返すときにアクティブ化されます。 これは、 「項目ルックアップ・モード」 が Items From Serviceに設定されている場合にアクティブになります。 例：
    console.log("RadioButtonGroup1 item service retrieved items successfully")
  • On service error: 選択サービスがエラーを返したときにアクティブ化されます。 これは、 「アイテム・ルックアップ・モード」 が Items From Serviceに設定されている場合にアクティブ化されます。 例：
    me.clearItems()
  • On change: ラジオ・ボタンが選択されている場合など、バインドされたデータが変更されたときにアクティブ化されます。 例：
    ${RadioButtonGroup2}.reloadServiceItems(me.getSelectedIndices())

方法

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

その他のリソース

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