Separator#

Separator is the native ttk thin horizontal or vertical dividing line (ttk.Separator), 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.

orient

str

The layout direction: "horizontal" or "vertical".

cursor

str

The mouse cursor over the separator (see Cursors).

takefocus

bool

Whether the separator accepts keyboard focus during traversal.

Styling options#

This section is for changing how the separator looks. Define a style with style.configure(...) (and style.map(...) for per-state colors), then apply it with Separator(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.

A vertical widget resolves to the Vertical. twin of each style name above.

bootstyle

ttk style name

primary

primary.Horizontal.TSeparator

Layout (elements)#

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

primary.Horizontal.Separator.separator

Configurable style options#

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

(none)

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.Horizontal.TSeparator", background="#3498db", foreground="white")
ttk.Separator(app, style="my.Horizontal.TSeparator").pack(padx=8, pady=8)

app.mainloop()

Shared capabilities#

Separator 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.

See also#