Struct ButtonStyle

Source
pub struct ButtonStyle {
    pub container: StateStyle<BoxStyle>,
    pub text: StateStyle<TextStyle>,
    pub height: f32,
    pub horizontal_padding: f32,
    pub vertical_padding: f32,
    pub align_items: AlignItems,
    pub justify_content: JustifyContent,
    pub baseline_shift: f32,
}
Expand description

Container/text states and logical-pixel geometry for a button.

The retained Button widget dynamically resolves container. Its child is independently styled: text is copied only by label constructors and is also used by draw_button. Likewise, baseline_shift only affects draw_button, not arbitrary child layout.

§Examples

use ailloli_ui_widgets::controls::ButtonStyle;
let style = ButtonStyle::primary();
assert_eq!((style.height, style.horizontal_padding), (36.0, 12.0));

Fields§

§container: StateStyle<BoxStyle>

Normal and optional interaction-state box styles.

§text: StateStyle<TextStyle>

Normal and optional interaction-state label text styles.

§height: f32

Minimum intrinsic button height in logical pixels.

§horizontal_padding: f32

Horizontal child inset on each side in logical pixels.

§vertical_padding: f32

Vertical child inset on each side in logical pixels.

§align_items: AlignItems

Cross-axis child alignment inside available content space.

§justify_content: JustifyContent

Main-axis child alignment inside available content space.

§baseline_shift: f32

Extra baseline offset used only by draw_button, in logical pixels.

Implementations§

Source§

impl ButtonStyle

Source

pub fn primary() -> Self

Returns default-theme primary styling.

§Examples
use ailloli_ui_widgets::controls::ButtonStyle;
assert_eq!(ButtonStyle::primary().height, 36.0);
Source

pub fn secondary() -> Self

Returns default-theme secondary styling.

§Examples
use ailloli_ui_widgets::controls::ButtonStyle;
assert!(ButtonStyle::secondary().container.normal.border.is_visible());
Source

pub fn outline() -> Self

Returns default-theme outline styling.

§Examples
use ailloli_ui_widgets::controls::ButtonStyle;
assert!(ButtonStyle::outline().container.normal.border.is_visible());
Source

pub fn ghost() -> Self

Returns default-theme ghost styling.

§Examples
use ailloli_ui_widgets::controls::ButtonStyle;
assert!(!ButtonStyle::ghost().container.normal.border.is_visible());
Source

pub fn destructive() -> Self

Returns default-theme danger styling.

§Examples
use ailloli_ui_widgets::controls::ButtonStyle;
assert_eq!(ButtonStyle::destructive().height, 36.0);
Source

pub fn success() -> Self

Returns default-theme success styling.

§Examples
use ailloli_ui_widgets::controls::ButtonStyle;
assert_eq!(ButtonStyle::success().horizontal_padding, 12.0);
Source

pub fn warning() -> Self

Returns default-theme warning styling with dark normal text.

§Examples
use ailloli_ui_widgets::controls::ButtonStyle;
assert_eq!(ButtonStyle::warning().text.normal.px_size, 14);
Source

pub fn info() -> Self

Returns default-theme informational styling with dark normal text.

§Examples
use ailloli_ui_widgets::controls::ButtonStyle;
assert_eq!(ButtonStyle::info().vertical_padding, 8.0);
Source

pub fn from_theme(theme: Theme, variant: ButtonVariant) -> Self

Resolves every container/text interaction state from theme and variant.

ButtonVariant::Default and ButtonVariant::Primary resolve identically. Disabled style is shared across variants.

§Examples
use ailloli_ui_core::Theme;
use ailloli_ui_widgets::controls::{ButtonStyle, ButtonVariant};
let style = ButtonStyle::from_theme(Theme::dark(), ButtonVariant::Secondary);
assert_eq!(style.height, 36.0);
assert!(style.container.hovered.is_some());
Source

pub fn text_only(fg: Color) -> Self

Creates transparent, zero-padding text-only drawing style.

It has 13-pixel UI text and no hover/pressed/focused/disabled overrides.

§Examples
use ailloli_ui_core::Color;
use ailloli_ui_widgets::controls::ButtonStyle;
let style = ButtonStyle::text_only(Color::WHITE);
assert_eq!((style.height, style.horizontal_padding), (0.0, 0.0));
Source

pub fn resolve_container(&self, state: InteractionState) -> BoxStyle

Resolves a concrete box style using StateStyle precedence.

§Examples
use ailloli_ui_core::style::InteractionState;
use ailloli_ui_widgets::controls::ButtonStyle;
let resolved = ButtonStyle::primary().resolve_container(InteractionState::default());
assert!(!resolved.shadows.iter().any(|shadow| shadow.inset));
Source

pub fn resolve_text(&self, state: InteractionState) -> TextStyle

Resolves a concrete text style using StateStyle precedence.

§Examples
use ailloli_ui_core::style::InteractionState;
use ailloli_ui_widgets::controls::ButtonStyle;
assert_eq!(ButtonStyle::primary().resolve_text(InteractionState::default()).px_size, 14);

Trait Implementations§

Source§

impl Clone for ButtonStyle

Source§

fn clone(&self) -> ButtonStyle

Returns a copy of the value. Read more
1.0.0 · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Debug for ButtonStyle

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl Default for ButtonStyle

Source§

fn default() -> Self

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

Auto Trait Implementations§

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> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. 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<A> IntoClickAction<A> for A
where A: Clone + 'static,

§

fn into_click_action(self) -> ClickAction<A>

Implements the into_click_action helper used by this module.

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
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,

§

impl<T> Props for T
where T: Clone + 'static,