// Pagination -- page controls over a known total. // // // // The component owns no data. It reports the requested page through its // change output and lets the caller fetch or slice. // // NOTE: the style block uses /* */ comments only -- // is not a CSS comment // and silently swallows the rule that follows it. component Pagination { outputs { change(payload: { page: number; pageSize: number }) previous(payload: { page: number }) next(payload: { page: number }) } props { color: string = "primary" size: string = "default" page: number = 1 pageSize: number = 10 total: number = 0 variant: string = "compact" siblingCount: number = 1 showSummary: boolean = true label: string = "Pagination" previousLabel: string = "Previous" nextLabel: string = "Next" // Render links instead of buttons. `{page}` is replaced with the target // page number, e.g. hrefTemplate="/media/news?page={page}". Server-rendered // pages should prefer this: the controls then work before hydration and // without JavaScript, and each page is a real, crawlable URL. Buttons plus // the change output remain the default for client-owned lists. hrefTemplate: string = "" class: string = "" } functions { shared function lastPage() { var size = Number(pageSize) > 0 ? Number(pageSize) : 10 var count = Number(total) > 0 ? Number(total) : 0 return Math.max(1, Math.ceil(count / size)) } // Out-of-range values arrive routinely: page travels as an HTML attribute // and callers compute it from data that may have shrunk underneath them. shared function currentPage() { var value = Number(page) if (!value || value < 1) { return 1 } return Math.min(value, lastPage()) } shared function pageHref(target) { var clamped = Math.min(Math.max(1, Number(target) || 1), lastPage()) return String(hrefTemplate).split("{page}").join(String(clamped)) } shared function firstShown() { if (Number(total) < 1) { return 0 } return (currentPage() - 1) * (Number(pageSize) || 10) + 1 } shared function lastShown() { return Math.min(currentPage() * (Number(pageSize) || 10), Number(total) || 0) } shared function pageNumbers() { var last = lastPage() var current = currentPage() var siblings = Math.max(0, Number(siblingCount) || 0) var start = Math.max(1, current - siblings) var end = Math.min(last, current + siblings) var pages = [] if (start > 1) { pages.push({ value: 1, label: "1", gap: false }) if (start > 2) { pages.push({ value: 0, label: "...", gap: true }) } } for (var index = start; index <= end; index += 1) { pages.push({ value: index, label: String(index), gap: false }) } if (end < last) { if (end < last - 1) { pages.push({ value: 0, label: "...", gap: true }) } pages.push({ value: last, label: String(last), gap: false }) } return pages } client function goToPage(target) { var next = Math.min(Math.max(1, Number(target) || 1), lastPage()) output.change({ page: next, pageSize: Number(pageSize) || 10 }) } client function goPrevious() { var target = Math.max(1, currentPage() - 1) output.previous({ page: target }) output.change({ page: target, pageSize: Number(pageSize) || 10 }) } client function goNext() { var target = Math.min(lastPage(), currentPage() + 1) output.next({ page: target }) output.change({ page: target, pageSize: Number(pageSize) || 10 }) } } view { } style { .wrn-pagination { --pagination-accent: var(--wrn-color-primary); display: flex; flex-wrap: wrap; align-items: center; justify-content: space-between; gap: 0.75rem; max-width: 100%; } .wrn-pagination[data-color="secondary"] { --pagination-accent: var(--wrn-color-secondary); } .wrn-pagination[data-color="success"] { --pagination-accent: var(--wrn-color-success); } .wrn-pagination[data-color="danger"] { --pagination-accent: var(--wrn-color-danger); } .wrn-pagination[data-color="info"] { --pagination-accent: var(--wrn-color-info); } .wrn-pagination[data-size="sm"] { font-size: 0.82rem; } .wrn-pagination[data-size="lg"] { font-size: 1rem; } .wrn-pagination__summary { margin: 0; color: var(--wrn-color-text-muted); font-size: 0.82rem; } .wrn-pagination__controls { display: flex; align-items: center; gap: 0.35rem; flex-wrap: wrap; } .wrn-pagination__pages { display: flex; align-items: center; gap: 0.25rem; margin: 0; padding: 0; list-style: none; } .wrn-pagination__slot { display: inline-flex; } .wrn-pagination__page, .wrn-pagination__step { appearance: none; display: inline-flex; align-items: center; gap: 0.35rem; min-width: 2.25rem; justify-content: center; padding: 0.4rem 0.6rem; border: 1px solid var(--wrn-color-border); border-radius: var(--wrn-radius-sm); background: var(--wrn-color-surface); color: var(--wrn-color-text); font: inherit; font-size: 0.85rem; cursor: pointer; text-decoration: none; } .wrn-pagination__page:hover, .wrn-pagination__step:hover { background: var(--wrn-color-surface-soft); } /* The href variant renders anchors, which cannot be disabled the way a button can. At the first or last page the control is marked disabled and made inert so it neither responds nor takes focus. */ .wrn-pagination__page[data-disabled="true"], .wrn-pagination__step[data-disabled="true"] { opacity: 0.5; pointer-events: none; cursor: default; } .wrn-pagination__page:focus-visible, .wrn-pagination__step:focus-visible { outline: 2px solid var(--pagination-accent); outline-offset: 2px; } .wrn-pagination__page[data-active="true"] { border-color: var(--pagination-accent); background: var(--pagination-accent); color: var(--wrn-color-primary-contrast); font-weight: 700; } .wrn-pagination__gap { padding: 0 0.35rem; color: var(--wrn-color-text-muted); } .wrn-pagination__compact { margin: 0; padding: 0 0.5rem; color: var(--wrn-color-text-muted); font-size: 0.85rem; } /* Below the small breakpoint the word labels crowd the arrows out. */ @media (max-width: 639px) { .wrn-pagination { justify-content: center; } .wrn-pagination__step-label { display: none; } .wrn-pagination__summary { width: 100%; text-align: center; } } } }