Toddy.Iced.Widget.KeyedColumn (Toddy v0.3.0)

Keyed column layout -- arranges children vertically with stable identity keys.

Like Column, but uses each child's id as a key for iced's internal widget diffing. This avoids unnecessary rebuilds when items are added, removed, or reordered in dynamic lists.

Props

spacing (number) -- vertical space between children in pixels. Default: 0.
padding (number | map) -- padding inside the column. See Toddy.Iced.Padding.
width (length) -- column width. Default: shrink. See Toddy.Iced.Length.
height (length) -- column height. Default: shrink.
max_width (number) -- maximum width in pixels.
a11y (map) -- accessibility overrides. See Toddy.Iced.A11y.

Summary

Types

option()

t()

Functions

a11y(kc, a11y)

Sets accessibility annotations.

build(kc)

Converts this keyed column struct to a ui_node() map via the Toddy.Iced.Widget protocol.

extend(kc, children)

Appends multiple children to the keyed column.

height(kc, height)

Sets the column height.

max_width(kc, max_width)

Sets the maximum width in pixels.

new(id, opts \\ [])

Creates a new keyed column struct with optional keyword opts.

padding(kc, padding)

Sets the padding inside the column.

push(kc, child)

Appends a child to the keyed column.

spacing(kc, spacing)

Sets the spacing between children in pixels.

width(kc, width)

Sets the column width.

with_options(kc, opts)

Applies keyword options to an existing keyed column struct.

Types

option()

@type option() ::
  {:spacing, number()}
  | {:padding, Toddy.Iced.Padding.t()}
  | {:width, Toddy.Iced.Length.t()}
  | {:height, Toddy.Iced.Length.t()}
  | {:max_width, number()}
  | {:a11y, Toddy.Iced.A11y.t()}

t()

@type t() :: %Toddy.Iced.Widget.KeyedColumn{
  a11y: Toddy.Iced.A11y.t() | nil,
  children: [Toddy.Iced.ui_node() | struct()],
  height: Toddy.Iced.Length.t() | nil,
  id: String.t(),
  max_width: number() | nil,
  padding: Toddy.Iced.Padding.t() | nil,
  spacing: number() | nil,
  width: Toddy.Iced.Length.t() | nil
}

Functions

build(kc)

@spec build(keyed_column :: t()) :: Toddy.Iced.ui_node()

Converts this keyed column struct to a ui_node() map via the Toddy.Iced.Widget protocol.

extend(kc, children)

@spec extend(keyed_column :: t(), children :: [Toddy.Iced.ui_node() | struct()]) ::
  t()

Appends multiple children to the keyed column.

height(kc, height)

@spec height(keyed_column :: t(), height :: Toddy.Iced.Length.t()) :: t()

Sets the column height.

max_width(kc, max_width)

@spec max_width(keyed_column :: t(), max_width :: number()) :: t()

Sets the maximum width in pixels.

new(id, opts \\ [])

@spec new(id :: String.t(), opts :: [option()]) :: t()

Creates a new keyed column struct with optional keyword opts.

padding(kc, padding)

@spec padding(keyed_column :: t(), padding :: Toddy.Iced.Padding.t()) :: t()

Sets the padding inside the column.

push(kc, child)

@spec push(keyed_column :: t(), child :: Toddy.Iced.ui_node() | struct()) :: t()

Appends a child to the keyed column.

spacing(kc, spacing)

@spec spacing(keyed_column :: t(), spacing :: number()) :: t()

Sets the spacing between children in pixels.

width(kc, width)

@spec width(keyed_column :: t(), width :: Toddy.Iced.Length.t()) :: t()

Sets the column width.

with_options(kc, opts)

@spec with_options(keyed_column :: t(), opts :: [option()]) :: t()

Applies keyword options to an existing keyed column struct.