The pagination component consists of several elements:
pagination-previous
and pagination-next
for incremental navigation
pagination-list
which displays page items:
pagination-link
for the page numbers
pagination-ellipsis
for range separators
All elements are optional so you can compose your pagination as you wish.
HTML
<nav class= "pagination" role= "navigation" aria-label= "pagination" >
<a href= "#" class= "pagination-previous" > Previous</a>
<a href= "#" class= "pagination-next" > Next page</a>
<ul class= "pagination-list" >
<li>
<a href= "#" class= "pagination-link" aria-label= "Goto page 1" > 1</a>
</li>
<li>
<span class= "pagination-ellipsis" > … </span>
</li>
<li>
<a href= "#" class= "pagination-link" aria-label= "Goto page 45" > 45</a>
</li>
<li>
<a
class= "pagination-link is-current"
aria-label= "Page 46"
aria-current= "page"
> 46</a
>
</li>
<li>
<a href= "#" class= "pagination-link" aria-label= "Goto page 47" > 47</a>
</li>
<li>
<span class= "pagination-ellipsis" > … </span>
</li>
<li>
<a href= "#" class= "pagination-link" aria-label= "Goto page 86" > 86</a>
</li>
</ul>
</nav>
You can disable some links if they are not active, or change the amount of page numbers available.
HTML
<nav class= "pagination" role= "navigation" aria-label= "pagination" >
<a class= "pagination-previous is-disabled" title= "This is the first page"
> Previous</a
>
<a href= "#" class= "pagination-next" > Next page</a>
<ul class= "pagination-list" >
<li>
<a
class= "pagination-link is-current"
aria-label= "Page 1"
aria-current= "page"
> 1</a
>
</li>
<li>
<a href= "#" class= "pagination-link" aria-label= "Goto page 2" > 2</a>
</li>
<li>
<a href= "#" class= "pagination-link" aria-label= "Goto page 3" > 3</a>
</li>
</ul>
</nav>
By default on tablet , the list is located on the left, and the previous/next buttons on the right.
But you can change the order of these elements by using the is-centered
and
is-right
modifiers.
HTML
<nav class= "pagination is-centered" role= "navigation" aria-label= "pagination" >
<a href= "#" class= "pagination-previous" > Previous</a>
<a href= "#" class= "pagination-next" > Next page</a>
<ul class= "pagination-list" >
<li><a href= "#" class= "pagination-link" aria-label= "Goto page 1" > 1</a></li>
<li><span class= "pagination-ellipsis" > … </span></li>
<li><a href= "#" class= "pagination-link" aria-label= "Goto page 45" > 45</a></li>
<li>
<a
class= "pagination-link is-current"
aria-label= "Page 46"
aria-current= "page"
> 46</a
>
</li>
<li><a href= "#" class= "pagination-link" aria-label= "Goto page 47" > 47</a></li>
<li><span class= "pagination-ellipsis" > … </span></li>
<li><a href= "#" class= "pagination-link" aria-label= "Goto page 86" > 86</a></li>
</ul>
</nav>
HTML
<nav class= "pagination is-right" role= "navigation" aria-label= "pagination" >
<a href= "#" class= "pagination-previous" > Previous</a>
<a href= "#" class= "pagination-next" > Next page</a>
<ul class= "pagination-list" >
<li><a href= "#" class= "pagination-link" aria-label= "Goto page 1" > 1</a></li>
<li><span class= "pagination-ellipsis" > … </span></li>
<li><a href= "#" class= "pagination-link" aria-label= "Goto page 45" > 45</a></li>
<li>
<a
class= "pagination-link is-current"
aria-label= "Page 46"
aria-current= "page"
> 46</a
>
</li>
<li><a href= "#" class= "pagination-link" aria-label= "Goto page 47" > 47</a></li>
<li><span class= "pagination-ellipsis" > … </span></li>
<li><a href= "#" class= "pagination-link" aria-label= "Goto page 86" > 86</a></li>
</ul>
</nav>
Styles
#
Add the is-rounded
modifier to have rounded pagination items.
HTML
<nav class= "pagination is-rounded" role= "navigation" aria-label= "pagination" >
<a href= "#" class= "pagination-previous" > Previous</a>
<a href= "#" class= "pagination-next" > Next page</a>
<ul class= "pagination-list" >
<li><a href= "#" class= "pagination-link" aria-label= "Goto page 1" > 1</a></li>
<li><span class= "pagination-ellipsis" > … </span></li>
<li><a href= "#" class= "pagination-link" aria-label= "Goto page 45" > 45</a></li>
<li>
<a
class= "pagination-link is-current"
aria-label= "Page 46"
aria-current= "page"
> 46</a
>
</li>
<li><a href= "#" class= "pagination-link" aria-label= "Goto page 47" > 47</a></li>
<li><span class= "pagination-ellipsis" > … </span></li>
<li><a href= "#" class= "pagination-link" aria-label= "Goto page 86" > 86</a></li>
</ul>
</nav>
Sizes
#
The pagination comes in 3 additional sizes .
You only need to append the modifier is-small
, is-medium
, or
is-large
to the pagination
component.
HTML
<nav class= "pagination is-small" role= "navigation" aria-label= "pagination" >
<a href= "#" class= "pagination-previous" > Previous</a>
<a href= "#" class= "pagination-next" > Next page</a>
<ul class= "pagination-list" >
<li><a href= "#" class= "pagination-link" aria-label= "Goto page 1" > 1</a></li>
<li><span class= "pagination-ellipsis" > … </span></li>
<li><a href= "#" class= "pagination-link" aria-label= "Goto page 45" > 45</a></li>
<li>
<a
class= "pagination-link is-current"
aria-label= "Page 46"
aria-current= "page"
> 46</a
>
</li>
<li><a href= "#" class= "pagination-link" aria-label= "Goto page 47" > 47</a></li>
<li><span class= "pagination-ellipsis" > … </span></li>
<li><a href= "#" class= "pagination-link" aria-label= "Goto page 86" > 86</a></li>
</ul>
</nav>
HTML
<nav class= "pagination is-medium" role= "navigation" aria-label= "pagination" >
<a href= "#" class= "pagination-previous" > Previous</a>
<a href= "#" class= "pagination-next" > Next page</a>
<ul class= "pagination-list" >
<li><a href= "#" class= "pagination-link" aria-label= "Goto page 1" > 1</a></li>
<li><span class= "pagination-ellipsis" > … </span></li>
<li><a href= "#" class= "pagination-link" aria-label= "Goto page 45" > 45</a></li>
<li>
<a
class= "pagination-link is-current"
aria-label= "Page 46"
aria-current= "page"
> 46</a
>
</li>
<li><a href= "#" class= "pagination-link" aria-label= "Goto page 47" > 47</a></li>
<li><span class= "pagination-ellipsis" > … </span></li>
<li><a href= "#" class= "pagination-link" aria-label= "Goto page 86" > 86</a></li>
</ul>
</nav>
HTML
<nav class= "pagination is-large" role= "navigation" aria-label= "pagination" >
<a href= "#" class= "pagination-previous" > Previous</a>
<a href= "#" class= "pagination-next" > Next page</a>
<ul class= "pagination-list" >
<li><a href= "#" class= "pagination-link" aria-label= "Goto page 1" > 1</a></li>
<li><span class= "pagination-ellipsis" > … </span></li>
<li><a href= "#" class= "pagination-link" aria-label= "Goto page 45" > 45</a></li>
<li>
<a
class= "pagination-link is-current"
aria-label= "Page 46"
aria-current= "page"
> 46</a
>
</li>
<li><a href= "#" class= "pagination-link" aria-label= "Goto page 47" > 47</a></li>
<li><span class= "pagination-ellipsis" > … </span></li>
<li><a href= "#" class= "pagination-link" aria-label= "Goto page 86" > 86</a></li>
</ul>
</nav>
Sass and CSS variables
#
Sass Variable
CSS Variable
Value
$ pagination-margin
var ( --bulma-pagination-margin )
-0 . 25 rem
$ pagination-min-width
var ( --bulma-pagination-min-width )
var ( --bulma-control-height )
$ pagination-item-border-style
var ( --bulma-pagination-item-border-style )
solid
$ pagination-item-border-width
var ( --bulma-pagination-item-border-width )
var ( --bulma-control-border-width )
$ pagination-item-font-size
var ( --bulma-pagination-item-font-size )
1 em
$ pagination-item-margin
var ( --bulma-pagination-item-margin )
0 . 25 rem
$ pagination-item-padding-left
var ( --bulma-pagination-item-padding-left )
0 . 5 em
$ pagination-item-padding-right
var ( --bulma-pagination-item-padding-right )
0 . 5 em
$ pagination-nav-padding-left
var ( --bulma-pagination-nav-padding-left )
0 . 75 em
$ pagination-nav-padding-right
var ( --bulma-pagination-nav-padding-right )
0 . 75 em
$ pagination-disabled-color
var ( --bulma-pagination-disabled-color )
var ( --bulma-text-weak )
$ pagination-disabled-background-color
var ( --bulma-pagination-disabled-background-color )
var ( --bulma-border )
$ pagination-disabled-border-color
var ( --bulma-pagination-disabled-border-color )
var ( --bulma-border )
$ pagination-current-color
var ( --bulma-pagination-current-color )
var ( --bulma-link-invert )
$ pagination-current-background-color
var ( --bulma-pagination-current-background-color )
var ( --bulma-link )
$ pagination-current-border-color
var ( --bulma-pagination-current-border-color )
var ( --bulma-link )
$ pagination-ellipsis-color
var ( --bulma-pagination-ellipsis-color )
var ( --bulma-text-weak )
$ pagination-shadow-inset
var ( --bulma-pagination-shadow-inset )
inset 0 0 . 0625 em 0 . 125 em hsla (
var ( --bulma-scheme-h ),
var ( --bulma-scheme-s ),
var ( --bulma-scheme-invert-l ),
0 . 2
)