Struct Separator

pub struct Separator { /* private fields */ }

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()

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: impl Into<Length>) -> Self

Override the line thickness. Accepts logical f32 pixels or any Length. Without this it follows the widget-scaling mode.

pub fn pad_v(self, p: impl Into<Length>) -> Self

Override the vertical padding above and below the line. Accepts logical f32 pixels or any Length; pass 0.0 for a flush, padding-less divider. Without this it follows the widget-scaling mode.

pub fn preferred_size(&self, max_width: f32, canvas: &Canvas) -> (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.