Skip to content

Components

Pagination

Page links with previous, next, and truncation.

Usage

Basic

HTML
<bs:bsui-pagination>
  <bs:bsui-pagination-previous href="#" />
  <bs:bsui-pagination-item label="1" href="#" />
  <bs:bsui-pagination-item label="2" href="#" current="true" />
  <bs:bsui-pagination-item label="3" href="#" />
  <bs:bsui-pagination-ellipsis />
  <bs:bsui-pagination-next href="#" />
</bs:bsui-pagination>

Deep list

An ellipsis on either side of the current page keeps the first and last page reachable.

HTML
<bs:bsui-pagination>
  <bs:bsui-pagination-previous href="#" />
  <bs:bsui-pagination-item label="1" href="#" />
  <bs:bsui-pagination-ellipsis />
  <bs:bsui-pagination-item label="5" href="#" />
  <bs:bsui-pagination-item label="6" href="#" current="true" />
  <bs:bsui-pagination-item label="7" href="#" />
  <bs:bsui-pagination-ellipsis />
  <bs:bsui-pagination-item label="24" href="#" />
  <bs:bsui-pagination-next href="#" />
</bs:bsui-pagination>

Previous and next

Numbers are optional when the archive only moves one page at a time.

HTML
<bs:bsui-pagination>
  <bs:bsui-pagination-previous href="#" />
  <bs:bsui-pagination-next href="#" />
</bs:bsui-pagination>

Anatomy

Pagination is composed of the blocks below. Each one is a separate block that only renders inside its parent.

  • bsui/pagination
  • bsui/pagination-ellipsis
  • bsui/pagination-item
  • bsui/pagination-next
  • bsui/pagination-previous

Attributes

This block takes no attributes.

bsui/pagination-ellipsis

This block takes no attributes.

bsui/pagination-item

AttributeTypeDefault
label richtext —
href text #
current toggle false

bsui/pagination-next

AttributeTypeDefault
href text #

bsui/pagination-previous

AttributeTypeDefault
href text #