Pagination

The pagination control is used to split content over a number of pages and guide users directly to a particular page or to the next or previous page.

• Include a title that describes how many page links are being displayed, and the overall number of links, eg. 'Showing 1 of 15'.
• Consider whether pagination is required - undertake user research activity to understand what an optimum page length would be for your content; it may be longer than you think, as scrolling can be less onerous for users than navigating between pages, depending on the scenario.
• A maximum of nine page number links should be displayed in large and medium views.
• A maximum of five page number links should be displayed in a small view.

• Don't use 'first' and 'last' links.
• Must not be used on dark accent colours.

Examples

Notes for developers

Will require some logic to be able to appropriately apply classes to the pagination items depending on where the currently selected page falls within the list.

Not built to work on dark accent colours.

Button elements can be used instead of anchor elements if required for your particular application.

The current/selected page should not be a link/button if at all possible. If it must remain a link/button ensure aria-current is set correctly so that it is announced correctly to users as they navigate the page using assistive technologies.

Notes for testers

• Ensure that links can be accessed via the mouse as well as via tabbing using the keyboard.
• Use a screen reader to confirm that the links are understandable as to where they will be going when listed out of context of the page.
• Ensure that when hovering over a link the style changes noticeably.
• Ensure that when a link has focus the style changes noticeably.
• There should be a clear visual distinction between the current page, a hover state for selectable pages, non-selected pages, and Previous and Next links. Do not use first and last links or chevrons.
• Show a maximum of nine page links in a desktop or tablet view, or a maximum of five links for a mobile view.

Code Examples

<p class="u-text--center u-no-print">Showing ... of ...</p>
<nav class="a-pagination" role="navigation" aria-label="Pagination">
	<ul class="a-pagination-list a-list-plain">
		<li class="a-pagination-list__item a-pagination-list__item--secondary"><a href="..." aria-label="Page ...">...</a></li>
		<li class="a-pagination-list__item a-pagination-list__item--secondary"><a href="..." aria-label="Page ...">...</a></li>
		<li class="a-pagination-list__item a-pagination-list__item--primary"><a href="..." aria-label="Page ...">...</a></li>
		<li class="a-pagination-list__item a-pagination-list__item--primary"><a href="..." aria-label="Page ...">...</a></li>
		<li class="a-pagination-list__item a-pagination-list__item--primary a-pagination-list__item--selected"><span aria-current="page" aria-label="Page ...">...</span></li>
		<li class="a-pagination-list__item a-pagination-list__item--primary"><a href="..." aria-label="Page ...">...</a></li>
		<li class="a-pagination-list__item a-pagination-list__item--primary"><a href="..." aria-label="Page ...">...</a></li>
		<li class="a-pagination-list__item a-pagination-list__item--secondary"><a href="..." aria-label="Page ...">...</a></li>
		<li class="a-pagination-list__item a-pagination-list__item--secondary"><a href="..." aria-label="Page ...">...</a></li>
	</ul>
	<p class="a-pagination__previous"><a href="..." aria-label="Previous page"><span>Previous</span></a></p>
	<p class="a-pagination__next"><a href="..." aria-label="Next page"><span>Next</span></a></p>
</nav>

Classes overview

The following table gives you a quick overview of the CSS classes that can be applied.

Keyboard operations

TAB

Tabbing to an anchor should make the social link clearly visually different so that the focus point on the page is obvious to the user.

SPACE or ENTER

With focus on an anchor, pressing SPACE or ENTER will open the relevant page.