Struct BarChart 

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

Bars measured in eighths of a cell, with labels and values.

Horizontal by default: one row per bar, labels on the left, values on the right. Vertical charts stand bars side by side with the value above and the label below each. Bars scale to the largest value unless a maximum is given. On narrow areas horizontal charts drop their labels first; vertical bars get thinner and labels are cut with …. ASCII mode fills whole cells.

A chart of Series shows several values per category: side by side by default, or as segments of one bar with stacked. Series take their tones from the theme, walking a ramp from the accent towards the faint end so neighbouring shares read apart without a second accent colour; a horizontal segment writes its series name inside itself when the name fits, so a stack is not read by colour alone.

The chart answers the pointer and the keyboard once it is given on_select: the hovered and the selected category rise on a raised ground, a horizontal chart marks the selected row with the accent pillar in its own lead cell, and the arrow keys along the bars’ axis (↑/↓ or k/j horizontally, ←/→ or h/l vertically) with Home and End move the selection. Nothing moves or resizes when a category is hovered or selected: a chart is not a list, so it never slides.

Style keys: bar-chart and bar-chart.<variant> (fill), bar-chart-bar with hover, selected and focus (bg, pillar), bar-chart-label (fg), bar-chart-value and bar-chart-value.<variant> (fg, bold). Series take the theme’s series-<n> colour tokens when it has them.

Implementations

impl<Msg> BarChart<Msg>

pub fn new(bars: impl IntoIterator<Item = Bar>) -> Self

A horizontal chart of bars.

pub fn series( labels: impl IntoIterator<Item = impl Into<String>>, series: impl IntoIterator<Item = Series>, ) -> Self

A chart of the categories labels with one value per category in every series of series.

The series of a category stand next to each other; stacked puts them in one bar instead. A chart of a single series looks exactly like a chart of plain bars.

pub fn stacked(self) -> Self

Draws the series as segments of one bar per category instead of bars next to each other.

pub fn vertical(self) -> Self

Stands the bars up side by side.

pub fn max(self, max: f32) -> Self

The value of a full bar, e.g. 100.0 for percentages; the largest value by default. A stacked chart scales to the largest category total instead.

pub fn gap(self, cells: u16) -> Self

Empty rows (horizontal) or columns (vertical) between bars; 1 by default, so neighbouring bars never merge into one block. Vertical charts keep at least one column. The bars of one category stand right next to each other, so a group reads as one shape.

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

Unit written after every value the chart itself formats, e.g. "h" for hours. A bar with its own value_text keeps that text as it is.

pub fn selected(self, category: Option<usize>) -> Self

The selected category, which rises on a raised ground.

pub fn disabled(self, disabled: bool) -> Self

Greys the chart out: it cannot be focused, hovered or selected.

pub fn on_select(self, message: impl Fn(usize) -> Msg + 'static) -> Self

Message for moving the selection to a category, which turns the chart’s pointer and keyboard handling on.

Trait Implementations

impl<Msg: 'static> Widget<Msg> for BarChart<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 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.

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 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.