Struct StatusBar 

pub struct StatusBar { /* private fields */ }

The one line at the foot of an app window that is always there: the version, what is going on in the background, a notice with its actions.

Where a Footer ends a page and wraps or stacks to show everything, a status bar keeps one fixed line: its sides keep their width and the center takes the rest, cutting what does not fit, so it never pushes the app around. Tinting the center with Self::center_tone makes a notice stand out without the whole bar shouting. The center is announced to screen readers as a status.

use ravenrs_widgets::{StatusBar, Tone, ViewExt};

let bar = StatusBar::new()
    .left((StatusBar::action("Version 1.2"),))
    .center((StatusBar::text("Version 1.3 is available").truncate().grow(1.0), StatusBar::action("Update")))
    .center_tone(Tone::Warning)
    .right((StatusBar::text("12 items"),));

Implementations

impl StatusBar

pub const HEIGHT: f32 = 28.0

Its height, in logical pixels, for what has to clear it.

pub fn new() -> StatusBar

An empty status bar.

pub fn text(text: impl Into<String>) -> Text

Text in a status bar’s usual look: small and muted.

pub fn action(label: impl Into<String>) -> Button

An action that fits the line: a mini ghost Button, with a focus ring and the keyboard. Add on_click to it.

pub fn left(self, items: impl ViewSeq + 'static) -> StatusBar

The views at the left end.

pub fn center(self, items: impl ViewSeq + 'static) -> StatusBar

The views in the middle, which get the width the sides leave. Give the text .truncate().grow(1.0) so that it is what gets cut.

pub fn right(self, items: impl ViewSeq + 'static) -> StatusBar

The views at the right end.

pub fn center_tone(self, tone: Tone) -> StatusBar

Tints the middle, and only the middle, to make a notice stand out.

Trait Implementations

impl Debug for StatusBar

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

Formats the value using the given formatter.

impl Default for StatusBar

fn default() -> StatusBar

Returns the “default value” for a type.

impl View for StatusBar

fn build(&self, cx: &mut BuildCx<'_>) -> NodeId

Creates this view’s node for the current build.

fn type_name(&self) -> &'static str

The name the diagnostics panel shows this view’s cost under.