コンテンツへスキップ

ボタングループ

ボタン、ツールバー、入力アドオンを1つの枠付きユニットに統合しています。太い枠線、ハードシャドウ、共通のクリック操作が1つにまとめられています。

"use client"

import * as React from "react"

Button Group は隣り合うボタン、入力、ラベルを1つのセグメントコントロールにまとめます。下層にプリミティブはなく、プレーンな role="group" コンテナがネオブルータリストの枠(1本の太い枠線、1つの硬い影、共有のプレスアニメーション)を担います。プリミティブに触れるのは ButtonGroupSeparator だけで、Separator を包みます。

次のような場面で使います:

  • スプリットボタン — 主アクションに加え、代替案の DropdownMenu(Save / Save as…、Merge / Squash など)。
  • ページャーとツールバー — 前へ/次へ、ズームイン/アウト、表示切替を1つの枠にまとめます。
  • 入力のアドオン — 送信ボタン付きの検索欄、URL プレフィックスラベル、コピーボタンのサフィックスなど。

インストール

pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/button-group.json
npx shadcn@latest add https://neobrutalism.com/r/base/button-group.json
yarn dlx shadcn@latest add https://neobrutalism.com/r/base/button-group.json
bunx --bun shadcn@latest add https://neobrutalism.com/r/base/button-group.json

以下の依存関係をインストールします:

pnpm add @base-ui/react
npm install @base-ui/react
yarn add @base-ui/react
bun add @base-ui/react

以下のコードをコピーしてプロジェクトに貼り付けます。

components/ui/button-group.tsx
import { cva, type VariantProps } from "class-variance-authority"
import { Slot } from "radix-ui"

import { cn } from "@/lib/utils"
import { Separator } from "@/components/ui/separator"

const buttonGroupVariants = cva(
  cn(
    // The GROUP itself is the cohesive NeoBrutalist unit: a single bold border +
    // one hard offset shadow wrapping every segment, so it reads as ONE unit.
    // The frame animates so the whole group can press like a single Button.
    "relative inline-flex w-fit items-stretch border-2 border-foreground bg-background shadow-md transition-all duration-200",
    // Segments become flush fills — the frame owns the border, shadow and corners.
    "[&>*]:rounded-none",
    "[&>:is(button,a)]:border-0 [&>:is(button,a)]:shadow-none!",
    // Segments never translate on their own — only the whole frame moves.
    "[&>:is(button,a)]:hover:translate-y-0! [&>:is(button,a)]:active:translate-x-0! [&>:is(button,a)]:active:translate-y-0!",
    // The WHOLE group presses into its shadow like a single Button: hover sinks it
    // toward the shadow, press sits it flush (shadow gone).
    "has-[:is(button,a):hover]:translate-y-1 has-[:is(button,a):hover]:shadow",
    "has-[:is(button,a):active]:translate-y-2 has-[:is(button,a):active]:translate-x-1 has-[:is(button,a):active]:shadow-none",
    // When a group CONTAINS nested groups it becomes a plain gapped container
    // (no frame / shadow / press) so each nested sub-group is its own pressable
    // unit instead of pressing the whole outer frame.
    "has-[>[data-slot=button-group]]:gap-2 has-[>[data-slot=button-group]]:border-0 has-[>[data-slot=button-group]]:bg-transparent has-[>[data-slot=button-group]]:shadow-none! has-[>[data-slot=button-group]]:translate-x-0! has-[>[data-slot=button-group]]:translate-y-0!",
    // The hovered/pressed segment darkens in place via a full-bleed inset tint, so
    // you can still tell which segment you're acting on while the frame presses.
    "[&>:is(button,a):hover]:shadow-[inset_0_0_0_999px_#00000012]! [&>:is(button,a):active]:shadow-[inset_0_0_0_999px_#0000001f]!",

    "dark:[&>:is(button,a):hover]:shadow-[inset_0_0_0_999px_#ffffff1f]! dark:[&>:is(button,a):active]:shadow-[inset_0_0_0_999px_#ffffff33]!",
    // Solid dark segments (secondary) always lighten on hover — a dark tint would
    // be invisible on a black button in light mode.
    "[&>:is(button,a)[data-variant=secondary]:hover]:shadow-[inset_0_0_0_999px_#ffffff2b]! [&>:is(button,a)[data-variant=secondary]:active]:shadow-[inset_0_0_0_999px_#ffffff45]!",
    "[&>:is(button,a):focus-visible]:relative [&>:is(button,a):focus-visible]:z-10"
  ),
  {
    variants: {
      orientation: {
        // A single crisp seam between segments (logical side, so RTL-correct).
        horizontal:
          "flex-row [&>*:not(:first-child)]:border-s-2! [&>*:not(:first-child)]:border-foreground",
        vertical:
          "flex-col [&>*:not(:first-child)]:border-t-2! [&>*:not(:first-child)]:border-foreground",
      },
    },
    defaultVariants: {
      orientation: "horizontal",
    },
  }
)

