<addTableRow>要素
ネームスペース:  http://xmlns.oracle.com/uix/ui
派生元:  <ui:base>要素
グループ:  UIX Components
要素の型:  UINode

<addTableRow>要素は、表の列フッターへのadd-table-rowコントロールの追加に使用します。 このBeanは、エージェントのタイプがPDAの場合にはサポートされません。

構文
<addTableRow
    [ destination="anyURI" ]
    [ rows="unsignedInt" ]
    [ text="string" ]
>
   <contents> <!-- indexed children --> </contents>
</addTableRow>

注意: 
  • この要素は派生元要素のすべての属性と子要素を持つことができます。

  • 説明

    AddTableRowBeanをTableBean内で使用すると、特殊なTableRowがレンダリングされ、ユーザーはボタンをクリックして1行以上のデータを追加できます。AddTableRowBeanを使用するには、TableBeanのcolumnFooterの子として設定します。

    クライアントがAddTableRowBeanに対して行えるカスタマイズは2種類あります。まず、ボタンのテキストをカスタマイズできます。デフォルトでは、ボタンに「1行追加」と表示されます。ただし、AddTableRowBeanのrowsプロパティを1より大きい値に設定した場合、ボタンには「X行追加」(Xは行数)と表示されます。必要に応じて、クライアントはtextプロパティを任意のテキストに設定することにより、ボタンのテキストを変更できます。

    もう1つのカスタマイズは、クリックしたときのボタンのリンク先です。デフォルトでは、リンク先は、フォーム送信またはURL引数のいずれかが使用されます。これは、親表でどちらをオンにするかによって決まります。フォーム送信を使用する場合は、eventフォームの値をaddRowsに、sourceフォームの値を表名に、sizeフォームの値を追加する行数にそれぞれ設定した表のフォームが、AddTableRowBeanにより送信されます。URL引数を使用する場合は、同じ3つのキーおよび値がパラメータとして送信されます。詳細は、TableBeanのドキュメントを参照してください。

    標準のリンク先が適切でない場合、クライアントはAddTableRowBeanのdestinationプロパティを任意の値に設定することにより、リンク先をオーバーライドできます。

    また、表で行を追加する機能と列を合計する機能の両方が必要な場合、クライアントはAddTableRowBeanTotalRowBeanを組み合せて使用できます。これを行うには、両方のBeanを作成および構成し、TotalRowBeanAddTableRowBeanの索引付けされた子として追加します。次に、AddTableRowBeanを通常どおりcolumnFooterの子として追加します。


    <table ...>
     <columnFooter>
      <addTableRow/>
     </columnFooter>
    </table>

    属性

    説明
    destination このボタンが参照するURI。
    URI
    rows 追加する行数。
    unsignedInt
    text ボタンに表示するテキスト。
    string

    子要素

    説明 必須 組込み可能な数
    <contents> Beanの索引付けされた子。 いいえ 1