Back to Pagination-guidelines

CSS ComponentThe latest version of this package is: 14.1.0, Opens in new window

Pagination allows you to divide large amounts of content into smaller chunks across multiple pages.

This component provides .css, .styl, .less and .scss -files.

To be able to install this component, please refer to the Project Setup documentation.

$ npm i @ids-core/pagination@14.1.0

Table of Contents

Edit this section, Opens in new window

Usage

Default

<nav class="if pagination" role="navigation" aria-label="Pagination Navigation">
  <ul class="if">
    <li class="if"><button class="if first" type="button" aria-label="Goto first page"></button></li>
    <li class="if">
      <button class="if previous" type="button" aria-label="Goto previous page"></button>
    </li>
    <li class="if"><button class="if" type="button" aria-label="Goto Page 1">1</button></li>
    <li class="if"><button class="if" type="button" aria-label="Goto Page 2">2</button></li>
    <li class="if">
      <button class="if current" type="button" aria-label="Current Page, Page 3" aria-current="true">
        3
      </button>
    </li>
    <li class="if"><button class="if" type="button" aria-label="Goto Page 4">4</button></li>
    <li class="if">
      <button class="if expand" type="button" aria-label="Expand pages" title="Expand pages">โ€ฆ</button>
    </li>
    <li class="if"><button class="if" type="button" aria-label="Goto Page 30">30</button></li>
    <li class="if"><button class="if next" type="button" aria-label="Goto next page"></button></li>
    <li class="if"><button class="if last" type="button" aria-label="Goto last page"></button></li>
  </ul>
  <span class="if description">Showing <strong class="if">31-40</strong> of <strong class="if">300</strong></span>
</nav>

Minimal

<nav class="if pagination" role="navigation" aria-label="Pagination Navigation">
  <ul class="if">
    <li class="if">
      <button class="if previous" type="button" aria-label="Goto previous page"></button>
    </li>
    <li class="if"><button class="if next" type="button" aria-label="Goto next page"></button></li>
  </ul>
  <span class="if description"><strong class="if">31-40</strong> of <strong class="if">300</strong></span>
</nav>

Default with disabled arrows

<nav class="if pagination" role="navigation" aria-label="Pagination Navigation">
  <ul class="if">
    <li class="if">
      <button disabled class="if first" type="button" aria-label="Goto first page"></button>
    </li>
    <li class="if">
      <button disabled class="if previous" type="button" aria-label="Goto previous page"></button>
    </li>
    <li class="if"><button class="if" type="button" aria-label="Goto Page 1">1</button></li>
    <li class="if"><button class="if" type="button" aria-label="Goto Page 2">2</button></li>
    <li class="if">
      <button class="if current" type="button" aria-label="Current Page, Page 3" aria-current="true">
        3
      </button>
    </li>
    <li class="if"><button class="if" type="button" aria-label="Goto Page 4">4</button></li>
    <li class="if"><button class="if" type="button" aria-label="Goto Page 5">5</button></li>
    <li class="if">
      <button disabled class="if next" type="button" aria-label="Goto next page"></button>
    </li>
    <li class="if">
      <button disabled class="if last" type="button" aria-label="Goto last page"></button>
    </li>
  </ul>
  <span class="if description">Showing <strong class="if">31-40</strong> of <strong class="if">300</strong></span>
</nav>

Dots

<nav class="if pagination dots" role="navigation" aria-label="Pagination Navigation">
  <ul class="if">
    <li class="if"><button class="if" type="button" aria-label="Goto Page 1">1</button></li>
    <li class="if"><button class="if" type="button" aria-label="Goto Page 2">2</button></li>
    <li class="if">
      <button class="if current" type="button" aria-label="Current Page, Page 3" aria-current="true">
        3
      </button>
    </li>
    <li class="if"><button class="if" type="button" aria-label="Goto Page 4">4</button></li>
    <li class="if"><button class="if" type="button" aria-label="Goto Page 5">5</button></li>
  </ul>
</nav>

Small

<nav class="if pagination dots small" role="navigation" aria-label="Pagination Navigation">
  <ul class="if">
    <li class="if"><button class="if" type="button" aria-label="Goto Page 1">1</button></li>
    <li class="if"><button class="if" type="button" aria-label="Goto Page 2">2</button></li>
    <li class="if">
      <button class="if current" type="button" aria-label="Current Page, Page 3" aria-current="true">
        3
      </button>
    </li>
    <li class="if"><button class="if" type="button" aria-label="Goto Page 4">4</button></li>
    <li class="if"><button class="if" type="button" aria-label="Goto Page 5">5</button></li>
  </ul>
