Struct ColorPicker

Source
pub struct ColorPicker<A = ()> { /* private fields */ }
Expand description

Controlled RGB color field with HSV controls, palette swatches, and hex input.

A is the application action returned by the non-context callback. Use Self::bind for internal writes; Self::value is read-only. HSV and parsed hex commits are opaque, while a supplied swatch is committed unchanged.

§Examples

use ailloli_ui_core::Color;
use ailloli_ui_widgets::controls::ColorPicker;
let picker: ColorPicker<()> = ColorPicker::new().value(Color::hex_rgb(0xFF5A00));
let _ = picker;

Implementations§

Source§

impl<A: 'static> ColorPicker<A>

Source

pub fn width(self, value: impl Into<Length>) -> Self

Sets preferred width from a logical-pixel or length value.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().width(120.0);
let _ = widget;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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> ColorPicker<A>

Source

pub fn new() -> Self

Creates an enabled color picker initialized from the default accent color.

Hex input is enabled, the popup starts closed, and no palette swatches or callback are installed.

§Examples
use ailloli_ui_widgets::controls::ColorPicker;
let picker: ColorPicker<()> = ColorPicker::new();
let _ = picker;
Source

pub fn value(self, value: impl Into<Binding<Color>>) -> Self

Sets a read-only static or reactive color and clears writable binding.

User interaction may invoke the callback but cannot mutate this configured value.

§Examples
use ailloli_ui_core::Color;
use ailloli_ui_widgets::controls::ColorPicker;
let picker: ColorPicker<()> = ColorPicker::new().value(Color::rgb(255, 0, 0));
let _ = picker;
Source

pub fn bind(self, value: impl Into<Signal<Color>>) -> Self

Binds a writable color signal.

A changed commit writes the signal before invoking the callback.

§Examples
use ailloli_ui_core::Color;
use ailloli_ui_runtime::component::State;
use ailloli_ui_widgets::controls::ColorPicker;
let picker: ColorPicker<()> = ColorPicker::new().bind(State::new(Color::BLACK));
let _ = picker;
Source

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::ColorPicker;
let picker: ColorPicker<()> = ColorPicker::new().disabled(true);
let _ = picker;
Source

pub fn swatch(self, value: Color) -> Self

Appends a palette swatch in display order.

Duplicates and translucent colors are accepted; selecting one commits the exact stored [Color], although the hex field displays RGB only.

§Examples
use ailloli_ui_core::Color;
use ailloli_ui_widgets::controls::ColorPicker;
let picker: ColorPicker<()> = ColorPicker::new().swatch(Color::hex_rgb(0x22C55E));
let _ = picker;
Source

pub fn hex_input(self, value: bool) -> Self

Shows or hides editable RGB hexadecimal input.

When shown and the popup is open, the widget advertises single-line text input. Invalid text is ignored on Enter or focus loss and remains visible.

§Examples
use ailloli_ui_widgets::controls::ColorPicker;
let picker: ColorPicker<()> = ColorPicker::new().hex_input(false);
let _ = picker;
Source

pub fn default_open(self, open: bool) -> Self

Sets only the color popup’s initial open state.

§Examples
use ailloli_ui_widgets::controls::ColorPicker;
let picker: ColorPicker<()> = ColorPicker::new().default_open(true);
let _ = picker;
Source

pub fn color_style(self, style: ColorPickerStyle) -> Self

Replaces trigger and popup style without altering explicit layout size.

§Examples
use ailloli_ui_widgets::controls::{ColorPicker, ColorPickerStyle};
let picker: ColorPicker<()> = ColorPicker::new().color_style(ColorPickerStyle::default());
let _ = picker;
Source

pub fn color_size(self, size: ColorPickerSize) -> Self

Re-derives style from the default theme and requested density.

This overwrites every previous color-style customization.

§Examples
use ailloli_ui_widgets::controls::{ColorPicker, ColorPickerSize};
let picker: ColorPicker<()> = ColorPicker::new().color_size(ColorPickerSize::Compact);
let _ = picker;
Source

pub fn on_change(self, f: impl Fn(Color) -> A + 'static) -> Self

Dispatches the application action returned for a changed committed color.

Recommitting an exactly equal [Color] emits nothing.

§Examples
use ailloli_ui_core::Color;
use ailloli_ui_widgets::controls::ColorPicker;
let picker: ColorPicker<Color> = ColorPicker::new().on_change(|color| color);
let _ = picker;
Source

pub fn on_change_ctx( self, f: impl Fn(&mut EventCtx<A>, Color) + 'static, ) -> Self

Handles a changed committed color with direct event-context access.

§Examples
use ailloli_ui_widgets::controls::ColorPicker;
let picker: ColorPicker<()> = ColorPicker::new().on_change_ctx(|_ctx, _color| {});
let _ = picker;

Trait Implementations§

Source§

impl<A: 'static> Default for ColorPicker<A>

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl<A: 'static> IntoView<A> for ColorPicker<A>

Source§

fn into_view(self) -> View<A>

Converts configuration into a sized reactive component view.

Source§

impl<A: 'static> LayoutExt for ColorPicker<A>

Source§

fn layout_mut(&mut self) -> &mut LayoutStyle

Returns the widget’s mutable declarative size/inset state. Read more

Auto Trait Implementations§

§

impl<A> Freeze for ColorPicker<A>

§

impl<A = ()> !RefUnwindSafe for ColorPicker<A>

§

impl<A = ()> !Send for ColorPicker<A>

§

impl<A = ()> !Sync for ColorPicker<A>

§

impl<A> Unpin for ColorPicker<A>

§

impl<A = ()> !UnwindSafe for ColorPicker<A>

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T, A> FlexItemExt<A> for T
where T: IntoView<A>,

Source§

fn flex_grow(self) -> View<A>

Sets flex-grow weight to one. Read more
Source§

fn flex_grow_by(self, value: f32) -> View<A>

Sets the dimensionless flex-grow weight. Read more
Source§

fn flex_shrink(self, value: f32) -> View<A>

Sets the dimensionless flex-shrink weight. Read more
Source§

fn flex_basis(self, value: impl Into<Length>) -> View<A>

Sets the preferred main-axis flex basis. Read more
Source§

fn align_self(self, value: AlignItems) -> View<A>

Overrides the parent cross-axis alignment for this view. Read more
Source§

fn fill_width(self) -> View<A>

Marks width as parent-fill in the view size hint. Read more
Source§

fn fill_height(self) -> View<A>

Marks height as parent-fill in the view size hint. Read more
Source§

fn fill(self) -> View<A>

Marks both axes as parent-fill in the view size hint. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

§

impl<T, A> IntoViewKeyExt<A> for T
where T: IntoView<A>,

§

fn key(self, key: impl Into<String>) -> View<A>

Converts self, assigns the owned key, and returns the view. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

impl<T> ErasedDestructor for T
where T: 'static,