pub struct ChatWidget<A = ()> { /* private fields */ }Expand description
Stateful transcript with message actions and a controlled composer.
A is the application action returned by non-context callbacks. The draft
is always signal-backed. Use Self::bind_session when session changes must
remain observable after construction; Self::new stores its session value
in private state.
§Examples
use ailloli_ui_core::{ChatSessionId, ChatSessionState};
use ailloli_ui_runtime::component::State;
use ailloli_ui_widgets::controls::ChatWidget;
let session = ChatSessionState::new(ChatSessionId::new("demo"), "Demo");
let widget: ChatWidget<()> = ChatWidget::new(Some(session), State::new(String::new()));
let _ = widget;Implementations§
Source§impl<A: 'static> ChatWidget<A>
impl<A: 'static> ChatWidget<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> ChatWidget<A>
impl<A: 'static> ChatWidget<A>
Sourcepub fn new(
session: Option<ChatSessionState>,
draft: impl Into<Signal<String>>,
) -> Self
pub fn new( session: Option<ChatSessionState>, draft: impl Into<Signal<String>>, ) -> Self
Creates a widget from a session snapshot and writable draft signal.
The snapshot is moved into private state and cannot subsequently be
replaced by the caller. Use Self::bind_session for a live session.
§Examples
use ailloli_ui_runtime::component::State;
use ailloli_ui_widgets::controls::ChatWidget;
let widget: ChatWidget<()> = ChatWidget::new(None, State::new("draft".to_string()));
let _ = widget;Sourcepub fn bind_session(
session: impl Into<Signal<Option<ChatSessionState>>>,
draft: impl Into<Signal<String>>,
) -> Self
pub fn bind_session( session: impl Into<Signal<Option<ChatSessionState>>>, draft: impl Into<Signal<String>>, ) -> Self
Creates a widget backed by live session and draft signals.
None renders the no-session state; Some with no messages renders the
empty-session state. The draft signal is updated by the text input before
SetComposerDraft is emitted.
§Examples
use ailloli_ui_core::ChatSessionState;
use ailloli_ui_runtime::component::State;
use ailloli_ui_widgets::controls::ChatWidget;
let session = State::new(None::<ChatSessionState>);
let draft = State::new(String::new());
let widget: ChatWidget<()> = ChatWidget::bind_session(session, draft);
let _ = widget;Sourcepub fn chat_style(self, style: ChatWidgetStyle) -> Self
pub fn chat_style(self, style: ChatWidgetStyle) -> Self
Replaces the chat style and resets preferred layout width and height.
Layout builders called after this method override those two dimensions.
§Examples
use ailloli_ui_runtime::component::State;
use ailloli_ui_widgets::controls::{ChatWidget, ChatWidgetStyle};
let style = ChatWidgetStyle { width: 640.0, height: 320.0, ..Default::default() };
let widget: ChatWidget<()> = ChatWidget::new(None, State::new(String::new())).chat_style(style);
let _ = widget;Sourcepub fn compact(self, compact: bool) -> Self
pub fn compact(self, compact: bool) -> Self
Enables or disables compact rendering without changing style geometry.
Use ChatWidgetStyle::compact through Self::chat_style to also apply
the compact padding, gaps, and 190-pixel preferred height.
§Examples
use ailloli_ui_runtime::component::State;
use ailloli_ui_widgets::controls::ChatWidget;
let widget: ChatWidget<()> = ChatWidget::new(None, State::new(String::new())).compact(true);
let _ = widget;Sourcepub fn on_action(self, f: impl Fn(ChatWidgetAction) -> A + 'static) -> Self
pub fn on_action(self, f: impl Fn(ChatWidgetAction) -> A + 'static) -> Self
Dispatches the application action returned for every widget action.
For Send, Copy, and Retry this callback runs before the corresponding specialized callback when both are configured.
§Examples
use ailloli_ui_runtime::component::State;
use ailloli_ui_widgets::controls::ChatWidget;
let widget = ChatWidget::new(None, State::new(String::new())).on_action(|_action| ());
let _ = widget;Sourcepub fn on_action_ctx(
self,
f: impl Fn(&mut EventCtx<A>, ChatWidgetAction) + 'static,
) -> Self
pub fn on_action_ctx( self, f: impl Fn(&mut EventCtx<A>, ChatWidgetAction) + 'static, ) -> Self
Handles every widget action with direct event-context access.
The handler may dispatch zero or multiple application actions and runs before specialized Send, Copy, or Retry handlers.
§Examples
use ailloli_ui_runtime::component::State;
use ailloli_ui_widgets::controls::ChatWidget;
let widget: ChatWidget<()> = ChatWidget::new(None, State::new(String::new()))
.on_action_ctx(|_ctx, _action| {});
let _ = widget;Sourcepub fn on_send(self, f: impl Fn(String) -> A + 'static) -> Self
pub fn on_send(self, f: impl Fn(String) -> A + 'static) -> Self
Dispatches the application action returned for submitted text.
Blank-after-trimming drafts are not submitted. Non-blank text is passed unchanged, including surrounding whitespace, and the draft is not cleared.
§Examples
use ailloli_ui_runtime::component::State;
use ailloli_ui_widgets::controls::ChatWidget;
let widget = ChatWidget::new(None, State::new("Hello".to_string())).on_send(|text| {
assert_eq!(text, "Hello");
});
let _ = widget;Sourcepub fn on_send_ctx(self, f: impl Fn(&mut EventCtx<A>, String) + 'static) -> Self
pub fn on_send_ctx(self, f: impl Fn(&mut EventCtx<A>, String) + 'static) -> Self
Handles submitted text with direct event-context access.
§Examples
use ailloli_ui_runtime::component::State;
use ailloli_ui_widgets::controls::ChatWidget;
let widget: ChatWidget<()> = ChatWidget::new(None, State::new(String::new()))
.on_send_ctx(|_ctx, _text| {});
let _ = widget;Sourcepub fn on_copy(self, f: impl Fn(ChatItemId, String) -> A + 'static) -> Self
pub fn on_copy(self, f: impl Fn(ChatItemId, String) -> A + 'static) -> Self
Dispatches the application action returned for a copy request.
The widget supplies the message ID and its current text but performs no clipboard write.
§Examples
use ailloli_ui_runtime::component::State;
use ailloli_ui_widgets::controls::ChatWidget;
let widget = ChatWidget::new(None, State::new(String::new()))
.on_copy(|_item_id, _text| ());
let _ = widget;Sourcepub fn on_copy_ctx(
self,
f: impl Fn(&mut EventCtx<A>, ChatItemId, String) + 'static,
) -> Self
pub fn on_copy_ctx( self, f: impl Fn(&mut EventCtx<A>, ChatItemId, String) + 'static, ) -> Self
Handles a copy request with direct event-context access.
§Examples
use ailloli_ui_runtime::component::State;
use ailloli_ui_widgets::controls::ChatWidget;
let widget: ChatWidget<()> = ChatWidget::new(None, State::new(String::new()))
.on_copy_ctx(|_ctx, _item_id, _text| {});
let _ = widget;Sourcepub fn on_retry(self, f: impl Fn(ChatItemId) -> A + 'static) -> Self
pub fn on_retry(self, f: impl Fn(ChatItemId) -> A + 'static) -> Self
Dispatches the application action returned for a retry request.
User messages are retryable. Assistant messages are retryable only when they carry a request ID; system and tool messages are never retryable.
§Examples
use ailloli_ui_runtime::component::State;
use ailloli_ui_widgets::controls::ChatWidget;
let widget = ChatWidget::new(None, State::new(String::new())).on_retry(|_item_id| ());
let _ = widget;Sourcepub fn on_retry_ctx(
self,
f: impl Fn(&mut EventCtx<A>, ChatItemId) + 'static,
) -> Self
pub fn on_retry_ctx( self, f: impl Fn(&mut EventCtx<A>, ChatItemId) + 'static, ) -> Self
Handles a retry request with direct event-context access.
§Examples
use ailloli_ui_runtime::component::State;
use ailloli_ui_widgets::controls::ChatWidget;
let widget: ChatWidget<()> = ChatWidget::new(None, State::new(String::new()))
.on_retry_ctx(|_ctx, _item_id| {});
let _ = widget;Sourcepub fn message_renderer(
self,
f: impl Fn(&ChatMessage) -> View<A> + 'static,
) -> Self
pub fn message_renderer( self, f: impl Fn(&ChatMessage) -> View<A> + 'static, ) -> Self
Replaces the complete built-in bubble for every message.
A custom view is responsible for body, metadata, and any Copy/Retry UI; it also bypasses the optimized retained transcript renderer.
§Examples
use ailloli_ui_runtime::component::{State, View};
use ailloli_ui_widgets::controls::ChatWidget;
let widget: ChatWidget<()> = ChatWidget::new(None, State::new(String::new()))
.message_renderer(|_message| View::empty());
let _ = widget;Sourcepub fn composer_accessory(self, accessory: View<A>) -> Self
pub fn composer_accessory(self, accessory: View<A>) -> Self
Inserts a prebuilt view above the composer resize bar.
§Examples
use ailloli_ui_runtime::component::{State, View};
use ailloli_ui_widgets::controls::ChatWidget;
let widget: ChatWidget<()> = ChatWidget::new(None, State::new(String::new()))
.composer_accessory(View::empty());
let _ = widget;Sourcepub fn composer_controls(self, controls: ChatComposerControls) -> Self
pub fn composer_controls(self, controls: ChatComposerControls) -> Self
Replaces permission/model/reasoning choices, enabled state, and height.
The values are controlled: emitted actions do not mutate this snapshot.
While running, selectors are disabled and the turn button emits Stop.
§Examples
use ailloli_ui_runtime::component::State;
use ailloli_ui_widgets::controls::{ChatComposerControls, ChatWidget};
let controls = ChatComposerControls { running: true, ..Default::default() };
let widget: ChatWidget<()> = ChatWidget::new(None, State::new(String::new()))
.composer_controls(controls);
let _ = widget;Sourcepub fn follow_latest(self, enabled: bool) -> Self
pub fn follow_latest(self, enabled: bool) -> Self
Sets whether the vertical transcript scroll follows its end.
§Examples
use ailloli_ui_runtime::component::State;
use ailloli_ui_widgets::controls::ChatWidget;
let widget: ChatWidget<()> = ChatWidget::new(None, State::new(String::new()))
.follow_latest(false);
let _ = widget;