Represents a component that is used to control how to display other components in multiple pages. In other words, it represents a paging controller.
It is used to provide an abstract contract between controller and controllee. For example, {@link org.zkoss.zul.Paging} is a paging controllerwhile {@link org.zkoss.zul.Grid} is a paging controllee.In other words, {@link org.zkoss.zul.Grid} (contains long content)can be controlled by {@link org.zkoss.zul.Paging}.
The paging controller must implement this interface, while the paging controllee shall access only this interface (rather than {@link org.zkoss.zul.Paging} or so).
Note: If a component supports multiple pages but it cannot be controlled by a paging controller, it shall implement {@link Pageable} instead.Example, {@link org.zkoss.zul.Treechildren}is {@link Pageable} but not controllable by {@link Paginal}.
- {@link Paginated}: a multi-page component whose pagination is controlled by an external page controlle ( {@link Paginal}).
- {@link Paginal}: the paging controller used to control the pagination of {@link Paginated}.
- {@link Pageable}: a multi-page component that handles pagination by itself.
@author tomyeh
@see Paginated