Per-instance widget styling that crosses the IPC boundary as a plain map.
A StyleMap lets you override visual properties (background, text color,
border, shadow) on individual widget instances without defining a named
style. Status overrides (hovered, pressed, disabled, focused) apply
partial style changes for those interaction states.
The background field accepts either a solid color (hex string or named
atom) or a Toddy.Iced.Gradient for gradient fills.
Wire format
%{
"background" => "#ff0000",
"text_color" => "#ffffff",
"border" => %{"color" => "#000000", "width" => 1, "radius" => 4},
"hovered" => %{"background" => "#cc0000"},
"pressed" => %{"background" => "#990000"}
}Example
style = Toddy.Iced.StyleMap.new()
|> Toddy.Iced.StyleMap.background("#3366ff")
|> Toddy.Iced.StyleMap.text_color(:white)
|> Toddy.Iced.StyleMap.hovered(%{background: "#5588ff"})
Button.new("btn", "Click me", style: style)Gradient backgrounds work the same way:
gradient = Toddy.Iced.Gradient.linear(90, [{0.0, "#ff0000"}, {1.0, "#0000ff"}])
style = Toddy.Iced.StyleMap.new()
|> Toddy.Iced.StyleMap.background(gradient)
Container.new("ctr", [], style: style)Summary
Functions
Sets the background. Accepts a color (any form Color.cast/1 supports) or a Gradient.
Sets the base preset to extend from instead of starting from the widget default.
Sets the border specification.
Sets the disabled status override. Accepts a map or keyword list.
Sets the focused status override. Accepts a map or keyword list.
Sets the hovered status override. Accepts a map or keyword list.
Creates an empty style map.
Sets the pressed status override. Accepts a map or keyword list.
Sets the shadow specification.
Sets the text color. Accepts a hex string or named color atom.
Types
@type status_override() :: %{ optional(:background) => Toddy.Iced.Color.t() | Toddy.Iced.Gradient.t(), optional(:text_color) => Toddy.Iced.Color.t(), optional(:border) => Toddy.Iced.Border.t(), optional(:shadow) => Toddy.Iced.Shadow.t() }
Partial style override for an interaction state.
@type t() :: %Toddy.Iced.StyleMap{ background: Toddy.Iced.Color.t() | Toddy.Iced.Gradient.t() | nil, base: atom() | nil, border: Toddy.Iced.Border.t() | nil, disabled: status_override() | nil, focused: status_override() | nil, hovered: status_override() | nil, pressed: status_override() | nil, shadow: Toddy.Iced.Shadow.t() | nil, text_color: Toddy.Iced.Color.t() | nil }
Functions
@spec background( style_map :: t(), background :: Toddy.Iced.Color.input() | Toddy.Iced.Gradient.t() ) :: t()
Sets the background. Accepts a color (any form Color.cast/1 supports) or a Gradient.
Sets the base preset to extend from instead of starting from the widget default.
@spec border(style_map :: t(), border :: Toddy.Iced.Border.t()) :: t()
Sets the border specification.
@spec disabled(style_map :: t(), disabled :: status_override() | keyword()) :: t()
Sets the disabled status override. Accepts a map or keyword list.
@spec focused(style_map :: t(), focused :: status_override() | keyword()) :: t()
Sets the focused status override. Accepts a map or keyword list.
@spec hovered(style_map :: t(), hovered :: status_override() | keyword()) :: t()
Sets the hovered status override. Accepts a map or keyword list.
@spec new() :: t()
Creates an empty style map.
@spec pressed(style_map :: t(), pressed :: status_override() | keyword()) :: t()
Sets the pressed status override. Accepts a map or keyword list.
@spec shadow(style_map :: t(), shadow :: Toddy.Iced.Shadow.t()) :: t()
Sets the shadow specification.
@spec text_color(style_map :: t(), text_color :: Toddy.Iced.Color.input()) :: t()
Sets the text color. Accepts a hex string or named color atom.