Pagination
CSS-only Tailwind CSS pagination for numbered pages, prev/next arrows, ellipsis gaps, accessible radio inputs, and a page-jump select. No JavaScript required. WCAG AA accessible, works with Django, HTMX, Laravel, React, and any stack.
Komponenty paginacji umożliwiają użytkownikom nawigację pomiędzy stronami treści — wynikami wyszukiwania, tabelami danych, archiwami artykułów i listami produktów. Zbudowana w oparciu o komponenty Dołącz i Button, paginacja Frutjam nie wymaga JavaScript ani dodatkowego CSS. Obsługuje numerowane strony, strzałki poprzedniej/następnej, przerwy w wielokropkach, dostępne wejścia radiowe i wybór przeskakiwania między stronami.
Tylko CSS, nie wymaga JavaScript — twórz przystępną paginację za pomocą czystego HTMX i CSS Tailwind. Dostępny w WCAG AA i niezależny od frameworka — współpracuje z Django, HTMX, Laravel, React, Next.js i dowolnym stosem.
| Klasa | Typ | Opis |
|---|---|---|
| join | Opierać | Grupuje przyciski w połączony pasek stronicowania |
| join-item | Modyfikator | Każdy przycisk strony lub dane wejściowe wewnątrz złączenia |
| btn-active | State | Podświetla bieżącą stronę |
| btn-disabled | State | Nieinteraktywny wielokropek lub strona niedostępna |
Podstawowa paginacja
Numerowany pasek strony z jedną aktywną stroną. Zastosuj btn-active, aby podświetlić bieżącą stronę. Używaj tagów zakotwiczeń zamiast przycisków dla linków do stron renderowanych przez serwer.
1 2 3 4 5 6 7 | <div class="join"> <button class="join-item btn">1</button> <button class="join-item btn btn-active">2</button> <button class="join-item btn">3</button> <button class="join-item btn">4</button> <button class="join-item btn">5</button> </div> |
1 2 3 4 5 6 7 | <div className="join"> <button className="join-item btn">1</button> <button className="join-item btn btn-active">2</button> <button className="join-item btn">3</button> <button className="join-item btn">4</button> <button className="join-item btn">5</button> </div> |
Rozmiary
Paginacja dziedziczy wszystkie rozmiary przycisków. Użyj btn-xs lub btn-sm w przypadku tabel kompaktowych i btn-lg w przypadku interfejsów dotykowych.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 | <div class="flex flex-col gap-3 items-start"> <div class="join"> <button class="join-item btn btn-xs">1</button> <button class="join-item btn btn-xs btn-active">2</button> <button class="join-item btn btn-xs">3</button> <button class="join-item btn btn-xs">4</button> </div> <div class="join"> <button class="join-item btn btn-sm">1</button> <button class="join-item btn btn-sm btn-active">2</button> <button class="join-item btn btn-sm">3</button> <button class="join-item btn btn-sm">4</button> </div> <div class="join"> <button class="join-item btn">1</button> <button class="join-item btn btn-active">2</button> <button class="join-item btn">3</button> <button class="join-item btn">4</button> </div> <div class="join"> <button class="join-item btn btn-lg">1</button> <button class="join-item btn btn-lg btn-active">2</button> <button class="join-item btn btn-lg">3</button> <button class="join-item btn btn-lg">4</button> </div> </div> |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 | <div className="flex flex-col gap-3 items-start"> <div className="join"> <button className="join-item btn btn-xs">1</button> <button className="join-item btn btn-xs btn-active">2</button> <button className="join-item btn btn-xs">3</button> <button className="join-item btn btn-xs">4</button> </div> <div className="join"> <button className="join-item btn btn-sm">1</button> <button className="join-item btn btn-sm btn-active">2</button> <button className="join-item btn btn-sm">3</button> <button className="join-item btn btn-sm">4</button> </div> <div className="join"> <button className="join-item btn">1</button> <button className="join-item btn btn-active">2</button> <button className="join-item btn">3</button> <button className="join-item btn">4</button> </div> <div className="join"> <button className="join-item btn btn-lg">1</button> <button className="join-item btn btn-lg btn-active">2</button> <button className="join-item btn btn-lg">3</button> <button className="join-item btn btn-lg">4</button> </div> </div> |
Z elipsą
Użyj opcji btn-disabled w przypadku odstępu wielokropka między dużym zakresem stron. Czytniki ekranu pomijają wyłączone przyciski, więc sparuj je z aria-hidden="true" w wielokropku.
1 2 3 4 5 6 7 8 9 | <div class="join"> <button class="join-item btn">1</button> <button class="join-item btn">2</button> <button class="join-item btn btn-disabled" aria-hidden="true">...</button> <button class="join-item btn btn-active">12</button> <button class="join-item btn btn-disabled" aria-hidden="true">...</button> <button class="join-item btn">99</button> <button class="join-item btn">100</button> </div> |
1 2 3 4 5 6 7 8 9 | <div className="join"> <button className="join-item btn">1</button> <button className="join-item btn">2</button> <button className="join-item btn btn-disabled" aria-hidden="true">...</button> <button className="join-item btn btn-active">12</button> <button className="join-item btn btn-disabled" aria-hidden="true">...</button> <button className="join-item btn">99</button> <button className="join-item btn">100</button> </div> |
Poprzednia/Następna nawigacja
Paginacja oparta na strzałkach jest najczęstszym wzorcem w przypadku blogów, list produktów i wszelkich kanałów podzielonych na strony, w których pokazanie dokładnych numerów stron nie jest praktyczne.
Z Ikonami Strzałek
1 2 3 4 5 6 7 8 9 | <div class="join"> <button class="join-item btn" aria-label="Previous page"> <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M15 18l-6-6 6-6"/></svg> </button> <button class="join-item btn">Page 12</button> <button class="join-item btn" aria-label="Next page"> <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M9 18l6-6-6-6"/></svg> </button> </div> |
1 2 3 4 5 6 7 8 9 | <div className="join"> <button className="join-item btn" aria-label="Previous page"> <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round"><path d="M15 18l-6-6 6-6"/></svg> </button> <button className="join-item btn">Page 12</button> <button className="join-item btn" aria-label="Next page"> <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round"><path d="M9 18l6-6-6-6"/></svg> </button> </div> |
Równa szerokość Poprzedni / Następny
Użyj opakowania grid grid-cols-2 na kontenerze łączenia, aby zapewnić obu przyciskom równą szerokość — idealne rozwiązanie w przypadku układów dostosowanych przede wszystkim do urządzeń mobilnych i pasków stronicowania o pełnej szerokości.
1 2 3 4 | <div class="join grid grid-cols-2 w-72"> <button class="join-item btn btn-outline">← Previous</button> <button class="join-item btn btn-outline">Next →</button> </div> |
1 2 3 4 | <div className="join grid grid-cols-2 w-72"> <button className="join-item btn btn-outline">← Previous</button> <button className="join-item btn btn-outline">Next →</button> </div> |
Z Pierwszym/Ostatnim
Dodaj przyciski z podwójną strzałką, aby umożliwić użytkownikom przejście bezpośrednio do pierwszej lub ostatniej strony. Przydatne w przypadku tabel danych zawierających setki stron.
1 2 3 4 5 6 7 8 9 | <div class="join"> <button class="join-item btn btn-ghost btn-sm" aria-label="First page">«</button> <button class="join-item btn btn-sm" aria-label="Previous page">‹</button> <button class="join-item btn btn-sm">4</button> <button class="join-item btn btn-sm btn-active">5</button> <button class="join-item btn btn-sm">6</button> <button class="join-item btn btn-sm" aria-label="Next page">›</button> <button class="join-item btn btn-ghost btn-sm" aria-label="Last page">»</button> </div> |
1 2 3 4 5 6 7 8 9 | <div className="join"> <button className="join-item btn btn-ghost btn-sm" aria-label="First page">«</button> <button className="join-item btn btn-sm" aria-label="Previous page">‹</button> <button className="join-item btn btn-sm">4</button> <button className="join-item btn btn-sm btn-active">5</button> <button className="join-item btn btn-sm">6</button> <button className="join-item btn btn-sm" aria-label="Next page">›</button> <button className="join-item btn btn-ghost btn-sm" aria-label="Last page">»</button> </div> |
Dostępna paginacja radia
Użyj danych wejściowych type="radio" jako elementów łączenia, aby w pełni poruszać się za pomocą klawiatury i wybierać strony wyłącznie za pomocą CSS, bez JavaScript. Każde wejście działa jak przycisk, który można nacisnąć, utrzymując wybrany stan w stanie natywnym.
1 2 3 4 5 6 7 | <div class="join"> <input class="join-item btn btn-square" type="radio" name="page" aria-label="1" /> <input class="join-item btn btn-square" type="radio" name="page" aria-label="2" checked /> <input class="join-item btn btn-square" type="radio" name="page" aria-label="3" /> <input class="join-item btn btn-square" type="radio" name="page" aria-label="4" /> <input class="join-item btn btn-square" type="radio" name="page" aria-label="5" /> </div> |
1 2 3 4 5 6 7 | <div className="join"> <input className="join-item btn btn-square" type="radio" name="page" aria-label="1" /> <input className="join-item btn btn-square" type="radio" name="page" aria-label="2" defaultChecked /> <input className="join-item btn btn-square" type="radio" name="page" aria-label="3" /> <input className="join-item btn btn-square" type="radio" name="page" aria-label="4" /> <input className="join-item btn btn-square" type="radio" name="page" aria-label="5" /> </div> |
Paginacja za pomocą przeskoku strony
Połącz łączenie, przyciski i opcję wyboru, aby uzyskać kompaktowy pasek paginacji, który pozwala użytkownikom przejść bezpośrednio do dowolnej strony — często w panelach administracyjnych, interfejsach CMS i aplikacjach wymagających dużej ilości danych. Dla samego zaznaczenia nie jest wymagana obsługa JavaScript; sparuj z HTMX lub formularzem przesłanym do nawigacji po stronie serwera.
1 2 3 4 5 6 7 8 9 10 11 | <div class="join"> <button class="join-item btn btn-sm" aria-label="Previous page">‹</button> <select class="join-item select select-sm" aria-label="Go to page"> <option>Page 1</option> <option>Page 2</option> <option selected>Page 3</option> <option>Page 4</option> <option>Page 5</option> </select> <button class="join-item btn btn-sm" aria-label="Next page">›</button> </div> |
1 2 3 4 5 6 7 8 9 10 11 | <div className="join"> <button className="join-item btn btn-sm" aria-label="Previous page">‹</button> <select className="join-item select select-sm" aria-label="Go to page"> <option>Page 1</option> <option>Page 2</option> <option>Page 3</option> <option>Page 4</option> <option>Page 5</option> </select> <button className="join-item btn btn-sm" aria-label="Next page">›</button> </div> |
Styl konturu
Użyj btn-outline na wszystkich przyciskach, aby uzyskać mniejszą wagę wizualną, która pasuje do sekcji treści dodatkowych i pasków bocznych.
1 2 3 4 5 6 7 | <div class="join"> <button class="join-item btn btn-outline btn-sm" aria-label="Previous page">‹</button> <button class="join-item btn btn-outline btn-sm">1</button> <button class="join-item btn btn-outline btn-sm btn-active">2</button> <button class="join-item btn btn-outline btn-sm">3</button> <button class="join-item btn btn-outline btn-sm" aria-label="Next page">›</button> </div> |
1 2 3 4 5 6 7 | <div className="join"> <button className="join-item btn btn-outline btn-sm" aria-label="Previous page">‹</button> <button className="join-item btn btn-outline btn-sm">1</button> <button className="join-item btn btn-outline btn-sm btn-active">2</button> <button className="join-item btn btn-outline btn-sm">3</button> <button className="join-item btn btn-outline btn-sm" aria-label="Next page">›</button> </div> |