Svelte Button Group - Bitblue

Group related buttons into a single segmented control with shared size and disabled state

ButtonGroup shares size context with nested Button children and visually joins them into one control.

Setup

<script lang="ts">
	import { Button, ButtonGroup } from '.';
</script>

Default

<script lang="ts">
	import { Button, ButtonGroup } from '.';
</script>

<ButtonGroup>
	<Button color="alternative">Profile</Button>
	<Button color="alternative">Settings</Button>
	<Button color="alternative">Messages</Button>
</ButtonGroup>

Sizes

<script lang="ts">
	import { Button, ButtonGroup } from '.';
</script>

<ButtonGroup size="sm">
	<Button color="alternative">SM</Button>
	<Button color="alternative">Group</Button>
</ButtonGroup>

Mixed colors

<script lang="ts">
	import { Button, ButtonGroup } from '.';
</script>

<ButtonGroup>
	<Button color="blue">Save</Button>
	<Button color="alternative">Cancel</Button>
	<Button color="red">Delete</Button>
</ButtonGroup>

Disabled group

disabled on the group disables all children via context.

<script lang="ts">
	import { Button, ButtonGroup } from '.';
</script>

<ButtonGroup disabled>
	<Button>One</Button>
	<Button>Two</Button>
	<Button>Three</Button>
</ButtonGroup>

Props

PropTypeDefaultDescription
childrenSnippet—Nested Button (or compatible) children (required)
size'xs' | 'sm' | 'md' | 'lg' | 'xl''md'Shared child size context
disabledboolean—Disable all children via context
classClassValue—Extra classes on the group
...restHTMLAttributes<HTMLDivElement>—Root attributes

Theme base: inline-flex rounded-lg shadow-xs -space-x-px.


© 2026 Bitblue is a registered trademark. All Rights Reserved.