Spacer

Spacer — an invisible, flexible gap that claims all available space on the container's main axis.

Place a Spacer inside an HStack or VStack to push adjacent siblings to opposite edges; flank a child with two spacers to centre it. A spacer carries flex weight 1.0 and zero wanted size, so it soaks up leftover slack without imposing a cross-axis floor. min_length sets a hard minimum so the gap never collapses below a fixed amount under tight layout.

#![allow(unused)]
fn main() {
use teksilo_widgets::primitives::{HStack, Spacer, TextWidget};
use teksilo_i18n::lit;
// Title hugs the leading edge, badge is pushed to the trailing edge.
let _row = HStack::new()
    .child(TextWidget::new(lit!("Title")))
    .child(Spacer::new())
    .child(TextWidget::new(lit!("NEW")));
}

Builder methods at a glance

min_length

API reference

📖 Full rustdoc API for this module

pub struct Spacer

An invisible, flexible gap that claims a container's leftover main-axis space.

#![allow(unused)]
fn main() {
pub struct Spacer { /* fields */ }
}

Methods

pub fn new() -> Self

Create a spacer with no minimum length (collapses fully when the container has no slack to give).

pub fn min_length(mut self, min: f32) -> Self

Set a hard floor, in logical pixels, on the spacer's main-axis size.

The container still adds its slack share on top; the floor only matters when the container is too cramped to grant any slack. The cross axis is unaffected, so a horizontal spacer never inflates its stack's height.