Pagination
Thành phần phân trang cao cấp được đồng bộ kích thước chuẩn mực với hệ thống Input và Button thông qua ControlSize. Tích hợp tính năng nhảy trang tương tác qua ellipsis (click để nhập hoặc dùng stepper), chọn số dòng hiển thị và tự động co giãn tỷ lệ font/icon theo từng kích thước.
1. Đồng bộ kích thước với Input và Button
Minh họa trực quan sự thẳng hàng tuyệt đối (100% khớp pixel chiều cao) giữa Input, Button và Pagination ở cả 4 cỡ.
Height: 24px (1.5rem)Height: 28px (1.75rem)Height: 34px (2.125rem)Height: 40px (2.5rem)2. Trình thử nghiệm tương tác (Interactive Playground)
Tùy chỉnh thông số trực tiếp để quan sát phản hồi động của component.
... để nhập số trang bất kỳ và nhấn Enter hoặc dùng phím mũi tên lên/xuống để nhảy trang siêu nhanh!3. Sử dụng độc lập từng thành phần con
Khi bạn chỉ cần thanh nút trang PaginationLinks hoặc thanh thông tin PaginationToolbar riêng rẽ.
4. Các trường hợp giới hạn (Edge Cases)
Kiểm tra hành vi của Pagination trong các trường hợp đặc biệt.
Thành phần links tự động ẩn khi tổng số trang ≤ 1 để giao diện gọn gàng.
Không xuất hiện dấu ba chấm ellipsis, tất cả các số trang đều hiển thị trực tiếp.
Xuất hiện cả hai đầu ellipsis, nút trang co giãn tự động theo độ dài ký tự số.
5. Hướng dẫn tích hợp mã nguồn
Mẫu mã nguồn chuẩn để import và sử dụng trong component hoặc route.
import { Pagination } from '~/components/ui/pagination';
// 1. Cách dùng trực tiếp dạng flat props (tiện lợi, ngắn gọn):
<Pagination
size="sm" // 'xs' | 'sm' | 'md' | 'lg' (mặc định 'md')
page={currentPage}
totalSize={totalRecords}
sizePerPage={pageSize}
sizePerPageList={[
{ text: '10 / trang', value: 10 },
{ text: '25 / trang', value: 25 },
]}
onPageChange={(page) => setPage(page)}
onSizePerPageChange={(size) => setPageSize(size)}
isLoading={isLoading}
/>
// 2. Cách dùng dạng paginationProps (tương thích 100% với TablePagination cũ):
<Pagination
size="md"
isLoading={isLoading}
paginationProps={{
page,
totalSize,
sizePerPage,
sizePerPageList,
onPageChange,
onSizePerPageChange,
}}
>
{/* children nếu cần hiển thị bảng hoặc danh sách bên trong */}
</Pagination>