Back to Pagination-guidelines

CSS ComponentThe latest version of this package is: 17.0.30-alpha.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.

View repository, Opens in new windowView package, Opens in new window
$ npm i @ids-core/pagination@17.0.30-alpha.0
Preview

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.22.2 (2022-05-03)

Miscellaneous chores

  • package locks: update package locks (813eac7)

14.20.1 (2022-04-19)

Miscellaneous chores

  • changelog: regenerate all CHANGELOG.md files (64ab385) , closes #586342
  • changelog: regenerate all changelogs after updating changelog generation (70789c9) , closes #587270

14.18.3 (2022-04-13)

Bug Fixes

  • changelog: generate new CHANGELOG.md files for root and packages (349fda4) , closes #586063 . We regenerate the files to include all relevant commits and to use conventional-commits at 100%

14.16.0 (2022-04-07)

Bug Fixes

  • 🐛 Add missing imports for global CSS Variables (fbf6f06) , closes #582437

14.9.0 (2022-03-03)

Miscellaneous chores

14.8.1 (2022-02-23)

Bug Fixes

  • 🐛 Add missing imports of typography CSS variables (e716c65) , closes #559412

reinstall (d425056)

bootstrap (9a713df)

merge (2b1c5f1)

reinstall (5221600)

reinstall (147df55)

  • use correct versions (f1b5deb)

  • Add engines for all packages (e95dfff)

reinstall (afce1f2)

reinstall (67f3140)

  • Add changelog.md to files (3338314)

Reinstall (a2abf51)

14.2.2 (2021-12-10)

Code Refactoring

reinstall (885c74b)

  • fix changelogs manually (b1232b4)

reinstall (545a069)

reinstall (e149c2c)

13.12.3 (2021-11-09)

⚠ 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!

Bug Fixes

  • 🐛 Typo for usage of the word and class name description (9d0c747)

Documentation Updates

  • ✏️ Make variations tables more condensed (4344a3a)

  • ✏️ Move position of the quick links (5cb0897)

  • ✏️ Remove unneeded margins for shortcuts (36c7e8d)

  • ✏️ Separate out CSS documentation (385cbaa) , closes #467386

  • ✏️ Update links and change navigation structure (0bfd27d) , closes #490579

Code Refactoring

  • 💡 Categorize components (9965266) , closes #490579

  • 💡 Reduce spacing tokens, use correct size tokens (97aa461)

  • 💡 Rename scope and repository (3ea5423)

  • 💡 Use new navigation structure for documentation (415aee5) , closes #490579

  • another change in the structure (38a0d2e)

Miscellaneous chores

bootstrap (6fc1ed8)

  • fix all old references to util (d57bf17)

  • prepare for merge (0184490)

reinstall (da80dba)

  • Rename scope and repo (257684e)

  • use correct version for utils (49e72d9)

13.11.0 (2021-10-19)

Features

  • 🎸 Input field hot reload (eac76b7)

13.7.0 (2021-09-22)

Documentation Updates

  • ✏️ Update linking layout and naming (15c383b)

13.6.3 (2021-09-17)

Bug Fixes

13.6.0 (2021-09-08)

Documentation Updates

  • Use default shortcut listing for demo links (a746602)

13.5.1 (2021-09-07)

Documentation Updates

  • ✏️ Add missing classnames to examples (91103ae)

  • 🤖 Use node v14 (4009973)

bootstrap (d23e139)

13.1.2 (2021-08-31)

Bug Fixes

  • 🐛 Safeguard heritance of .next from .tabs (129d7d1) , closes #463572

  • 🤖 Use correct order for diff (cc6a4fd)

12.14.1 (2021-08-12)

Miscellaneous chores

  • 🤖 Add ci task to package.json without tests (21222e0) , closes #457627

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

  • 🤖 Remove .gitignore, use npm package.json files instead, ignore zip files for npm pack (49f0269) , closes #412081 . This will whitelist files to be used in "npm pack"

  • 🤖 Reinstall (e660696)

  • 🤖 Update published date (61e7ccf)

12.6.0 (2021-05-27)

Bug Fixes

  • 🐛 Manually set firstPublished and lastModified (e83af7d)

  • 🐛 We don't need lastModified (e458a12)

12.3.0 (2021-05-19)

Documentation Updates

  • ✏️ Documentation fixes (ad1882a)

12.0.0 (2021-05-05)

⚠ 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

Features

  • 🎸 Extract components from selection control (50607a4) , closes #336508

  • 🎸 Rename and extract and update hero with no image to (384eb77) , closes #336508 . Header component

Bug Fixes

Code Refactoring

Miscellaneous chores

  • 🤖 Convert util tokens from theo to style-dictionary (99fb4f5)

  • 🤖 Finalize breakpoint token conversion (f50ea0d)

  • 🤖 Reinstall (2c763ea)

  • 🤖 Reinstall (69e1a5b)

  • 🤖 Update all design token references (c640d15)

  • 🤖 Update all example references to old menu (81205ad)

  • 🤖 Update markup (03e4df0)

  • 🤖 Update references to util variables (b79ec36)

  • 🤖 Updating links (70f166e)

rebuild (7edb430)

  • 🤖 Rename Change Log to Changelog (d412e63)

  • 🤖 Remove all references to sketch (35fc554) , closes #339203

  • 🤖 Update package fields (200c0af)

10.0.0 (2021-02-15)

Documentation Updates

  • ✏️ Use correct syntax for html code snippet (06f3214)

  • 🤖 Update markup for search fields (e4f4b01)

  • reinstall packages (fcfacf4)

8.2.1 (2021-01-13)

Bug Fixes

  • 🐛 Add pagination demo content (c8bdbd4) , closes #331844

  • 🤖 Use a more distint class name for doc crosslink links (2694867)

7.1.0 (2020-11-16)

Features

  • 🎸 Add support for auto generation of components index (9444600) , closes #309650

6.43.3 (2020-11-03)

Miscellaneous chores

  • 🤖 Manually set version (e4d9ca6)

6.43.0 (2020-10-27)

Features

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