pub struct Accordion<A = ()> { /* private fields */ }Expand description
A controlled, bound, or internally managed set of collapsible sections.
Open lists are de-duplicated in order; single mode keeps only the first ID.
Unknown IDs are retained in state but mount no content. Headers activate on
left-button release or pressed Enter/Space. Bound/internal mode writes the
new sanitized list; controlled mode only reports through on_toggle and
requires the consumer to update its binding.
§Examples
use ailloli_ui_widgets::controls::{Accordion, AccordionItem};
let accordion = Accordion::<()>::new()
.item(AccordionItem::new("one", "One"))
.default_open("one");
let _ = accordion;Implementations§
Source§impl<A: 'static> Accordion<A>
impl<A: 'static> Accordion<A>
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_widgets::layout::Container;
let widget: Container<()> = Container::new().height(40.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_widgets::layout::Container;
let widget: Container<()> = Container::new().min_width(40.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_widgets::layout::Container;
let widget: Container<()> = Container::new().max_width(320.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_widgets::layout::Container;
let widget: Container<()> = Container::new().min_height(24.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_widgets::layout::Container;
let widget: Container<()> = Container::new().max_height(240.0);
let _ = widget;Sourcepub fn fill(self) -> Self
pub fn fill(self) -> Self
Sets both preferred axes to parent fill.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().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_widgets::layout::Container;
let widget: Container<()> = Container::new().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_widgets::layout::Container;
let widget: Container<()> = Container::new().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_widgets::layout::Container;
let widget: Container<()> = Container::new().margin(8.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_widgets::layout::Container;
let widget: Container<()> = Container::new().padding(8.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_widgets::layout::Container;
let widget: Container<()> = Container::new().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_widgets::layout::Container;
let widget: Container<()> = Container::new().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_widgets::layout::Container;
let widget: Container<()> = Container::new().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_widgets::layout::Container;
let widget: Container<()> = Container::new().flex_basis(80.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;
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().align_self(AlignItems::Center);
let _ = widget;Source§impl<A: 'static> Accordion<A>
impl<A: 'static> Accordion<A>
Sourcepub fn new() -> Self
pub fn new() -> Self
Creates an empty single-open accordion with no initially open IDs.
§Examples
use ailloli_ui_widgets::controls::Accordion;
let accordion: Accordion<()> = Accordion::new();
let _ = accordion;Sourcepub fn single(self) -> Self
pub fn single(self) -> Self
Selects single-open mode and truncates default IDs to the first.
External controlled/bound lists are sanitized when read; this builder does not mutate their source.
§Examples
use ailloli_ui_widgets::controls::Accordion;
let accordion: Accordion<()> = Accordion::new().multiple().single();
let _ = accordion;Sourcepub fn multiple(self) -> Self
pub fn multiple(self) -> Self
Selects multiple-open mode without changing current default IDs.
§Examples
use ailloli_ui_widgets::controls::Accordion;
let accordion: Accordion<()> = Accordion::new().multiple();
let _ = accordion;Sourcepub fn mode(self, mode: AccordionMode) -> Self
pub fn mode(self, mode: AccordionMode) -> Self
Sets open cardinality and truncates defaults when selecting single mode.
§Examples
use ailloli_ui_widgets::controls::{Accordion, AccordionMode};
let accordion: Accordion<()> = Accordion::new().mode(AccordionMode::Multiple);
let _ = accordion;Sourcepub fn item(self, item: AccordionItem<A>) -> Self
pub fn item(self, item: AccordionItem<A>) -> Self
Appends one item in display order.
IDs are not validated for uniqueness or membership in existing open lists.
§Examples
use ailloli_ui_widgets::controls::{Accordion, AccordionItem};
let accordion = Accordion::<()>::new().item(AccordionItem::new("one", "One"));
let _ = accordion;Sourcepub fn default_open(self, id: impl Into<String>) -> Self
pub fn default_open(self, id: impl Into<String>) -> Self
Adds an initially open ID according to the current mode.
Single mode replaces the list with id; multiple mode appends only when
absent. The ID need not match an item. External open state overrides it.
§Examples
use ailloli_ui_widgets::controls::Accordion;
let accordion: Accordion<()> = Accordion::new().default_open("general");
let _ = accordion;Sourcepub fn default_open_many(
self,
ids: impl IntoIterator<Item = impl Into<String>>,
) -> Self
pub fn default_open_many( self, ids: impl IntoIterator<Item = impl Into<String>>, ) -> Self
Replaces initial open IDs after stable de-duplication.
Input order is preserved. Single mode retains at most the first distinct ID; multiple mode retains every distinct ID, including unknown ones.
§Examples
use ailloli_ui_widgets::controls::Accordion;
let accordion: Accordion<()> =
Accordion::new().multiple().default_open_many(["one", "one", "two"]);
let _ = accordion;Sourcepub fn open_ids(self, ids: impl Into<Binding<Vec<String>>>) -> Self
pub fn open_ids(self, ids: impl Into<Binding<Vec<String>>>) -> Self
Sets controlled static or reactive open IDs.
IDs are sanitized only when read. Toggle requests cannot mutate a purely
controlled source and should be handled through Self::on_toggle. This
method does not clear a writable signal installed by an earlier
Self::bind_open_ids call; choose one ownership mode per builder.
§Examples
use ailloli_ui_widgets::controls::Accordion;
let accordion: Accordion<()> = Accordion::new().open_ids(vec!["one".to_string()]);
let _ = accordion;Sourcepub fn bind_open_ids(self, ids: impl Into<Signal<Vec<String>>>) -> Self
pub fn bind_open_ids(self, ids: impl Into<Signal<Vec<String>>>) -> Self
Installs a writable signal for two-way open-ID state.
Toggles write a sanitized list to the signal before invoking the optional callback. The source itself is not sanitized until a toggle writes it.
§Examples
use std::{cell::RefCell, rc::Rc};
use ailloli_ui_runtime::component::Signal;
use ailloli_ui_widgets::controls::Accordion;
let ids = Signal::new(Rc::new(RefCell::new(vec!["one".to_string()])), Rc::new(|| {}));
let accordion: Accordion<()> = Accordion::new().bind_open_ids(ids);
let _ = accordion;Sourcepub fn accordion_style(self, style: AccordionStyle) -> Self
pub fn accordion_style(self, style: AccordionStyle) -> Self
Replaces the complete resolved style without changing mode or state.
§Examples
use ailloli_ui_core::Theme;
use ailloli_ui_widgets::controls::{Accordion, AccordionSize, AccordionStyle};
let style = AccordionStyle::from_theme(Theme::dark(), AccordionSize::Compact);
let accordion: Accordion<()> = Accordion::new().accordion_style(style);
let _ = accordion;Sourcepub fn accordion_size(self, size: AccordionSize) -> Self
pub fn accordion_size(self, size: AccordionSize) -> Self
Replaces the complete style with the default-theme built-in size.
§Examples
use ailloli_ui_widgets::controls::{Accordion, AccordionSize};
let accordion: Accordion<()> = Accordion::new().accordion_size(AccordionSize::Compact);
let _ = accordion;Sourcepub fn on_toggle(self, f: impl Fn(String, bool) -> A + 'static) -> Self
pub fn on_toggle(self, f: impl Fn(String, bool) -> A + 'static) -> Self
Maps each requested (id, open) state to an action and dispatches it.
The callback runs after bound/internal state is updated. In controlled mode it is the consumer’s opportunity to update open IDs.
§Examples
use ailloli_ui_widgets::controls::Accordion;
enum Action { Toggled(String, bool) }
let accordion = Accordion::new().on_toggle(|id, open| Action::Toggled(id, open));
let _ = accordion;Sourcepub fn on_toggle_ctx(
self,
f: impl Fn(&mut EventCtx<A>, String, bool) + 'static,
) -> Self
pub fn on_toggle_ctx( self, f: impl Fn(&mut EventCtx<A>, String, bool) + 'static, ) -> Self
Installs a context-aware toggle callback.
A later toggle-handler builder replaces it.
§Examples
use ailloli_ui_widgets::controls::Accordion;
let accordion = Accordion::<()>::new()
.on_toggle_ctx(|ctx, _id, _open| ctx.request_repaint());
let _ = accordion;