Jangle UI documentation
Components

Arrange related actions with consistent spacing and responsive wrapping.

Use Button Group

<jangle-button-group> arranges related actions with consistent spacing and preserves their reading and keyboard order. Use it for actions such as Save and Cancel. It does not manage selection or provide toolbar arrow-key navigation.

Add a group

Configure package access, then register the group and its children:

import '@jangle-ui/tokens/tokens.css';
import '@jangle-ui/components/button/register';
import '@jangle-ui/components/button-group/register';
<jangle-button-group label="Profile actions" align="end">
  <jangle-button treatment="quiet">Cancel</jangle-button>
  <jangle-button intent="brand" treatment="strong">Save changes</jangle-button>
</jangle-button-group>

Connect the actions to your application as you would standalone Buttons. The group never changes their size, emphasis, disabled state, or form behavior. Prefer matching sizes in an ordinary group. Different sizes are supported when a particular composition needs them.

Layout and naming

Horizontal groups wrap when their actions no longer fit the available width. There is no fixed breakpoint. Use orientation="vertical" for a column. align="start|center|end" follows the document's direction and aligns each row or the intrinsic-width controls in a column.

An optional localized label provides an accessible group name when the grouping context helps. An omitted or whitespace-only label leaves an ordinary layout container. Every child still needs its own accessible name. The group adds no focus stop; Tab visits the children normally.

See Button Group in Storybook for interactive Controls, wrapping, and vertical examples.

On this page