toolbar_divider: Toolbar: Add a divider or spacer to a toolbar

In bslib: Custom 'Bootstrap' 'Sass' Themes for 'shiny' and 'rmarkdown'

Toolbar: Add a divider or spacer to a toolbar

Description

toolbar_divider() creates a visual divider line with customizable and fixed width and spacing between toolbar elements. toolbar_spacer() creates empty space that expands to push adjacent toolbar elements apart as much as possible.

Usage

toolbar_divider(..., width = NULL, gap = NULL)

toolbar_spacer()

Arguments

...	Ignored, reserved for future use and to require named arguments in toolbar_divider().
width	A CSS length unit specifying the width of the divider line. Defaults to "2px" for a sensible dividing line. Pass ⁠0px⁠ for no divider line.
gap	A CSS length unit defining the spacing around the divider. Defaults to "1rem" for sensible fixed spacing.

Functions

• toolbar_divider(): Create a dividing line and fixed space between toolbar elements.

• toolbar_spacer(): Create empty, expanding space between toolbar elements. Note that for the spacer to push elements effectively, the parent toolbar needs ⁠width: 100%⁠ (which is automatically applied when the toolbar is a direct child of a label element). If the spacer doesn't appear to work, you may need to set width = "100%" explicitly on the toolbar().

See Also

Other toolbar components: toolbar(), toolbar_input_button(), toolbar_input_select()

Examples

toolbar(
  toolbar_input_button(id = "left1", label = "Left"),
  toolbar_divider(),
  toolbar_input_button(id = "right1", label = "Right")
)

toolbar(
  toolbar_input_button(id = "a", label = "A"),
  toolbar_divider(width = "5px", gap = "20px"),
  toolbar_input_button(id = "b", label = "B")
)

toolbar(
  toolbar_input_button(id = "previous", label = "Previous"),
  toolbar_spacer(),
  toolbar_input_button(id = "next", label = "Next")
)

bslib documentation built on May 16, 2026, 9:06 a.m.