Padding

Padding — a single-child layout container that adds insets around its child.

Padding shrink-wraps a child widget and enlarges it by configurable insets on each of the four sides. Horizontal insets are leading/trailing (logical), not left/right (physical), so they flip automatically in RTL locales. Each inset accepts a static f32 or a reactive Signal<f32>; a bound inset schedules a relayout whenever the signal fires, so theme-derived spacing values take effect without rebuilding the widget tree.

The grow weight, shrink weight, and compression floor reported by the child are forwarded through the padding so a flexible or shrinkable child inside a Padding stays flexible or shrinkable from the parent's perspective.

When to use

• Adding whitespace around a widget without wrapping it in a stack.
• Applying asymmetric insets (e.g. extra leading inset for a list item).
• Reacting to a Signal-driven spacing token.

Use Padding::uniform when all four sides are equal, and Padding::symmetric when horizontal and vertical insets differ.

#![allow(unused)]
fn main() {
use teksilo_widgets::primitives::{Padding, TextWidget};
use teksilo_i18n::lit;
// 12 dp padding on every side:
let _w = Padding::uniform(12.0)
    .child(TextWidget::new(lit!("Hello")));
}

Builder methods at a glance

uniform, symmetric, child_id, child

API reference

📖 Full rustdoc API for this module

pub struct Padding

A layout container that adds padding (insets) around a single child.

See the module documentation for the full feature description and an example. Construct with Padding::new, Padding::uniform, or Padding::symmetric; attach a child with .child(widget) or .child_id(id).

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

Methods

pub fn new( top: impl Into<Prop<f32>>, trailing: impl Into<Prop<f32>>, bottom: impl Into<Prop<f32>>, leading: impl Into<Prop<f32>>, ) -> Self

Create a padding with explicit per-side insets.

Argument order mirrors CSS shorthand: (top, trailing, bottom, leading). trailing and leading are logical — they map to physical right and left in LTR and are swapped in RTL.

pub fn uniform(amount: impl Into<Prop<f32>>) -> Self

Create a padding with the same inset on all four sides.

pub fn symmetric(vertical: impl Into<Prop<f32>>, horizontal: impl Into<Prop<f32>>) -> Self

Create a padding with equal top/bottom insets and equal leading/trailing insets.

vertical applies to both top and bottom; horizontal applies to both leading and trailing sides (logical, RTL-aware).

pub fn child_id(mut self, id: WidgetId) -> Self

Set child by pre-registered ID.

pub fn child(mut self, widget: impl Widget + 'static) -> Self

Set an inline child widget (deferred insertion).