VibeUI

Toggle Group

Format Toolbar

A formatting toolbar built from two toggle groups with real separators: multi-select type styles on the left, single-select alignment on the right.

  • togglegroup
  • toolbar
  • separator
  • roving-tabindex

Preview

1440pxHost theme

Use it with AI

  1. 1. Copy the link.
  2. 2. Write to your agent in your own words and drop the link into the sentence.
  3. 3. The agent opens the link and installs the component from the registry.

put this in the header: https://vibeui.ru/c/togglegroup-007?lang=en

Show the full instructions

What the link says, spelled out. Use it when your agent cannot open links — paste this text instead.

# Install and place "togglegroup-007" (Format Toolbar) from VibeUI

## 1. Install first — do not skip, do not recreate
Run this exact command before writing any code:
npx shadcn@latest add https://vibeui.ru/r/togglegroup-007.json

Registry item: https://vibeui.ru/r/togglegroup-007.json
Installs to: components/vibeui/togglegroup-007.tsx (the exact path follows this project's components.json aliases).
npm dependencies: none.
Registry dependencies: none.

Install it from the registry. Do not recreate it from the description,
do not substitute a similar component from another library, and do not
rewrite it to match the project's existing style.

## 2. What it is
A formatting toolbar built from two toggle groups with real separators: multi-select type styles on the left, single-select alignment on the right.

A formatting toolbar with separators: multi-select and single-select in one panel, focus moving by arrow keys. One file, zero dependencies.

## 3. How to use it
import { Togglegroup007 } from "@/components/vibeui/togglegroup-007"

<Togglegroup007
  label="Formatting"
  defaultAlign="left"
  defaultMarks={["bold"]}
/>

Read the installed file for the full prop list.

## 4. Where to place it
This is a small inline component. Put it exactly where the user asked,
inside the existing markup. Do not create a new page, section or
wrapper for it. If a similar control already sits in that spot,
replace it instead of adding a second one.

Placement: ___
(The user fills this line in. If it is still blank, ask where to put it
instead of guessing.)

## 5. Keep exactly as installed
- the local --vibeui-togglegroup-007-* palette — do not swap it for your theme tokens
- role="toolbar" with a roving tabindex: eight tab stops are eight extra keystrokes
- role="separator" on the dividers rather than a merely drawn line
- a name on every group: without them it is unclear where selection stacks and where it excludes
- aria-pressed on every button — these are states, not toolbar actions
- the visible focus ring: an icon panel without it cannot be crossed from the keyboard

## 6. You may change
- the toolbar name through label
- the initial alignment through defaultAlign
- the initial type styles through defaultMarks
- the pressed colour through accent

## 7. Rules
- The toolbar is deliberately narrow: the tool list is baked into the file and must not grow endlessly.
- onChange returns an object { align, marks } — single and multiple selection together.
- The toolbar does not wrap focus onto a second row: revisit navigation if the panel wraps.
- Do not lift the CSS variables into globals.css: the component has to stay a single file.

## 8. Verify
- it renders with no console errors;
- it looks like the preview on the VibeUI page you copied this from;
- if it does not, you changed something listed in section 5 — put it back.

For developers

npx shadcn@latest add https://vibeui.ru/r/togglegroup-007.json
https://vibeui.ru/r/togglegroup-007.json

Один файл, ноль зависимостей, палитра --vibeui-togglegroup-007-*. Клиентский: useState на выравнивание, на набор начертаний и на активный индекс, useRef на список кнопок. Корень — role="toolbar" с aria-orientation, внутри три role="group" со своими именами, между ними role="separator": панель из восьми значков подряд неразличима на слух, а разделитель режет её на смысловые куски. Фокус ходит по всей панели roving tabindex'ом — стрелки, Home и End, — а поведение внутри групп разное: слева состояния складываются, справа взаимно исключаются.

Component source

The same file your agent installs. Here in case you would rather copy it by hand.

"use client"

import { Fragment, useRef, useState } from "react"
import type {
  ComponentPropsWithoutRef,
  CSSProperties,
  KeyboardEvent,
} from "react"

export type Togglegroup007Props = Omit<
  ComponentPropsWithoutRef<"div">,
  "children" | "onChange"
> & {
  label?: string
  defaultAlign?: string
  defaultMarks?: string[]
  onChange?: (value: { align: string; marks: string[] }) => void
  accent?: string
}

// Идея компонента: панель форматирования из двух групп-тумблеров, разделённых
// настоящими separator'ами. Слева множественный выбор начертаний, справа
// одиночный выбор выравнивания — разное поведение внутри одной панели, поэтому
// каждая группа несёт своё имя, а фокус ходит по всей панели стрелками.
const STYLES = `
:where([data-vibeui-block="togglegroup-007"]){
--vibeui-togglegroup-007-bg:oklch(1 0 0);
--vibeui-togglegroup-007-fg:oklch(0.22 0.014 265);
--vibeui-togglegroup-007-muted:oklch(0.55 0.014 265);
--vibeui-togglegroup-007-border:oklch(0.9 0.006 265);
--vibeui-togglegroup-007-surface:oklch(0.975 0.004 265);
--vibeui-togglegroup-007-accent:oklch(0.54 0.17 255);
--vibeui-togglegroup-007-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="togglegroup-007"]{
box-sizing:border-box;display:inline-flex;align-items:center;gap:0.375rem;
max-width:100%;padding:0.3125rem;
border:1px solid var(--vibeui-togglegroup-007-border);border-radius:0.75rem;
background:var(--vibeui-togglegroup-007-bg);color:var(--vibeui-togglegroup-007-fg);
font-family:var(--vibeui-togglegroup-007-font);
box-shadow:0 1px 2px oklch(0.2 0.02 265 / 8%);
}
[data-vibeui-block="togglegroup-007"] *{box-sizing:border-box}
[data-vibeui-block="togglegroup-007"] [data-part="set"]{display:inline-flex;gap:0.125rem}
[data-vibeui-block="togglegroup-007"] button{
appearance:none;cursor:pointer;font:inherit;
display:inline-flex;align-items:center;justify-content:center;
width:2rem;height:2rem;padding:0;border:0;border-radius:0.5rem;
background:transparent;color:var(--vibeui-togglegroup-007-muted);
transition:background-color .15s ease,color .15s ease;
}
[data-vibeui-block="togglegroup-007"] button svg{width:1rem;height:1rem}
[data-vibeui-block="togglegroup-007"] button:hover{background:var(--vibeui-togglegroup-007-surface);color:var(--vibeui-togglegroup-007-fg)}
[data-vibeui-block="togglegroup-007"] button:focus-visible{
outline:2px solid var(--vibeui-togglegroup-007-accent);outline-offset:1px;
}
[data-vibeui-block="togglegroup-007"] button[aria-pressed="true"]{
background:color-mix(in oklab,var(--vibeui-togglegroup-007-accent) 12%,white);
color:var(--vibeui-togglegroup-007-accent);
}
/* Разделитель объявлен ролью, а не просто нарисован: панель из девяти
   значков подряд неразличима на слух, а separator режет её на группы. */
[data-vibeui-block="togglegroup-007"] [data-part="sep"]{
flex:none;width:1px;height:1.25rem;margin:0 0.1875rem;
background:var(--vibeui-togglegroup-007-border);
}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="togglegroup-007"] *{animation:none!important;transition:none!important}}
`

type Section = {
  id: string
  label: string
  mode: "multi" | "single"
  items: { id: string; label: string; d: string }[]
}

const SECTIONS: Section[] = [
  {
    id: "marks",
    label: "Начертание",
    mode: "multi",
    items: [
      {
        id: "bold",
        label: "Полужирный",
        d: "M5.4 3h4a2.6 2.6 0 0 1 0 5.2h-4zm0 5.2h4.6a2.8 2.8 0 0 1 0 5.6H5.4z",
      },
      {
        id: "italic",
        label: "Курсив",
        d: "M11.4 3.2H7.6M8.8 12.8H5M9.8 3.2 7 12.8",
      },
      {
        id: "strike",
        label: "Зачёркнутый",
        d: "M3.2 8h9.6M11 4.6C10.4 3.6 9.3 3 8 3 6.3 3 5 3.9 5 5.3 5 6.4 5.8 7 7 7.5M5 11.4c.6 1 1.7 1.6 3 1.6 1.7 0 3-.9 3-2.3",
      },
    ],
  },
  {
    id: "align",
    label: "Выравнивание",
    mode: "single",
    items: [
      { id: "left", label: "По левому краю", d: "M2.5 4h11M2.5 8h7M2.5 12h11" },
      { id: "center", label: "По центру", d: "M2.5 4h11M4.5 8h7M2.5 12h11" },
      {
        id: "right",
        label: "По правому краю",
        d: "M2.5 4h11M6.5 8h7M2.5 12h11",
      },
    ],
  },
  {
    id: "blocks",
    label: "Блоки",
    mode: "multi",
    items: [
      {
        id: "list",
        label: "Маркированный список",
        d: "M6 4h7.5M6 8h7.5M6 12h7.5M3 4h.01M3 8h.01M3 12h.01",
      },
      {
        id: "quote",
        label: "Цитата",
        d: "M3.5 12V8.5C3.5 5.8 4.9 4.3 7 4M9 12V8.5C9 5.8 10.4 4.3 12.5 4",
      },
    ],
  },
]

const FLAT = SECTIONS.flatMap((section) =>
  section.items.map((item) => ({ section, item })),
)

/**
 * Панель форматирования с разделителями: множественный и одиночный выбор
 * в одной панели, фокус ходит стрелками. Один файл, ноль зависимостей.
 */
export function Togglegroup007({
  label = "Форматирование",
  defaultAlign = "left",
  defaultMarks = ["bold"],
  onChange,
  accent,
  className,
  style,
  ...props
}: Togglegroup007Props) {
  const [align, setAlign] = useState(defaultAlign)
  const [marks, setMarks] = useState<string[]>(defaultMarks)
  const [active, setActive] = useState(0)
  const buttons = useRef<(HTMLButtonElement | null)[]>([])

  const palette = {
    ...(accent ? { "--vibeui-togglegroup-007-accent": accent } : null),
    ...style,
  } as CSSProperties

  const focusAt = (index: number) => {
    const last = FLAT.length - 1
    const target = index < 0 ? last : index > last ? 0 : index

    setActive(target)
    buttons.current[target]?.focus()
  }

  const onKeyDown = (
    event: KeyboardEvent<HTMLButtonElement>,
    index: number,
  ) => {
    if (event.key === "ArrowRight") {
      event.preventDefault()
      focusAt(index + 1)
    } else if (event.key === "ArrowLeft") {
      event.preventDefault()
      focusAt(index - 1)
    } else if (event.key === "Home") {
      event.preventDefault()
      focusAt(0)
    } else if (event.key === "End") {
      event.preventDefault()
      focusAt(FLAT.length - 1)
    }
  }

  const press = (section: Section, id: string) => {
    if (section.mode === "single") {
      setAlign(id)
      onChange?.({ align: id, marks })
      return
    }

    const next = marks.includes(id)
      ? marks.filter((mark) => mark !== id)
      : [...marks, id]

    setMarks(next)
    onChange?.({ align, marks: next })
  }

  return (
    <>
      <style href="vibeui-togglegroup-007" precedence="medium">
        {STYLES}
      </style>
      <div
        {...props}
        data-vibeui-block="togglegroup-007"
        role="toolbar"
        aria-label={label}
        aria-orientation="horizontal"
        className={className}
        style={palette}
      >
        {SECTIONS.map((section, sectionIndex) => (
          <Fragment key={section.id}>
            {sectionIndex > 0 ? (
              <span
                data-part="sep"
                role="separator"
                aria-orientation="vertical"
              />
            ) : null}
            <span data-part="set" role="group" aria-label={section.label}>
              {section.items.map((item) => {
                const index = FLAT.findIndex(
                  (entry) => entry.item.id === item.id,
                )
                const pressed =
                  section.mode === "single"
                    ? align === item.id
                    : marks.includes(item.id)

                return (
                  <button
                    key={item.id}
                    ref={(node) => {
                      buttons.current[index] = node
                    }}
                    type="button"
                    aria-pressed={pressed}
                    aria-label={item.label}
                    title={item.label}
                    tabIndex={index === active ? 0 : -1}
                    onKeyDown={(event) => onKeyDown(event, index)}
                    onFocus={() => setActive(index)}
                    onClick={() => press(section, item.id)}
                  >
                    <svg viewBox="0 0 16 16" fill="none" aria-hidden="true">
                      <path
                        d={item.d}
                        fill={item.id === "bold" ? "currentColor" : "none"}
                        stroke="currentColor"
                        strokeWidth={item.id === "bold" ? 0 : 1.4}
                        strokeLinecap="round"
                        strokeLinejoin="round"
                      />
                    </svg>
                  </button>
                )
              })}
            </span>
          </Fragment>
        ))}
      </div>
    </>
  )
}