@thebase/ui/docs/components/pagination.md

CDN-installable Owl and Bootstrap 5 UI component library.

# Pagination

Use `b-ui="pagination"` on a `nav` containing a list of links or buttons.

## Pure Owl component

```js
import { Pagination, PaginationItem } from "@thebase/ui";
```

```base-ui
<div style="max-width: 28rem" class="w-100">
  <Pagination>
    <PaginationItem>
      <Icon name="'chevron-left'"/>
      <span class="ms-1">Previous</span>
    </PaginationItem>
    <PaginationItem>1</PaginationItem>
    <PaginationItem current="true">2</PaginationItem>
    <PaginationItem>3</PaginationItem>
    <PaginationItem disabled="true">...</PaginationItem>
    <PaginationItem>
      <span class="me-1">Next</span>
      <Icon name="'chevron-right'"/>
    </PaginationItem>
  </Pagination>
</div>
```

| Component | Prop | Type | Notes |
| --- | --- | --- | --- |
| `Pagination` | `className` | `String` | optional |
| `PaginationItem` | `current` | `Boolean` | optional |
| `PaginationItem` | `disabled` | `Boolean` | optional |
| `PaginationItem` | `onClick` | `Function` | optional |

See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.

## Static component

```base-ui
<nav b-ui="pagination" aria-label="Pagination">
  <ul>
    <li><a href="?page=1" aria-current="page">1</a></li>
    <li><a href="?page=2">2</a></li>
  </ul>
</nav>
```

BaseUI adds Bootstrap pagination classes, active states, and disabled item styling.