Skip to content

LabelFrame

LabelFrame is a layout container that groups related widgets under a visible label.

It wraps bs.Labelframe, participates in bootstack styling, and is ideal for labeled sections (settings groups, form clusters, option panels) where the title improves scanability.

Quick start

import bootstack as bs

app = bs.App()

group = bs.LabelFrame(app, text="Network", padding=16)
group.pack(fill="x", padx=20, pady=20)

bs.CheckButton(group, text="Use proxy").pack(anchor="w")
bs.Entry(group).pack(fill="x", pady=(8, 0))

app.mainloop()

When to use

Use LabelFrame when:

  • the grouped controls benefit from a section title

  • the title should be visually attached to the region

Consider a different control when:

  • you want grouping without a label -- use Frame

  • the label belongs in surrounding layout (e.g., page header) -- use Frame with a separate Label

Appearance

Styling

Use LabelFrame when the label should be part of the visual grouping.

For more "modern card" layouts where the label is separate, you may prefer:

  • a Frame with a Label above it

  • a Frame styled as a card, with header content

Design System

For theming details and color tokens, see Design System.

accent / style

Apply semantic styling (or a specific style name).

bs.LabelFrame(app, text="Group", accent="secondary")
bs.LabelFrame(app, text="Group", style="Card.TLabelframe")

Examples & patterns

text

Sets the group label.

bs.LabelFrame(app, text="Appearance")

labelanchor

Controls where the label appears relative to the frame.

bs.LabelFrame(app, text="Network", labelanchor="n")   # top (common)
bs.LabelFrame(app, text="Network", labelanchor="w")   # left
bs.LabelFrame(app, text="Network", labelanchor="s")   # bottom

padding

Inner spacing for the content region.

bs.LabelFrame(app, text="Options", padding=(16, 12))

Behavior

  • LabelFrames are containers only (no interactive behavior).

  • Use text= (or a label widget, if your implementation supports it) to describe the group.

  • Content layout works the same as Frame (pack/grid inside the container).

  • A LabelFrame is like a Frame, but with an integrated label:

    • the label provides context for the grouped controls

    • the border/outline visually separates the region

    • content is packed/gridded inside the container like any other frame

Additional resources

  • Frame -- general-purpose container

  • Separator -- divider between labeled regions

Framework concepts

API reference