Grid Paging Specification
- Revision History
- Overview
- User Stories
- Functionality
- ARIA support
- Assumptions and Limitations
- Test Scenarios
- References
| Version | User | Date | Notes |
|---|---|---|---|
| 0.1 | Danail Marinov | July 3, 2019 | Initial draft |
- Stefan Ivanov | Date:
- Simeon Simeonoff | Date:
- Konstantin Dinev | Date:
The Grid Paging Component is used to:
- inform the user on which Grid page he is currently on
- allow navigation to the previous/next and first/last pages of the Grid content
- to inform the user how many records are being displayed per page and to let him select number of records to be displayed per page
As an end user:
- I want to see how many records are currently being displayed per page
- I want to be able to select the number of records displayed per page
- I want to see on which Grid page I am currently on
- I want to know what is the total number of pages according to the number of records displayed
- I want to be able to navigate to the first/last Grid page through the icon button
- I want to be able to navigate to the next/previous Grid page through the icon button
As a developer:
- I want to be able to set the number of records shown per page
- I want to be able to set Grid Paging display density
- I want to be able to enable/disable Pager buttons and Dropdown
- I want to be able to apply theme on the Paging according to the Grid theme
4.1 Overview:
The Grid Paging component is attached to the Grid bottom and if the Grid includes Summary, then Paging row is placed after the Summaries. As an end user, I can change the number of records displayed per page through the dropdown that by default is positioned in the left end of the Paging row. As an end user, I can move to the first/last or next/previous page through the icon buttons that are by default placed in the right end of the Paging row. Changing the number of rows displayed per page may result in change of the total number of Grid pages. The number of pages depends on the total number of grid rows and the rows displayed per page.
4.2 Display density - Comfortable, Cozy and Compact
- Comfortable
- Cozy
- Compact
4.3 Pagination with a Tree Grid
If paging is integrated with Tree Grid, the number of displayed items includes all rows regardless of the level they belong to. Because of that, if I, as an end user, collapse/expand some of the rows that have nested items, that would affect the total number of pages within the grid. Minimum number of pages is displayed when all top level rows are collapsed. Maximum number of pages is displayed when all available rows are expanded.
4.4 Pagination with a Hierarchical Grid
If paging is integrated with Hierarchical Grid, then each grid (that have at least one item) has its own paging. If a grid does not have any records, then Paging is not displayed. Note that the Paging component on the top parent level is indicating the number of items only on its level, without including nested items.
