db、ftsearch、または view タグの結果に対してページ付けのコントロールを提供します。ボディが 1 度評価され、ヘッダーの後に viewloop タグ (view のコンテキストで) または docloop タグ (すべてのコンテキストで) があることが想定されます。ページからページへの移動は、pagefirst、pagelast、pagenext、pageprev、および pagebar タグを使用して行います。

コンテキスト

次のタグで有効です。

db、view、ftsearch、responses

docloop、viewloop、pagebar、pagenext、pageprev、pagefirst、pagelast、novalues

<domino:page
id="name of object variable"
start="page number to start at"
rows="number of entries rendered per page"
direction="ASC|DSC|Ascending|Descending"
max="maximum number of pages to display"
evaluateonnorows="true|false"
viewasdocuments="true|false"
name="name of page parameter storing current page number"
debug="true|false"
onfailure="inline|exception"
time="true|false">

次の属性は、省略可能です。

direction

結果の繰り返しの方向を指定します。次のいずれかの文字を指定します。

ASC、DSC、Ascending、Descending

デフォルトは Ascending です。

結果に行がない場合に、ボディを評価するかを指定します。これによって、page タグを novalues タグとともに使用し、行がない場合にヘッダーが表示されるのを防ぐことができます。デフォルトは true です。

id 名を指定する場合は、関連する lotus.domino.taglib.PageInfo オブジェクトを含む変数が作成されます。作成される変数は、page タグのボディ内でのみ有効です。指定されない場合は、PageInfo オブジェクトにプログラムを使用してアクセスすることはできません。

表示するページの最大数。すべてのエントリを表示するためにこれ以上のページが必要な場合、ページに収まらなかった分のエントリは表示されません。指定されたページ最大数以上のページを移動することはできません。デフォルトでは、すべてのページが表示されます。

現在のページ番号に保存されるページパラメータの名前。同じ JSP に複数の page タグを含めるには、2 番目以降の page タグはこの属性を指定する必要があります。指定されない場合は、例外がスローされます。

メモ この値は、最初の page タグが実行される前に、preserve タグの name 属性で指定される必要があります。指定されないと、ページ番号が正しく保存されません。1 つの JSP に複数の page タグが存在する場合は、JSP エンジンは、各 page タグに対して preserve タグが存在するかを確認し、ない場合は例外をスローします。1 つの preserve タグを使用して複数の page タグを保存するには、複数のページに対して、この name 属性で使用する名前と同じ名前を使用します。

デフォルトの名前は「page」です。

1 ページに取り込むエントリの数。デフォルトは 10 です。この属性に -1 を渡すと、残りのすべてのオブジェクトが表示されます。

ページ番号を開始番号にします。デフォルトは 1 です。

メモ この属性はページのナビゲーションタグに優先します。

view タグのコンテキストで使用されるページが文書を繰り返すか、ビューエントリを繰り返すかを示す論理値。この属性は、正しいページ番号が表示されるように、docloop または viewloop タグが表示される前に決定される必要があります。view タグ以外のコンテキストで page タグが使用される場合は、この属性は無視されます。デフォルトは false で、各行は ViewEntry オブジェクトとして取り扱われます。

インターフェース

JSP ページの現在の状態を確認するのに、次のインターフェースを使用できます。

public interface PageInfo {

// Get the current page being processed.

public abstract int getPage();

// Returns the total number of pages for this collection

// (not expensive)

public abstract int getPageCount();

// Returns TRUE if the current page is the first page

public abstract boolean isFirstPage();

// Returns TRUE if the current page is the last page

public abstract boolean isLastPage();

// Returns TRUE if the current page is the only page

public abstract boolean isOnlyPage();

// Returns TRUE if the current page is blank

// (isFirstPage() should be TRUE)

public abstract boolean isEmptyPage();

}

Domtags タグライブラリ

用語集