Struct EmptyState 

pub struct EmptyState<Msg> { /* private fields */ }

A centred block explaining why an area is empty and what to do about it.

Reads, from top to bottom: an optional muted icon, a title, an optional explanation that wraps to at most 52 cells, and an optional action button. When the area is short, the icon goes first, then the space above the action, then explanation lines; the title and the action stay.

Style keys: empty-state-icon (fg), empty-state-title (fg, bold), empty-state-message (fg).

Implementations

impl<Msg: Clone + 'static> EmptyState<Msg>

pub fn new(title: impl Into<String>) -> Self

An empty state reading title, e.g. “No containers yet”.

pub fn icon(self, key: impl Into<String>) -> Self

Icon key drawn above the title in a muted colour.

pub fn message(self, message: impl Into<String>) -> Self

One or two sentences under the title: why it is empty, or what will appear here.

pub fn action(self, button: Button<Msg>) -> Self

The way out, e.g. Button::new("Create container").variant("primary").on_press(..).

Trait Implementations

impl<Msg: Clone + 'static> Widget<Msg> for EmptyState<Msg>

fn measure(&self, _cx: &mut MeasureCx<'_>, available: Size) -> Size

The size the widget wants when it may use up to available.

fn paint(&self, cx: &mut PaintCx<'_>, area: Rect)

Draws the widget into area.

fn children(&self) -> &[Node<Msg>]

Child nodes, for widgets that contain other widgets.

fn children_mut(&mut self) -> &mut [Node<Msg>]

Mutable child nodes, used to assign ids.

fn paint_overlay(&self, _cx: &mut PaintCx<'_>, _anchor: Rect)

Draws the widget’s overlay after the whole view was painted, when it asked for one with PaintCx::request_overlay. anchor is the area the widget was painted in.

fn event(&self, _cx: &mut EventCx<'_, Msg>, _event: &Event) -> bool

Handles input. Returns true when the event was used; unused key and scroll events bubble to the parent widget.

fn focusable(&self) -> bool

Whether the widget can take keyboard focus.