Enum RowPart 

#[non_exhaustive]
pub enum RowPart {
    Primary,
    Secondary,
    Meta,
    Actions,
    Tokens,
}

The parts of a list row.

Four to begin with, taken from Balanced Breakfast, which was the only consumer that had all of them (row-primary, row-secondary, row-meta, row-actions). audiofiles has two and no slot structure at all, so it gains meta and actions as real work rather than a rename; goingson moves off task-row / task-cell.

Tokens joined at 0.9.0, and #[non_exhaustive] with it. See the crate header for why the two arrived together.

Meta against Tokens

The line is whether the thing has its own standing. Meta is one short trailing fact about the row, written as text: a count, a size, a date. Tokens is a set of small labelled things, each of which can be toned and can answer a click. “3 files” is meta. A status badge that is amber, and a tag you can click to filter by, are tokens.

Keeping them apart is what a single widened slot would have foreclosed. A renderer can right-align one string and cannot usefully do the same to a strip of chips, and a fact that is not clickable should not be drawn as though it were.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Primary

The thing itself. What the row is called.

Secondary

Supporting text under the primary.

Meta

A short trailing fact: a count, a size, a date.

Actions

Controls that act on this row.

Tokens

Small labelled things belonging to the row: badges, chips, tags.

Each carries its own Token kind and Tone, so a renderer with no colour still has the kind to work with, and one with no chips still has the label. That is the constrained-consumer test this vocabulary exists to pass, and it is why the tone lives on the token rather than on the part.

Implementations

impl RowPart

pub const fn revealed_on_hover(self) -> bool

Whether the part stays hidden until the row is hovered or focused.

Behaviour of the part, not app policy: Balanced Breakfast and goingson grew the same hover-reveal on their actions independently and neither applies it to anything else.

A renderer with no hover shows it always. That is a renderer decision and this returning true does not forbid it.

pub const fn intent(self) -> &'static str

The content intent the part takes.

Trait Implementations

impl Clone for RowPart

fn clone(&self) -> RowPart

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for RowPart

impl Debug for RowPart

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

Formats the value using the given formatter.

impl Eq for RowPart

impl Hash for RowPart

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for RowPart

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for RowPart