pub struct Autocomplete<A = ()> { /* private fields */ }Expand description
Editable free-text field with a filtered suggestion popup.
Typing always updates the bound text signal. Activating an enabled suggestion
replaces it with the suggestion label and invokes on_select; arbitrary text
remains valid and need not match an item.
§Examples
use ailloli_ui_runtime::component::State;
use ailloli_ui_widgets::controls::Autocomplete;
let value = State::new(String::new());
let autocomplete: Autocomplete<()> = Autocomplete::new().bind(value).suggestion("Apple");
let _ = autocomplete;Implementations§
Source§impl<A: 'static> Autocomplete<A>
impl<A: 'static> Autocomplete<A>
Sourcepub fn new() -> Self
pub fn new() -> Self
Creates an enabled, unbound autocomplete with no suggestions.
The placeholder is Type to search..., the popup starts closed, and an
internal empty text signal is allocated when the component builds.
§Examples
use ailloli_ui_widgets::controls::Autocomplete;
let autocomplete: Autocomplete<()> = Autocomplete::new();
let _ = autocomplete;Sourcepub fn bind(self, value: impl Into<Signal<String>>) -> Self
pub fn bind(self, value: impl Into<Signal<String>>) -> Self
Binds the editable text to a writable signal.
Both free typing and suggestion activation update this signal.
§Examples
use ailloli_ui_runtime::component::State;
use ailloli_ui_widgets::controls::Autocomplete;
let autocomplete: Autocomplete<()> = Autocomplete::new().bind(State::new("ap".to_string()));
let _ = autocomplete;Sourcepub fn placeholder(self, placeholder: impl Into<Binding<String>>) -> Self
pub fn placeholder(self, placeholder: impl Into<Binding<String>>) -> Self
Replaces the static or reactive empty-text placeholder.
§Examples
use ailloli_ui_widgets::controls::Autocomplete;
let autocomplete: Autocomplete<()> = Autocomplete::new().placeholder("Find fruit...");
let _ = autocomplete;Sourcepub fn suggestion(self, label: impl Into<String>) -> Self
pub fn suggestion(self, label: impl Into<String>) -> Self
Appends an enabled, iconless suggestion.
§Examples
use ailloli_ui_widgets::controls::Autocomplete;
let autocomplete: Autocomplete<()> = Autocomplete::new().suggestion("Apple");
let _ = autocomplete;Sourcepub fn autocomplete_item(self, item: AutocompleteItem) -> Self
pub fn autocomplete_item(self, item: AutocompleteItem) -> Self
Appends a fully configured suggestion.
§Examples
use ailloli_ui_widgets::controls::{Autocomplete, AutocompleteItem};
let autocomplete: Autocomplete<()> = Autocomplete::new()
.autocomplete_item(AutocompleteItem::new("Apple").disabled(true));
let _ = autocomplete;Sourcepub fn disabled(self, disabled: impl Into<Binding<bool>>) -> Self
pub fn disabled(self, disabled: impl Into<Binding<bool>>) -> Self
Sets the static or reactive whole-control disabled state.
Disabled autocomplete fields are not focusable, ignore events, and close an open popup during layout.
§Examples
use ailloli_ui_widgets::controls::Autocomplete;
let autocomplete: Autocomplete<()> = Autocomplete::new().disabled(true);
let _ = autocomplete;Sourcepub fn disabled_signal(self, disabled: Memo<bool>) -> Self
pub fn disabled_signal(self, disabled: Memo<bool>) -> Self
Uses a memo as the reactive whole-control disabled binding.
§Examples
use ailloli_ui_runtime::component::Memo;
use ailloli_ui_widgets::controls::Autocomplete;
let autocomplete: Autocomplete<()> = Autocomplete::new().disabled_signal(Memo::new(|| false));
let _ = autocomplete;Sourcepub fn default_open(self, open: bool) -> Self
pub fn default_open(self, open: bool) -> Self
Sets only the popup’s initial open state.
§Examples
use ailloli_ui_widgets::controls::Autocomplete;
let autocomplete: Autocomplete<()> = Autocomplete::new().default_open(true);
let _ = autocomplete;Sourcepub fn autocomplete_style(self, style: AutocompleteStyle) -> Self
pub fn autocomplete_style(self, style: AutocompleteStyle) -> Self
Replaces the input and popup style without altering explicit layout values.
§Examples
use ailloli_ui_widgets::controls::{Autocomplete, AutocompleteStyle};
let autocomplete: Autocomplete<()> = Autocomplete::new()
.autocomplete_style(AutocompleteStyle::default());
let _ = autocomplete;Sourcepub fn autocomplete_size(self, size: AutocompleteSize) -> Self
pub fn autocomplete_size(self, size: AutocompleteSize) -> Self
Re-derives the style from the default theme and requested density.
This overwrites every prior style customization.
§Examples
use ailloli_ui_widgets::controls::{Autocomplete, AutocompleteSize};
let autocomplete: Autocomplete<()> = Autocomplete::new()
.autocomplete_size(AutocompleteSize::Compact);
let _ = autocomplete;Sourcepub fn on_select(self, f: impl Fn(String) -> A + 'static) -> Self
pub fn on_select(self, f: impl Fn(String) -> A + 'static) -> Self
Dispatches the application action returned for an activated suggestion.
The exact label is written to the bound signal before this callback. Free typing does not invoke it.
§Examples
use ailloli_ui_widgets::controls::Autocomplete;
let autocomplete: Autocomplete<String> = Autocomplete::new().on_select(|label| label);
let _ = autocomplete;Sourcepub fn on_select_ctx(
self,
f: impl Fn(&mut EventCtx<A>, String) + 'static,
) -> Self
pub fn on_select_ctx( self, f: impl Fn(&mut EventCtx<A>, String) + 'static, ) -> Self
Handles an activated suggestion with direct event-context access.
§Examples
use ailloli_ui_widgets::controls::Autocomplete;
let autocomplete: Autocomplete<()> = Autocomplete::new()
.on_select_ctx(|_ctx, _label| {});
let _ = autocomplete;Sourcepub fn width(self, value: impl Into<Length>) -> Self
pub fn width(self, value: impl Into<Length>) -> Self
Sets the trigger layout width in logical pixels or another [Length].
§Examples
use ailloli_ui_widgets::controls::Autocomplete;
let autocomplete: Autocomplete<()> = Autocomplete::new().width(260.0);
let _ = autocomplete;Sourcepub fn height(self, value: impl Into<Length>) -> Self
pub fn height(self, value: impl Into<Length>) -> Self
Sets the trigger layout height in logical pixels or another [Length].
§Examples
use ailloli_ui_widgets::controls::Autocomplete;
let autocomplete: Autocomplete<()> = Autocomplete::new().height(40.0);
let _ = autocomplete;Sourcepub fn fill_width(self) -> Self
pub fn fill_width(self) -> Self
Makes the trigger fill its available horizontal layout space.
§Examples
use ailloli_ui_widgets::controls::Autocomplete;
let autocomplete: Autocomplete<()> = Autocomplete::new().fill_width();
let _ = autocomplete;