<singleSelection>要素 |
![]() |
ネームスペース: | http://xmlns.oracle.com/uix/ui |
派生元: | <ui:base>要素 |
グループ: | UIX Components |
要素の型: | UINode |
構文 |
![]() |
<singleSelection
[ disabled="boolean"
]
[ selectedIndex="unsignedInt"
]
[ text="string"
] >
<contents> <!-- indexed children --> </contents>
</singleSelection>
説明 |
![]() |
<singleSelection>要素は、TableBeanに単一選択を提供します。TableBeanのコンテキストにおいてのみ有効で、TableBeanで初期化し、tableSelectionプロパティとして設定する必要があります。複数選択の表には、かわりにMultipleSelectionBeanを使用します。 表にSingleSelectionBeanを追加すると、(Oracle UIガイドラインに基づいて)Tableに選択列がレンダリングされ、表のコンテンツのまわりにコントロール・バーがレンダリングされます。選択は、表内にレンダリングされたラジオ・ボタン列により表されます。クライアントでの追加の作業は必要ありません。 Tableの上および下にレンダリングされるコントロール・バーは、Table内にSingleSelectionBeanがある場合に自動的に表示されます。コントロール・バーに表示されるテキストは、SingleSelectionBeanのtextプロパティの値です。さらに、SingleSelectionBeanの索引付けされた子が、右側のコントロール・バー内にレンダリングされます。これらのプロパティによって、クライアントはOracle UIガイドラインで指定されているコントロール・バーを容易に作成できます。ここには、たとえば、選択された行に対して機能するボタンと、それに対する説明テキストを追加したりすることができます。 SingleSelectionBeanの初期選択状態は、selectedIndexプロパティにより指定されます。これは、初期状態で選択される表の行を示すゼロから始まる索引か、またはselectedIndexBindingプロパティで設定されたキーを使用して取得できるバインド整数のいずれかに設定します。 選択内の行は使用不可にできます。これによって、行は選択できなくなります。これを行うには、単にdisabledプロパティがtrueを返すよう設定します。ただし、ほとんどの場合、選択不可にする必要があるのは特定の行のみです。この場合は、使用不可にするDataObject行に対してtrueを返すdisabledプロパティをバインドします。使用不可の状態を問い合されるDataObjectは、表のデータ・コンテンツDataObjectListです。 ユーザーの選択結果は、行およびこれが含まれている表名に基づくフォーム要素によりページ内に格納されます。これにより、staticメソッドgetSelectedIndex()を使用し、フォーム送信時にユーザーが選択した行を容易に判断できます。クライアントはServletRequestおよびTableBeanの名前を使用してServletRequestDataSetを作成し、そのDataSetによりgetSelectedIndex()をコールすることで、選択されたゼロから始まる行番号を取得できます。
選択領域の外観
初期状態での選択
選択の使用不可
選択の結果
例 |
![]() |
次の例では、3行目があらかじめ選択されています。
<table ...>
<tableSelection>
<singleSelection text="Select an item and ..." selectedIndex="2">
<contents>
<submitButton text="Copy"/>
</contents>
</singleSelection>
</tableSelection>
</table>
属性 |
![]() |
|
子要素 |
![]() |
|