function ButtonGroup({
  className,
  orientation,
  ...props
}: React.ComponentProps<"div"> & VariantProps<typeof buttonGroupVariants>) {
  return (
    <div
      role="group"
      data-slot="button-group"
      data-orientation={orientation ?? "horizontal"}
      className={cn(buttonGroupVariants({ orientation }), className)}
      {...props}
    />
  )
}

function ButtonGroupText({
  className,
  asChild = false,
  ...props
}: React.ComponentProps<"div"> & {
  asChild?: boolean
}) {
  const Comp = asChild ? Slot.Root : "div"

  return (
    <Comp
      data-slot="button-group-text"
      className={cn(
        "inline-flex items-center gap-2 bg-muted px-3 font-head text-sm font-medium text-foreground [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4",
        className
      )}
      {...props}
    />
  )
}

function ButtonGroupSeparator({
  className,
  orientation = "vertical",
  ...props
}: React.ComponentProps<typeof Separator>) {
  return (
    <Separator
      data-slot="button-group-separator"
      orientation={orientation}
      className={cn(
        "relative z-10 self-stretch bg-border data-horizontal:h-0.5 data-horizontal:w-auto data-vertical:h-auto data-vertical:w-0.5",
        className
      )}
      {...props}
    />
  )
}

export {
  ButtonGroup,
  ButtonGroupSeparator,
  ButtonGroupText,
  buttonGroupVariants,
}

プロジェクトの構成に合わせてインポートパスを更新します。

使い方

import {
  ButtonGroup,
  ButtonGroupSeparator,
  ButtonGroupText,
} from "@/components/ui/button-group"
<ButtonGroup>
  <Button>Button 1</Button>
  <Button>Button 2</Button>
</ButtonGroup>

コンポジション

ButtonGroup を構築するには、次のコンポジションを使用します:

ButtonGroup
├── Button or Input
├── ButtonGroupSeparator
└── ButtonGroupText

アクセシビリティ

  • ButtonGroup コンポーネントは、role 属性が group に設定されています。
  • Tab を使って、グループ内のボタン間を移動します。
  • aria-label または aria-labelledby を使って、ボタングループにラベルを付けます。
<ButtonGroup aria-label="Button group">
  <Button>Button 1</Button>
  <Button>Button 2</Button>
</ButtonGroup>

ButtonGroup vs ToggleGroup

  • アクションを実行するボタンをまとめたい場合は、ButtonGroup コンポーネントを使用します。
  • 状態を切り替えるボタンをまとめたい場合は、ToggleGroup コンポーネントを使用します。

使用例

向き

orientation プロパティを設定して、ボタングループのレイアウトを変更します。

import { MinusIcon, PlusIcon } from "lucide-react"

import { Button } from "@/components/ui/button"

サイズ

各ボタンの size プロパティを使って、ボタンのサイズを制御します。

import { PlusIcon } from "lucide-react"

import { Button } from "@/components/ui/button"

ネスト

<ButtonGroup> コンポーネントをネストして、間隔のあるボタングループを作成します。

