Home   Single Page

ページング

ページングコンポーネントは長いコンテンツを多数のページに分けます。例えば、100の項目があるとして、一度に20項目表示するとしたら、以下のようにページングコンポーネントを使用します。

<paging totalSize="100" pageSize="20"/>

ユーザーがhyperlinksをクリックした時、onPagingイベントとorg.zkoss.zul.event.PagingEvent のインスタンスはページングコンポーネントに送信されます。100項目のうちのどの項目を見せるかを決めるために、リスナをページングコンポーネントに付加します。

<paging id="paging"/><zscript>List result = new SearchEngine().find("ZK");//assume SearchEngine.find() will return a list of items.paging.setTotalSize(result.size());paging.addEventListener("onPaging", new EventListener() {public void onEvent(Event event) {int pgno = event.getPaginal().getActivePage();int ofs = pgno * event.getPaginal().getPageSize();new Viewer().redraw(result, ofs, ofs + event.getPaginal().getPageSize() - 1);//assume redraw(List result, int b, int e) will display//from the b-th item to the e-th item}});</zscript>                                                                                                    

リストボックスとグリッドを使用したページング

listboxとgridコンポーネントはページングをサポートしているので、視覚的レイアウトを持ちたくない限り、又ページングコンポーネントを使用して多数のlistboxとgridを操作しない限り、上記のようにはっきりとページングコンポーネントを指定する必要はありません。

より詳しくはグリッドセクションを参照してください。