Struct Separator

pub struct Separator {
    pub color: Color,
    pub thickness: f32,
    pub pad_v: f32,
}

A horizontal divider line.

Renders a 1 px (default) line across the full width of its layout rect, with vertical padding above and below. Use to break a column into visual sections — between settings groups, list categories or content blocks. The line takes the divider colour from the active theme by default; override with Self::color for custom palettes.

// In view():
column()
    .push( text( "General" ) )
    .push( separator() )
    .push( text( "Network" ) )
.into()

Fields

color: Color

Stroke colour. Defaults to the theme’s divider palette slot.

thickness: f32

Line thickness in logical pixels.

pad_v: f32

Vertical padding above and below the line, baked into preferred_size so the divider visually centres in the row a parent column allocates.

Implementations

impl Separator

pub fn new() -> Self

Create a separator with the theme’s default divider colour and 1 px thickness.

pub fn color(self, color: Color) -> Self

Override the stroke colour. Useful for emphasised dividers between destructive actions.

pub fn thickness(self, t: f32) -> Self

Override the line thickness. Defaults to 1 logical pixel.

pub fn preferred_size(&self, max_width: f32) -> (f32, f32)

Return the preferred (width, height). Width is max_width; height is thickness + 2 × pad_v.

pub fn draw(&self, canvas: &mut Canvas, rect: Rect)

Draw the divider line into canvas at rect.

Trait Implementations

impl<Msg: Clone> From<Separator> for Element<Msg>

fn from(s: Separator) -> Self

Converts to this type from the input type.