行の追加 (シンプルアクション)

データイテレータに行を動的に追加します。

定義場所

拡張ライブラリ

シンプルアクションのタイプ

基本 (サーバー)

構文

<xe:addRows rowCount="number" for="id" disableId="id" state="true|false" loaded="true|false"></xe:addRows>

表 1. 属性
属性	説明
`disableId="id"`	イテレータの行がなくなった場合に非表示にするコントロールを識別します。通常は、このアクションをアクティブにするコントロールがこれに該当します。
`for="id"`	イテレーターコントロールを識別します。このシンプルアクションが繰り返しコントロール内にネストされている場合は、そのコントロールがデフォルトになります。
`loaded="true\|false"`	コントロールのロード時に、タグインスタンスを作成するかどうか。デフォルトは `true` です。
`rowCount="number"`	追加する行の数。デフォルト値は、イテレータの各ページに表示される行数です。
`state="true\|false"`	AJAX 要求の取得後に、サーバーの状態を保存するかどうか。

例

以下の例は、クリックするたびに 3 行が追加される、データ表の最下部に表示されるボタンを示します。

<xp:dataTable id="dataTable1" rows="10" value="#{javascript:return database.getAllDocuments()}" var="rowdoc">
	<xp:column id="column1">
		<xp:this.facets>
			<xp:label value="subject" id="label1" xp:key="header" style="font-weight:bold"></xp:label>
		</xp:this.facets>
		<xp:text escape="true" id="computedField1">
			<xp:this.value>
				<![CDATA[#{javascript:return rowdoc.getItemValueString("subject")}]]>
			</xp:this.value>
		</xp:text>
	</xp:column>
</xp:dataTable>

<xp:button value="Add 3 rows" id="button1">
	<xp:eventHandler event="onclick" submit="false">
		<xp:this.script>
			<xe:addRows rowCount="3" for="dataTable1" disableId="button1" state="true"></xe:addRows>
		</xp:this.script>
	</xp:eventHandler>
</xp:button>