Struct PieceStyle 

pub struct PieceStyle {

    pub content: Style,
    pub secondary: Style,
    pub muted: Style,
    pub info: Style,
    pub success: Style,
    pub warning: Style,
    pub danger: Style,
    pub page: Style,
    pub section: Style,
    pub subsection: Style,
    pub action: Style,
    pub filled: Style,
    pub sunken: Style,
    pub focus: Modifier,
    pub meter_cells: u16,
    pub meter_full: char,
    pub meter_empty: char,
    pub required_marker: &'static str,
}

The colours and marks the drawings below use.

TableStyle’s shape, for its reasons: an ungated struct of styles with a Default, plus a from_theme that is what a consumer holding a loaded theme should reach for first. A consumer painting bevels and nothing else should not have to supply text tones it never uses, and gating the whole module on theme would make these unreachable to anyone hand-picking colours.

The default is the one that survives a terminal with no colour at all: modifiers only, no foreground anywhere. That is not a placeholder. A two-colour terminal is the case where a Style carrying a foreground is a foreground that will not land, and bold-and-reversed is what is left.

Fields

content: Style

Ordinary content, and what Tone::Neutral reads as.

secondary: Style

Content one step back: a field’s label, a quoted run.

muted: Style

Content two steps back: a caption, a hint, a meter’s reading.

info: Style

Something worth knowing and nothing to do about it.

success: Style

Something finished and it worked.

warning: Style

Something the user should look at.

danger: Style

Something broken, or about to be destroyed.

page: Style

A page title.

section: Style

A section title.

subsection: Style

A subsection title.

action: Style

Text that goes somewhere, and a control’s label.

filled: Style

A control filled with the action colour, for the one on a screen that is the thing to press. A form’s submit is the case that has it.

sunken: Style

A surface set back from the one it sits on, by colour and nothing else. What a code run takes, since every cell is monospace and the thing a webview says with a typeface cannot be said that way here.

focus: Modifier

What “you are on this one” adds to whatever it lands on.

Reversed video by default, which is the affordance a cell has left once colour is spent on tone and bold on weight. A webview says it with an outline; a terminal has no outline that is not four more cells.

meter_cells: u16

How many cells meter spends on its bar.

meter_full: char

The filled part of a bar.

meter_empty: char

The empty part of a bar.

required_marker: &'static str

What marks a compulsory field, appended to its label.

A knob for makeover-immediate’s reason: it is the one piece of copy here, and copy is not a renderer’s call.

Implementations

impl PieceStyle

pub const fn tone(&self, tone: Tone) -> Style

The style a tone reads as.

Tone is closed and stays closed, so this is total and needs no fallback arm.

pub const fn heading(&self, level: Heading) -> Style

The style a heading reads as.

pub fn focused(&self, focused: bool, style: Style) -> Style

style, plus the mark that says the user is on this one.

Takes the flag rather than being called behind an if, because every caller has a bool in hand and the branch is the part that gets forgotten.

Trait Implementations

impl Clone for PieceStyle

fn clone(&self) -> PieceStyle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for PieceStyle

impl Debug for PieceStyle

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

Formats the value using the given formatter.

impl Default for PieceStyle

fn default() -> Self

Modifiers only, no foreground: what survives a terminal with two colours.

impl Eq for PieceStyle

impl PartialEq for PieceStyle

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PieceStyle