1b5ff950cc
- primer-alerts@1.5.9 - primer-avatars@1.5.6 - primer-base@1.7.4 - primer-blankslate@1.4.9 - primer-box@2.5.9 - primer-branch-name@1.0.7 - primer-breadcrumb@1.5.5 - primer-buttons@2.6.0 - primer-core@6.10.3 - primer-forms@2.1.4 - primer-labels@1.5.9 - primer-layout@1.4.9 - primer-markdown@3.7.9 - primer-marketing-buttons@1.0.8 - primer-marketing-type@1.4.9 - primer-marketing-utilities@1.6.5 - primer-marketing@6.2.4 - primer-navigation@1.5.7 - primer-page-headers@1.4.9 - primer-page-sections@1.4.9 - primer-pagination@1.0.3 - primer-popover@0.1.3 - primer-product@5.6.6 - primer-subhead@1.0.7 - primer-support@4.6.0 - primer-table-object@1.4.9 - primer-tables@1.4.9 - primer-tooltips@1.5.7 - primer-truncate@1.4.9 - primer-utilities@4.12.0 - primer@10.8.0 - generator-primer-module@1.0.8 - primer-module-build@1.0.5 - stylelint-config-primer@2.2.10 - stylelint-selector-no-utility@1.8.10 |
||
|---|---|---|
| .. | ||
| lib | ||
| index.scss | ||
| LICENSE | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| stories.js | ||
Primer Pagination
Pagination component for applying button styles to a connected set of links that go to related pages
This repository is a module of the full [primer][primer] repository.
Install
This repository is distributed with [npm]. After [installing npm][install-npm], you can install primer-pagination with this command.
$ npm install --save primer-pagination
Usage
The source files included are written in [Sass][sass] (SCSS) You can simply point your sass include-path at your node_modules directory and import it like this.
@import "primer-pagination/index.scss";
You can also import specific portions of the module by importing those partials from the /lib/ folder. Make sure you import any requirements along with the modules.
Build
For a compiled CSS version of this module, an npm script is included that will output a css version to build/build.css The built css file is also included in the npm package:
$ npm run build
Documentation
Use the pagination component to apply button styles to a connected set of links that go to related pages (for example, previous, next, or page numbers).
{:toc}
Previous/next pagination
You can make a very simple pagination container with just the Previous and Next buttons. Add the class disabled to the Previous button if there isn't a preceding page, or to the Next button if there isn't a succeeding page.
<nav class="paginate-container" aria-label="Pagination">
<div class="pagination">
<span class="previous_page disabled">Previous</span>
<a class="next_page" rel="next" href="#url" aria-label="Next Page">Next</a>
</div>
</nav>
Numbered pagination
For pagination across multiple pages, make sure it's clear to the user where they are in a set of pages.
To do this, add anchor links to the pagination element. Previous and Next buttons should always be present. Add the class disabled to the Previous button if you're on the first page. Apply the class current to the current numbered page.
As always, make sure to include the appropriate aria attributes to make the element accessible.
- Add
aria-label="Pagination"to the thepaginate-containerelement. - Add
aria-current="true"to the current page marker. - Add
aria-label="Page X"to each anchor link.
<nav class="paginate-container" aria-label="Pagination">
<div class="pagination">
<span class="previous_page disabled">Previous</span>
<em class="current selected" aria-current="true">1</em>
<a href="#url" aria-label="Page 2">2</a>
<a href="#url" aria-label="Page 3">3</a>
<span class="gap">…</span>
<a href="#url" aria-label="Page 8">8</a>
<a href="#url" aria-label="Page 9">9</a>
<a href="#url" aria-label="Page 10">10</a>
<a class="next_page" rel="next" href="#url" aria-label="Next Page">Next</a>
</div>
</nav>