pub struct DatePicker<A = ()> { /* private fields */ }Expand description
Controlled optional-date field with a six-week Monday-first calendar popup.
A is the application action returned by the non-context callback. Use
Self::bind for internal writes; Self::value is read-only. Optional
minimum and maximum dates are inclusive.
§Examples
use ailloli_ui_core::DateValue;
use ailloli_ui_widgets::controls::DatePicker;
let picker: DatePicker<()> = DatePicker::new().value(Some(DateValue::new(2026, 5, 1)));
let _ = picker;Implementations§
Source§impl<A: 'static> DatePicker<A>
impl<A: 'static> DatePicker<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> DatePicker<A>
impl<A: 'static> DatePicker<A>
Sourcepub fn new() -> Self
pub fn new() -> Self
Creates an enabled, unselected date picker with a closed popup.
The placeholder is Pick a date. Without a default month or selected
value, the calendar starts at May 2026; this is a deterministic sentinel,
not the current system date.
§Examples
use ailloli_ui_widgets::controls::DatePicker;
let picker: DatePicker<()> = DatePicker::new();
let _ = picker;Sourcepub fn value(self, value: impl Into<Binding<Option<DateValue>>>) -> Self
pub fn value(self, value: impl Into<Binding<Option<DateValue>>>) -> Self
Sets a read-only static or reactive optional date and clears writable binding.
Selecting a different date may invoke the callback, but cannot update this configured value.
§Examples
use ailloli_ui_core::DateValue;
use ailloli_ui_widgets::controls::DatePicker;
let picker: DatePicker<()> = DatePicker::new().value(Some(DateValue::new(2026, 5, 9)));
let _ = picker;Sourcepub fn bind(self, value: impl Into<Signal<Option<DateValue>>>) -> Self
pub fn bind(self, value: impl Into<Signal<Option<DateValue>>>) -> Self
Binds a writable optional-date signal.
Selecting a changed date writes Some(date) before invoking the callback;
the picker never emits or writes None itself.
§Examples
use ailloli_ui_core::DateValue;
use ailloli_ui_runtime::component::State;
use ailloli_ui_widgets::controls::DatePicker;
let selected = State::new(None::<DateValue>);
let picker: DatePicker<()> = DatePicker::new().bind(selected);
let _ = picker;Sourcepub fn min(self, value: DateValue) -> Self
pub fn min(self, value: DateValue) -> Self
Sets the inclusive earliest selectable date.
If it exceeds max, no date satisfies both bounds.
§Examples
use ailloli_ui_core::DateValue;
use ailloli_ui_widgets::controls::DatePicker;
let picker: DatePicker<()> = DatePicker::new().min(DateValue::new(2026, 1, 1));
let _ = picker;Sourcepub fn max(self, value: DateValue) -> Self
pub fn max(self, value: DateValue) -> Self
Sets the inclusive latest selectable date.
If it precedes min, no date satisfies both bounds.
§Examples
use ailloli_ui_core::DateValue;
use ailloli_ui_widgets::controls::DatePicker;
let picker: DatePicker<()> = DatePicker::new().max(DateValue::new(2026, 12, 31));
let _ = picker;Sourcepub fn placeholder(self, value: impl Into<Binding<String>>) -> Self
pub fn placeholder(self, value: impl Into<Binding<String>>) -> Self
Replaces the static or reactive no-selection label.
§Examples
use ailloli_ui_widgets::controls::DatePicker;
let picker: DatePicker<()> = DatePicker::new().placeholder("Departure");
let _ = picker;Sourcepub fn disabled(self, value: impl Into<Binding<bool>>) -> Self
pub fn disabled(self, value: impl Into<Binding<bool>>) -> Self
Sets static or reactive disabled state.
Disabled pickers are not focusable, ignore input, and do not paint or expose popup hit bounds.
§Examples
use ailloli_ui_widgets::controls::DatePicker;
let picker: DatePicker<()> = DatePicker::new().disabled(true);
let _ = picker;Sourcepub fn default_month(self, value: MonthValue) -> Self
pub fn default_month(self, value: MonthValue) -> Self
Sets the initial displayed month, taking precedence over selected value.
Month values created with MonthValue::new clamp month to 1..=12.
§Examples
use ailloli_ui_core::MonthValue;
use ailloli_ui_widgets::controls::DatePicker;
let picker: DatePicker<()> = DatePicker::new().default_month(MonthValue::new(2026, 5));
let _ = picker;Sourcepub fn default_open(self, open: bool) -> Self
pub fn default_open(self, open: bool) -> Self
Sets only the calendar popup’s initial open state.
§Examples
use ailloli_ui_widgets::controls::DatePicker;
let picker: DatePicker<()> = DatePicker::new().default_open(true);
let _ = picker;Sourcepub fn date_style(self, style: DatePickerStyle) -> Self
pub fn date_style(self, style: DatePickerStyle) -> Self
Replaces trigger and calendar style without altering explicit layout size.
§Examples
use ailloli_ui_widgets::controls::{DatePicker, DatePickerStyle};
let picker: DatePicker<()> = DatePicker::new().date_style(DatePickerStyle::default());
let _ = picker;Sourcepub fn date_size(self, size: DatePickerSize) -> Self
pub fn date_size(self, size: DatePickerSize) -> Self
Re-derives style from the default theme and requested density.
This overwrites every previous date-style customization.
§Examples
use ailloli_ui_widgets::controls::{DatePicker, DatePickerSize};
let picker: DatePicker<()> = DatePicker::new().date_size(DatePickerSize::Compact);
let _ = picker;Sourcepub fn on_change(self, f: impl Fn(DateValue) -> A + 'static) -> Self
pub fn on_change(self, f: impl Fn(DateValue) -> A + 'static) -> Self
Dispatches the application action returned for a newly selected date.
Equal selections and dates outside inclusive bounds emit nothing.
§Examples
use ailloli_ui_core::DateValue;
use ailloli_ui_widgets::controls::DatePicker;
let picker: DatePicker<DateValue> = DatePicker::new().on_change(|date| date);
let _ = picker;Sourcepub fn on_change_ctx(
self,
f: impl Fn(&mut EventCtx<A>, DateValue) + 'static,
) -> Self
pub fn on_change_ctx( self, f: impl Fn(&mut EventCtx<A>, DateValue) + 'static, ) -> Self
Handles a newly selected date with direct event-context access.
§Examples
use ailloli_ui_widgets::controls::DatePicker;
let picker: DatePicker<()> = DatePicker::new().on_change_ctx(|_ctx, _date| {});
let _ = picker;