pager - ページャ

コンテナコントロールのデータが 1 つのウィンドウに表示できない場合に、データを複数のページに分けます。

カテゴリ

コアコントロール

構文

<xp:pager attributes>
	<xp:pagerControl attributes></xp:pagerControl> <!--ページスタイルがカスタムの場合-->
content</xp:pager>
表 1. 必須プロパティ
プロパティ 説明
id (pager) デフォルトは pager1、pager2 などです。

(pagerControl) デフォルトは pagerControl1、pagerControl2 などです。
layout (pager) コントロールをレイアウトするには、このプロパティを使用するか、pagerControl コントロールを埋め込みます。
for (pager) ページャがターゲットコントロール内にないと きのみ使用します。
type (pagerControl) このタイプは、ページャの[ページャスタイル] に、 [カスタム] を使用した場合に生成されます。
表 2. すべてのプロパティ (pager)
カテゴリ プロパティ
アクセシビリティ ariaLabel、role、title
注: この role プロパティは 9.0.1 から廃止されています。デフォルトでは、適切な準拠値が生成されます。アクセシビリティ標準に準拠するには、このプロパティに値を指定しないでください。
basics attrs、alwaysCalculateLast、binding、dir、for、id、lang、loaded、pageCount、partialExecute、partialRefresh、rendered、rendererType
format layout、panelPosition
styling disableTheme、outerStyleClass、 style、styleClass、 themeId
表 3. すべてのプロパティ (pagerControl)
カテゴリ プロパティ
アクセシビリティ accesskey、alt、role、tabindex、title
注: この role プロパティは 9.0.1 から廃止されています。デフォルトでは、適切な準拠値が生成されます。アクセシビリティ標準に準拠するには、このプロパティに値を指定しないでください。
basics binding、dir、id、lang、loaded、rendered、rendererType、type、value
イベント action、actionListener、actionListeners、immediate、onblur、onclick、ondblclick、onfocus、onkeydown、onkeypress、onkeyup、onmousedown、onmousemove、onmouseout、onmouseover、onmouseup
format image
styling currentStyleClass、disableTheme、firstStyleClass、lastStyleClass、style、styleClass、themeId

使用法

実行時に、ユーザーはページャをクリックして、コントロール内でデータを繰り返すことができます。これによって、ビューパネルなどのデータ反復が可能になります。

ページャは、データのあるコントロール内のファセットリージョンに置くことができます。 あるいは、ページャを for プロパティによって、データコントロールと関連付けることもできます。

ページャコントロールは、以下の 2 とおりの方法で生成されます。
  • レイアウトプロパティを指定します。 設計モードで、[プロパティ] の下のトップタブをクリックし、 [ページャスタイル] として [サンプル] オプションからいずれか 1 つを選択します。
  • pagerControl コントロールを埋め込みます。 設計モードで、[プロパティ] の下のトップタブをクリックし、 [ページャスタイル] として [カスタム] を選択します。

例

このビューパネルコントロールには、ページャコントロールが含まれています。
<xp:viewPanel rows="30" id="viewPanel1">
	<xp:this.facets>
		<xp:pager partialRefresh="true"
			layout="Previous Separator Group Separator Next"
			xp:key="headerPager" id="pager1">
		</xp:pager>
	</xp:this.facets>
	<xp:this.data>
		<xp:dominoView var="view2" viewName="main"></xp:dominoView>
	</xp:this.data>
	<xp:viewColumn columnName="subject" id="viewColumn1">
		<xp:viewColumnHeader value="subject"
			id="viewColumnHeader1">
		</xp:viewColumnHeader>
	</xp:viewColumn>
	<xp:viewColumn columnName="fruit" id="viewColumn2">
		<xp:viewColumnHeader value="fruit" id="viewColumnHeader2"></xp:viewColumnHeader>
	</xp:viewColumn>
</xp:viewPanel>
親トピック: コントロールの参照