Components / Navigation
Pagination
Displays navigation for paged content.
<nav class="pagination" aria-label="pagination">
<ul>
<li>
<a class="btn" data-variant="ghost" data-size="icon" href="#" aria-label="Go to previous page"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m15 18-6-6 6-6"/></svg></a>
</li>
<li><a class="btn" data-variant="ghost" href="#" aria-current="page">1</a></li>
<li><a class="btn" data-variant="ghost" href="#">2</a></li>
<li><a class="btn" data-variant="ghost" href="#">3</a></li>
<li>
<a class="btn" data-variant="ghost" data-size="icon" href="#" aria-label="Go to next page"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m9 18 6-6-6-6"/></svg></a>
</li>
</ul>
</nav>Installation
pnpm dlx loseta add paginationnpx loseta add paginationExamples
With ellipsis
<nav class="pagination" aria-label="pagination">
<ul>
<li>
<a class="btn" data-variant="ghost" href="#" aria-label="Go to previous page">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m15 18-6-6 6-6"/></svg>
<span data-slot="label" aria-hidden="true">Previous</span>
</a>
</li>
<li><a class="btn" data-variant="ghost" href="#">1</a></li>
<li><a class="btn" data-variant="ghost" href="#">2</a></li>
<li><a class="btn" data-variant="ghost" href="#">3</a></li>
<li><span data-slot="ellipsis" aria-hidden="true"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="1"/><circle cx="19" cy="12" r="1"/><circle cx="5" cy="12" r="1"/></svg></span></li>
<li><a class="btn" data-variant="ghost" href="#">8</a></li>
<li><a class="btn" data-variant="ghost" href="#">9</a></li>
<li><a class="btn" data-variant="ghost" href="#" aria-current="page">10</a></li>
<li>
<a class="btn" data-variant="ghost" href="#" aria-label="Go to next page">
<span data-slot="label" aria-hidden="true">Next</span>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m9 18 6-6-6-6"/></svg>
</a>
</li>
</ul>
</nav>Accessibility and behavior
- Use nav[aria-label="pagination"] and .btn links. The current page uses aria-current="page"; the ellipsis is decorative. Button is optional composition, not a hard dependency.
Files
components/pagination.cssbasestyles/nova/pagination.cssstyleInstall contract
The CLI writes the base file under components/, the visual file for the selected style under styles/<name>/, and any primitive dependency underprimitives/. The generated index.css imports them in the right layer order.