pub struct BarChart { /* private fields */ }Expand description
A grouped vertical bar chart with optional x-axis labels.
Each added series forms one bar per point index. Point x coordinates are
ignored; non-finite y values are skipped. The longest series determines
group count, and labels are independently distributed across the plot, so a
mismatched label count does not automatically align with groups. The first
series name is used as the title; no legend is drawn.
§Examples
use ailloli_ui_widgets::controls::BarChart;
let chart = BarChart::new()
.series("Requests", [12.0, 18.0, 9.0])
.labels(["Mon", "Tue", "Wed"]);
let _ = chart;Implementations§
Source§impl BarChart
impl BarChart
Sourcepub fn width(self, value: impl Into<Length>) -> Self
pub fn width(self, value: impl Into<Length>) -> Self
Sets preferred width from a logical-pixel or length value.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).width(24.0);
let _ = widget;Sourcepub fn height(self, value: impl Into<Length>) -> Self
pub fn height(self, value: impl Into<Length>) -> Self
Sets preferred height from a logical-pixel or length value.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).height(24.0);
let _ = widget;Sourcepub fn min_width(self, value: impl Into<Length>) -> Self
pub fn min_width(self, value: impl Into<Length>) -> Self
Sets the minimum width bound.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).min_width(12.0);
let _ = widget;Sourcepub fn max_width(self, value: impl Into<Length>) -> Self
pub fn max_width(self, value: impl Into<Length>) -> Self
Sets the maximum width bound.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).max_width(32.0);
let _ = widget;Sourcepub fn min_height(self, value: impl Into<Length>) -> Self
pub fn min_height(self, value: impl Into<Length>) -> Self
Sets the minimum height bound.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).min_height(12.0);
let _ = widget;Sourcepub fn max_height(self, value: impl Into<Length>) -> Self
pub fn max_height(self, value: impl Into<Length>) -> Self
Sets the maximum height bound.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).max_height(32.0);
let _ = widget;Sourcepub fn fill(self) -> Self
pub fn fill(self) -> Self
Sets both preferred axes to parent fill.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).fill();
let _ = widget;Sourcepub fn fill_width(self) -> Self
pub fn fill_width(self) -> Self
Sets preferred width to parent fill.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).fill_width();
let _ = widget;Sourcepub fn fill_height(self) -> Self
pub fn fill_height(self) -> Self
Sets preferred height to parent fill.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).fill_height();
let _ = widget;Sourcepub fn margin(self, value: f32) -> Self
pub fn margin(self, value: f32) -> Self
Sets uniform outer margin in logical pixels.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).margin(4.0);
let _ = widget;Sourcepub fn padding(self, value: f32) -> Self
pub fn padding(self, value: f32) -> Self
Sets uniform inner padding in logical pixels.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).padding(4.0);
let _ = widget;Sourcepub fn flex_grow(self) -> Self
pub fn flex_grow(self) -> Self
Sets flex-grow weight to one.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).flex_grow();
let _ = widget;Sourcepub fn flex_grow_by(self, value: f32) -> Self
pub fn flex_grow_by(self, value: f32) -> Self
Sets a dimensionless flex-grow weight.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).flex_grow_by(2.0);
let _ = widget;Sourcepub fn flex_shrink(self, value: f32) -> Self
pub fn flex_shrink(self, value: f32) -> Self
Sets a dimensionless flex-shrink weight.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).flex_shrink(1.0);
let _ = widget;Sourcepub fn flex_basis(self, value: impl Into<Length>) -> Self
pub fn flex_basis(self, value: impl Into<Length>) -> Self
Sets the preferred main-axis flex basis.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).flex_basis(20.0);
let _ = widget;Sourcepub fn align_self(self, value: AlignItems) -> Self
pub fn align_self(self, value: AlignItems) -> Self
Overrides cross-axis alignment for this flex item.
§Examples
use ailloli_ui_core::{style::AlignItems, IconId};
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).align_self(AlignItems::Center);
let _ = widget;Source§impl BarChart
impl BarChart
Sourcepub fn new() -> Self
pub fn new() -> Self
Creates an empty chart with automatic y-range and "No data" text.
§Examples
use ailloli_ui_widgets::controls::BarChart;
let chart = BarChart::new();
let _ = chart;Sourcepub fn series(
self,
name: impl Into<String>,
values: impl IntoIterator<Item = f32>,
) -> Self
pub fn series( self, name: impl Into<String>, values: impl IntoIterator<Item = f32>, ) -> Self
Appends a named series whose x coordinates are zero-based indices.
Values, including non-finite values, are retained; the painter skips non-finite y values. Empty series are allowed.
§Examples
use ailloli_ui_widgets::controls::BarChart;
let chart = BarChart::new().series("CPU", [20.0, 35.0]);
let _ = chart;Sourcepub fn chart_series(self, series: ChartSeries) -> Self
pub fn chart_series(self, series: ChartSeries) -> Self
Appends an existing series without normalization.
Its x coordinates are ignored by bar placement.
§Examples
use ailloli_ui_core::ChartSeries;
use ailloli_ui_widgets::controls::BarChart;
let chart = BarChart::new().chart_series(ChartSeries::from_values("CPU", [1.0, 2.0]));
let _ = chart;Sourcepub fn labels<I, S>(self, labels: I) -> Self
pub fn labels<I, S>(self, labels: I) -> Self
Replaces all x-axis labels with values collected in iterator order.
Labels are spread according to their own count, independently of bar groups. Empty text remains a label; an empty iterator hides the label row.
§Examples
use ailloli_ui_widgets::controls::BarChart;
let chart = BarChart::new().labels(["Q1", "Q2"]);
let _ = chart;Sourcepub fn range(self, min: f32, max: f32) -> Self
pub fn range(self, min: f32, max: f32) -> Self
Sets an explicit y-domain after finite/order/degeneracy sanitization.
Reversed bounds are swapped, non-finite bounds fall back to 0/1, and
nearly equal bounds are widened when representable. Values outside the
domain are clamped to the plot edges.
§Examples
use ailloli_ui_widgets::controls::BarChart;
let chart = BarChart::new().range(-100.0, 100.0);
let _ = chart;Sourcepub fn chart_style(self, style: ChartStyle) -> Self
pub fn chart_style(self, style: ChartStyle) -> Self
Replaces complete chart style and intrinsic geometry.
§Examples
use ailloli_ui_widgets::controls::{BarChart, ChartStyle};
let chart = BarChart::new().chart_style(ChartStyle::default());
let _ = chart;Sourcepub fn chart_size(self, size: ChartSize) -> Self
pub fn chart_size(self, size: ChartSize) -> Self
Replaces style with a default-theme built-in size.
§Examples
use ailloli_ui_widgets::controls::{BarChart, ChartSize};
let chart = BarChart::new().chart_size(ChartSize::Large);
let _ = chart;Sourcepub fn empty_text(self, text: impl Into<String>) -> Self
pub fn empty_text(self, text: impl Into<String>) -> Self
Replaces text painted when there are no points or no plot area.
Empty text is valid and paints no glyphs.
§Examples
use ailloli_ui_widgets::controls::BarChart;
let chart = BarChart::new().empty_text("Awaiting samples");
let _ = chart;