amenui
en·中 github ↗ v0.0.1
01docs 02components 03lab 04works
en·中github ↗
×

docs / components / navigation / pagination docs / components / navigation /

pagination

04.29
On this page ▾
  1. Installation
  2. Usage
  3. API
  4. Keyboard and accessibility

Move between pages of results.

drawn by amenuiopen ↗

Installation

Components are distributed as source. Copy it and what it depends on into your project, then change it as you need:

sh
cargo run --release --bin amenui -- add pagination --to ../my-app

Files copied: src/widgets/pagination.rs, src/widgets/mod.rs

Usage

rust
use amenui::widgets::{pagination};

fn view() -> El<Msg> {
    pagination("pg1", 2, 12, Msg::Pick)
}

API

Functionspagination
Propskey, page (0-based), pages, msg.
Filessrc/widgets/pagination.rs
Depends onbase
Response to frontsnudge (a control: pushed as one piece by fronts, held and condensing at most to Look::legible_cap)
Recompositionkeyed labels recompose when their text changes

Keyboard and accessibility

Statesthe current page marked; previous / next disabled at the ends.
Keys and messagesmsg(i); numbers are keyed key:i, the steps key/prev, key/next.

On the web every control is mirrored into the page as an element with its role and name, so screen readers and the browser's own focus see it (DESIGN.md §1.14).