Skip to main content

Toolbar

shadow

The Element Toolbar is a flexible container designed to display a variety of content in an organized manner, typically used at the top of web applications or pages. It may contain buttons, navigation, search box, and more. It supports content alignment and can also be glued to the top of the screen.

Part of the Toolbar is the ToolbarActions element, which groups different actions in the form of buttons into a single unit.

Basic usage

Dynamic breadcrumbs

Dynamic action

When to use

Use wje-toolbar to compose stable page structure with clear visual and semantic hierarchy.

When not to use

Do not use layout components to handle business logic or application orchestration.

Accessibility

Preserve document semantics (header, main, aside, footer) and logical tab/focus order.

Best Practices

  • Define mobile/desktop breakpoints first, then refine visual details.
  • Prefer spacing tokens over ad-hoc margin/padding overrides.
  • Test keyboard and screen reader behavior for overflow scenarios.

Attributes and Properties

No properties available for this component.

Events

No events available for this component.

Methods

No public methods available for this component.

CSS Shadow Parts

NameDescription
nativeThe native toolbar wrapper.

CSS Custom Properties

NameDescription
--wje-toolbar-backgroundSpecifies the background color of the toolbar. Accepts any valid CSS color value, such as hex, rgb, or CSS variable.
--wje-toolbar-heightDefines the height of the toolbar. If set to auto, the height adjusts based on the content.
--wje-toolbar-min-heightSets the minimum height of the toolbar. Ensures the toolbar maintains a consistent minimum size.
--wje-toolbar-padding-topSpecifies the padding at the top of the toolbar. Accepts any valid CSS length unit.
--wje-toolbar-padding-bottomSpecifies the padding at the bottom of the toolbar. Helps create spacing between the content and the bottom edge.
--wje-toolbar-padding-inlineDefines the horizontal padding (left and right) of the toolbar. Creates consistent spacing on both sides.
--wje-toolbar-border-colorSets the color of the toolbar's border. Accepts any valid CSS color value.
--wje-toolbar-topSpecifies the vertical position of the toolbar relative to its container. Useful for fixed or sticky toolbars.

Slots

NameDescription
startThe start slot for the toolbar.
endThe end slot for the toolbar.