Skip to content

Commit

Permalink
add docs
Browse files Browse the repository at this point in the history
  • Loading branch information
hipstersmoothie committed Oct 23, 2018
1 parent 71a6bc4 commit c0e2eb6
Showing 1 changed file with 51 additions and 0 deletions.
51 changes: 51 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -1 +1,52 @@
# bulma-pagination-react

[Bulma pagination](https://bulma.io/) as a [react](https://reactjs.org/) component.

## Installation

```sh
yarn add bulma-pagination-react
```

## Usage

To start using the pagination component all you need to do is provide how many pages there are and what page the user is on. All other properties are optional

```js
import React from 'react';
import Pagination from 'bulma-pagination-react';

const POSTS_PER_PAGE = 10;

const Pager = ({ posts, currentPage, perPage = POSTS_PER_PAGE }) => {
const pages = Math.ceil(posts.length / perPage);

return (
<Pagination
pages={pages}
currentPage={currentPage}
onChange={page => console.log(`/blog?page=${page}`)}
/>
);
};

export default Pager;
```

### onChange

Function called when a button or page link is clicked. The only argument supplied to the function is the new page number.

### visibleRadius

Modify how many page elements are visible in the pagination component. Defaults to 1.

### className

`bulma-pagination-react` has classes that effect all elements in the component.

- className: ClassName for the wrapper
- prevClassName: ClassName for the previous button
- nextClassName: ClassName for the next button
- linkClassName: ClassName for each page link
- listClassName: ClassName for the list of page links

0 comments on commit c0e2eb6

Please sign in to comment.