Pagination
Browse a larger collection a page at a time.
use blinc_cn as cn;
use blinc_core::reactive::{Signal, computed};
use blinc_layout::{binding::IntoReactive, prelude::*};
pub fn pagination_demo(page: Signal<usize>) -> Div {
div()
.class("demo-wide")
.child(cn::pagination(10, page).visible_pages(5))
.child(bound_text(computed(move |g| format!("Page {} of 10", g.get(page).unwrap_or(1)))).class("demo-caption"))
}
fn bound_text(value: impl IntoReactive<String>) -> Text {
Text::bound(value.into_reactive())
}
@layer components {
.cn-pagination,
.cn-pagination-btn {
font-family: var(--font-sans);
}
.cn-pagination-btn:focus-visible {
outline: 2px solid var(--focus-ring);
outline-offset: 2px;
}
.cn-pagination {
gap: var(--space-1);
}
.cn-pagination-btn {
border: 1px solid var(--border);
border-radius: var(--radius-default);
cursor: pointer;
color: var(--text-primary);
transition: background var(--duration-fast) var(--ease-state),
border-color var(--duration-fast) var(--ease-state);
}
.cn-pagination-btn:hover {
background: var(--surface-elevated);
}
.cn-pagination-btn[aria-current="page"],
.cn-pagination-btn[aria-current="page"]:hover {
background: var(--primary);
border-color: var(--primary);
color: var(--text-inverse);
cursor: default;
}
.cn-pagination-btn:disabled,
.cn-pagination-btn:disabled:hover {
background: transparent;
opacity: 0.5;
cursor: not-allowed;
}
.cn-pagination-ellipsis {
color: var(--text-secondary);
}
}
Usage and properties
Browse a larger collection a page at a time. Apply CSS after the component layer to restyle the documented parts.
Use the installation guide to add blinc_cn and its component stylesheet. Create the fixture bindings once, and return the demo from your UI builder. Values marked Bound accept Signal/Computed sources where the API supports them; structural options configure the component at construction.
| Property | Type | Update model | This example |
|---|---|---|---|
page | Signal<usize> | Bound | 1 |
total / visible_pages | usize | Construction | 10 / 5 |
Keyboard and interaction
Tab reaches each page button and the previous and next buttons; Enter or Space selects. Unavailable buttons are skipped. :focus-visible marks keyboard focus.
Customizing it
Add application CSS after the default component layer. These selectors are the restyling surface for this component:
.cn-pagination.cn-pagination-ellipsis.cn-pagination-btn
Theme and component variables: --primary, --text-primary, --text-secondary, --surface, --border, --radius-default, --duration-fast, --ease-state.
Built-in themes
The Live theme control installs Blinc's own theme bundles, including their colours, focus rings, corner shapes and motion tokens.
pub fn theme_bundle_for(name: &str) -> blinc_theme::ThemeBundle {
match name {
"restrained" => blinc_theme::RestrainedTheme::bundle(),
"expressive" => blinc_theme::ExpressiveTheme::bundle(),
_ => blinc_theme::HybridTheme::bundle(),
}
.with_css(blinc_cn::cn_styles::CN_STYLES)
}Download the default widget and component stylesheets. Sample assets and licenses are available in the asset guide.
Documentation
From the canonical component guide.
Bind the current page to a Signal<usize>, Signal<i32> or float signal,
which is rounded to a page:
let page = ctx.use_signal(1usize);
pagination(10, page)
.visible_pages(7)
.show_first_last(true)
.on_page_change(|page| {
let _ = page;
})
Buttons are .cn-pagination-btn; the current page carries
aria-current="page", and unavailable arrows carry disabled.
Gaps are .cn-pagination-ellipsis.
Platforms and version
The component API is available in Blinc 0.6.0. The Live example runs in a dedicated worker and requires a compatible GPU surface. Preview and Code remain available when Live cannot start. The canvas has a descriptive label; a full screen-reader DOM mirror is not provided. The gallery integration is based on revision e2e55c24e078.
Recordings and live demos use the default Hybrid theme with bundled Noto Sans. The recording uses a 560 × 320 logical viewport at twice that resolution. Live follows its container and actual display density. Source base revision · Exact build source · Artifact versions and checksums · Font license.