</nav>
Edit this section, Opens in new window

Accessibility

This component complies with accessibility guidelines by doing the following:

  • Wraps the pagination links in a <nav> element to let screen readers recognize the pagination controls
  • Sets aria-label="pagination" to describe the type of navigation
  • Indicates the active page by adding aria-current="page" to the link that points to the current page
Edit this section, Opens in new window

Changelog

Change Log

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

14.0.0 (2021-11-09)

Bug Fixes

  • ๐Ÿ› Typo for usage of the word and class name description (9d0c747)

chore

  • ๐Ÿค– Rename util to utils (f78721f)

Code Refactoring

  • ๐Ÿ’ก Rename scope and repository (3ea5423)
  • ๐Ÿ’ก Use new navigation structure for documentation (415aee5), closes #490579

Documentation

  • โœ๏ธ Update links and change navigation structure (0bfd27d), closes #490579

BREAKING CHANGES

  • ๐Ÿงจ The scope for If Design System npm packages has now changed from

@if-design-system to @ids-core. We have also renamed the repository from if-design-system to ids-core

  • ๐Ÿงจ Util is now renamed to Utils
  • ๐Ÿงจ We have now changed the navigation structure for the documentation site.

Please update any saved links!

  • ๐Ÿงจ Navigation structure has now changed. Please see release notes!

13.11.0 (2021-10-19)

Features

  • ๐ŸŽธ Input field hot reload (eac76b7)

13.6.3 (2021-09-17)

Bug Fixes

13.1.2 (2021-08-31)

Bug Fixes

  • ๐Ÿ› Safeguard heritance of .next from .tabs (129d7d1), closes #463572

12.13.1 (2021-08-11)

Bug Fixes

  • ๐Ÿ› Whitelist docs dir for npm packaging (1a5cfd0), closes #457621

12.12.1 (2021-08-10)

Bug Fixes

  • ๐Ÿ› Make sure components using fonts, have fonts bundled (d5bb642), closes #354912

12.6.0 (2021-05-27)

Bug Fixes

  • ๐Ÿ› Manually set firstPublished and lastModified (e83af7d)
  • ๐Ÿ› We don't need lastModified (e458a12)

12.0.0 (2021-05-05)

Bug Fixes

  • ๐Ÿ› Update references (c08f107)

Code Refactoring

  • ๐Ÿ’ก Rename and consolidate mixins (67cf470), closes #268081
  • ๐Ÿ’ก Rename crosslink buttons to Shortcuts (c05bf9c), closes #336508
  • ๐Ÿ’ก Rename Dropdown to Dropdown Select (af1fc9d), closes #336508
  • ๐Ÿ’ก Rename Footer to Global Footer (7cb7239), closes #336508
  • ๐Ÿ’ก Rename Notification to Alert Banner (8b4e48d), closes #336508

Features

  • ๐ŸŽธ Extract components from selection control (50607a4), closes #336508
  • ๐ŸŽธ Rename and extract and update hero with no image to (384eb77), closes #336508

BREAKING CHANGES

  • ๐Ÿงจ All of the mixins have now been renamed
  • ๐Ÿงจ Notification is now renamed to Alert Banner
  • ๐Ÿงจ This extracts the Hero variation with no image into a separate, design

updated component named Header

  • ๐Ÿงจ Footer is now renamed to Global Footer
  • ๐Ÿงจ The Dropdown Component is now renamed to Dropdown Select. Dropdown is a

pattern.

  • ๐Ÿงจ Crosslinks have seized to exist. They are all extracted into separate

components. This commit converts crosslink buttons into the new component Shortcuts

  • ๐Ÿงจ Selection controls is no more. Has ceased to be. Bereft of life, it

rests in peace. This is an ex-component. The component is split into Radio Buttons, Toggle Control and Checkbox

8.2.1 (2021-01-13)

Bug Fixes

7.1.0 (2020-11-16)

Features

  • ๐ŸŽธ Add support for auto generation of components index (9444600), closes #309650

6.43.0 (2020-10-27)

Features

Edit this section, Opens in new window
Contact us, Opens in new window