Frame#

Frame is the native ttk rectangular container for grouping and laying out other widgets (ttk.Frame), themed by ttkbootstrap. This page is the complete reference for its options, methods, and styling.

Options#

Each option can be set in the constructor and changed later with configure().

Option	Type	Description
`bootstyle`	`str`	Constructor keyword. An accent color, optionally with a variant. See Styling options for the available styles.
`padding`	`int \| tuple`	Extra space inside the frame’s border, in pixels (a single value, or per-side).
`borderwidth`	`int`	The width of the frame’s border, in pixels.
`relief`	`str`	The border decoration: `"flat"`, `"raised"`, `"sunken"`, `"solid"`, `"ridge"`, or `"groove"`.
`width`	`int`	The requested width in pixels. Ignored unless geometry propagation is turned off.
`height`	`int`	The requested height in pixels. Ignored unless geometry propagation is turned off.
`cursor`	`str`	The mouse cursor over the frame (see Cursors).
`takefocus`	`bool`	Whether the frame accepts keyboard focus during traversal.

Styling options#

This section is for changing how the frame looks. Define a style with style.configure(...) (and style.map(...) for per-state colors), then apply it with Frame(style=...).

Bootstyle mapping#

Any of the accent colors – primary, secondary, success, info, warning, danger, light, dark – substitutes for primary below. neutral does not apply to this family.

`bootstyle`	ttk style name
`primary`	`primary.TFrame`

Layout (elements)#

The widget is drawn from these nested parts. Each is an element you can target by name in a custom layout:

Frame.border

Configurable style options#

Options you can set with style.configure(...) / style.map(...):

bordercolor, borderwidth, darkcolor, lightcolor, relief

Supported states#

This style declares no style.map(...) overrides; any state-dependent appearance is drawn from its image elements.

Hand-styling example#

import ttkbootstrap as ttk

app = ttk.App()
style = app.style

style.configure("my.TFrame", background="#3498db", foreground="white")
ttk.Frame(app, style="my.TFrame").pack(padx=8, pady=8)

app.mainloop()

Shared capabilities#

Frame also has the methods every widget inherits — configuration, placement, event binding, lifecycle, focus, and introspection — plus the ttk state methods state / instate / identify. These are documented under Capabilities.