GroupHeader

GroupHeader — a horizontal section header: label followed by a trailing rule line that fills the remaining width.

Used to segment settings pages, preference sheets, and forms into labelled regions without the heavier chrome of a GroupBox. Int UI and Jewel use this pattern as a lightweight "soft divider with a caption" between groups of related controls.

#![allow(unused)]
fn main() {
use teksilo_widgets::GroupHeader;
use teksilo_i18n::lit;
let _w = GroupHeader::new(lit!("Appearance"));
}

Trivially composed from existing primitives: HStack → TextWidget + Expand(Divider).

Builder methods at a glance

style, color, gap

API reference

📖 Full rustdoc API for this module

pub struct GroupHeader

A labelled section header with a trailing rule line.

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

Methods

pub fn new(label: impl Into<LocalizedString>) -> Self

Create a section header with the given label.

pub fn style(mut self, style: impl Into<TextStyleProp>) -> Self

Override the label's text style (font, size, weight, …). Accepts a static TextStyle or a TextStyleRole.

pub fn color(mut self, color: impl Into<ColorProp>) -> Self

Override the label's color. Useful when a consumer wants to emphasise a header with an accent. Accepts a literal Color, a TextRole/SurfaceRole, or a Signal<Color>.

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

Horizontal gap between the label and the rule line. Defaults to 8 dp.