Struct Paging 

pub struct Paging {
    pub window: Window,
    pub paged: bool,
}

Where a reader is in a set that arrived in parts.

A Window wearing the paged reading of itself. Distinct from a carousel’s window at the top level on purpose, because the intent differs and a call site should say which one it means, while the arithmetic below is shared so the two cannot drift apart.

The two idioms, and which one a renderer may draw

Load-more and numbered pages are both this type. Which is honest is paged: a set whose page size is known can be drawn as “Page 3 of 8”, and one without can only be drawn as “150 of 400” and a way forward. Saying it here rather than letting each renderer guess is the point — three renderers inferring it from the numbers is how they come to disagree.

What it does not carry

No addresses. makeover-layout cannot name an action, and the way to ask for the next part is the host’s: quasi_router pairs this with the addresses the same way Row pairs its parts with Row::activate. That split is the reason this type is reusable by a carousel, which has nothing to ask.

Fields

window: Window

The window onto the set.

paged: bool

Whether the parts are a fixed size, and so whether pages are countable.

false for load-more, where the window simply grew and “page 2” would name nothing.

Implementations

impl Paging

pub const fn pages(from: usize, per: usize) -> Self

A page of per, starting at from.

pub const fn more(shown: usize) -> Self

The first shown, with more behind them.

The load-more shape: the window starts at the beginning and grows, so there is no page to number.

pub const fn of(self, of: usize) -> Self

How many there are altogether.

Left unsaid by a host that cannot count, and left unsaid for good: a total arriving later widens whatever prints it. See “First paint is final paint” in the crate header.

pub const fn page(self) -> Option<usize>

Which page this is, counting from one, when pages are countable.

One-based because it is read aloud. Window::index is the zero-based form for anyone indexing with it.

pub const fn pages_total(self) -> Option<usize>

How many pages there are, when that is countable.

pub const fn shown(self) -> usize

How many are on screen.

pub const fn total(self) -> Option<usize>

How many there are, when the host counted.

pub const fn remaining(self) -> Option<usize>

How many are not shown yet, when the host counted.

The figure a load-more control puts in its label. None is the honest and common case: a set that cannot say how many more there are still has a way to ask for them.

pub const fn has_more(self) -> bool

Whether there is anything further on.

pub const fn has_previous(self) -> bool

Whether there is anything back the other way.

Trait Implementations

impl Clone for Paging

fn clone(&self) -> Paging

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for Paging

impl Debug for Paging

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Paging

fn default() -> Paging

Returns the “default value” for a type.

impl Eq for Paging

impl PartialEq for Paging

fn eq(&self, other: &Paging) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Paging