import { AudioLinesIcon, PlusIcon } from "lucide-react"

import { Button } from "@/components/ui/button"

セパレーター

ButtonGroupSeparator コンポーネントは、グループ内のボタンを視覚的に区切ります。

outline バリアントのボタンはボーダーがあるため、セパレーターは不要です。その他のバリアントでは、視覚的な階層を改善するためにセパレーターの使用を推奨します。

import { Button } from "@/components/ui/button"
import {
  ButtonGroup,

分割

ButtonGroupSeparator で区切った 2 つのボタンを追加して、分割ボタングループを作成します。

import { IconPlus } from "@tabler/icons-react"

import { Button } from "@/components/ui/button"

Input

Input コンポーネントをボタンで囲みます。

import { SearchIcon } from "lucide-react"

import { Button } from "@/components/ui/button"

Input Group

InputGroup コンポーネントを囲んで、複雑な入力レイアウトを作成します。

"use client"

import * as React from "react"

DropdownMenu コンポーネントを使って分割ボタングループを作成します。

"use client"

import {

Select

Select コンポーネントと組み合わせます。

"use client"

import * as React from "react"

Popover

Popover コンポーネントと一緒に使用します。

import { BotIcon, ChevronDownIcon } from "lucide-react"

import { Button } from "@/components/ui/button"

RTL

Neobrutalism で RTL を有効にする方法は、RTL 設定ガイドをご覧ください。

"use client"

import * as React from "react"

アクセシビリティ

ButtonGrouprole="group" を描画します。支援技術に対しボタンがひとまとまりであることを伝えますが、キーボード挙動は変えません。各ボタンは独自のタブストップと、ネイティブの Enter / Space 起動を保ちます。スクリーンリーダーが文脈を読めるよう、aria-label または aria-labelledby でグループに名前を付けてください:

<ButtonGroup aria-label="Pagination">
  <Button>Previous</Button>
  <Button>Next</Button>
</ButtonGroup>

ButtonGroupSeparator は Base UI の Separator を包み、対応する aria-orientation 付きの role="separator" を描画します。区切りとして読み上げられ、フォーカスは当てられません。1つのタブストップで矢印キーによりボタン間を移動したい場合は WAI-ARIA Toolbar パターン です。このコンポーネントは意図的に通常のタブ順を維持します。

APIリファレンス

ButtonGroup

ButtonGroup コンポーネントは、関連するボタンを一貫したスタイルでまとめるコンテナです。

PropTypeDefault
orientation"horizontal" | "vertical""horizontal"
<ButtonGroup>
  <Button>Button 1</Button>
  <Button>Button 2</Button>
</ButtonGroup>

複数のボタングループをネストして、間隔のある複雑なレイアウトを作成できます。詳しくはネストの例をご覧ください。

<ButtonGroup>
  <ButtonGroup />
  <ButtonGroup />
</ButtonGroup>

ButtonGroupSeparator

ButtonGroupSeparator コンポーネントは、グループ内のボタンを視覚的に区切ります。

PropTypeDefault
orientation"horizontal" | "vertical""vertical"
<ButtonGroup>
  <Button>Button 1</Button>
  <ButtonGroupSeparator />
  <Button>Button 2</Button>
</ButtonGroup>

ButtonGroupText

このコンポーネントを使って、ボタングループ内にテキストを表示します。

PropTypeDefault
asChildbooleanfalse
<ButtonGroup>
  <ButtonGroupText>Text</ButtonGroupText>
  <Button>Button</Button>
</ButtonGroup>

asChild プロパティを使うと、カスタムコンポーネント(例えばラベル)をテキストとして表示できます。

import { ButtonGroupText } from "@/components/ui/button-group"
import { Label } from "@/components/ui/label"
 
export function ButtonGroupTextDemo() {
  return (
    <ButtonGroup>
      <ButtonGroupText asChild>
        <Label htmlFor="name">Text</Label>
      </ButtonGroupText>
      <Input placeholder="Type something here..." id="name" />
    </ButtonGroup>
  )
}