Toggle Group

Format Toolbar

Панель форматирования из двух групп-тумблеров с настоящими разделителями: слева множественный выбор начертаний, справа одиночный выбор выравнивания.

  • togglegroup
  • toolbar
  • separator
  • roving-tabindex

Превью

1440pxHost theme

Использовать с AI

  1. 1. Скопируйте ссылку.
  2. 2. Напишите агенту своими словами и вставьте её в предложение.
  3. 3. Агент откроет ссылку и поставит компонент из registry.

размести это в шапке: https://vibeui.ru/c/togglegroup-007

Показать полную инструкцию

То, что лежит по ссылке в развёрнутом виде. Нужна, если агент не может открыть ссылку — тогда вставьте этот текст целиком.

# Установка и размещение «togglegroup-007» (Format Toolbar) из VibeUI

## 1. Сначала установка — не пропускай, не пересоздавай
Выполни эту команду до того, как писать код:
npx shadcn@latest add https://vibeui.ru/r/togglegroup-007.json

Registry item: https://vibeui.ru/r/togglegroup-007.json
Ставится в: components/vibeui/togglegroup-007.tsx (точный путь следует алиасам components.json этого проекта).
npm-зависимости: нет.
Registry-зависимости: нет.

Ставь из реестра. Не пересоздавай по описанию, не подменяй похожим
компонентом из другой библиотеки и не переписывай под стиль проекта.

## 2. Что это
Панель форматирования из двух групп-тумблеров с настоящими разделителями: слева множественный выбор начертаний, справа одиночный выбор выравнивания.

Панель форматирования с разделителями: множественный и одиночный выбор в одной панели, фокус ходит стрелками. Один файл, ноль зависимостей.

## 3. Как использовать
import { Togglegroup007 } from "@/components/vibeui/togglegroup-007"

<Togglegroup007
  label="Форматирование"
  defaultAlign="left"
  defaultMarks={["bold"]}
/>

Полный список пропсов — в установленном файле.

## 4. Куда поставить
Это мелкий inline-компонент. Поставь его ровно туда, куда просил
пользователь, внутрь существующей разметки. Не создавай ради него
новую страницу, секцию или обёртку. Если на этом месте уже стоит похожий
контрол — замени его, а не добавляй второй.

Куда поставить: ___
(Эту строку заполняет пользователь. Если она осталась пустой — спроси,
а не угадывай.)

## 5. Сохранить как установлено
- локальную палитру --vibeui-togglegroup-007-* и не подменять её токенами вашей темы
- role="toolbar" с roving tabindex: восемь остановок в табе — это восемь лишних нажатий
- role="separator" у разделителей, а не просто нарисованную полоску
- имена у каждой группы: без них непонятно, где выбор складывается, а где исключает
- aria-pressed на каждой кнопке — это состояния, а не действия панели
- видимую обводку фокуса: панель значков без неё непроходима с клавиатуры

## 6. Можно менять
- имя панели через label
- начальное выравнивание через defaultAlign
- начальный набор начертаний через defaultMarks
- цвет нажатых кнопок через accent

## 7. Правила
- Панель узкая по смыслу: список инструментов зашит в файл, растить его бесконечно нельзя.
- onChange отдаёт объект { align, marks } — одиночный и множественный выбор вместе.
- Toolbar не заворачивает фокус на другую строку: при переносе панели пересмотрите навигацию.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.

## 8. Проверка
- рендерится без ошибок в консоли;
- выглядит так же, как превью на странице VibeUI, откуда взята ссылка;
- если нет — ты изменил что-то из раздела 5, верни как было.

Для разработчика

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, — а поведение внутри групп разное: слева состояния складываются, справа взаимно исключаются.

Исходник компонента

Тот же файл, который поставит агент. Нужен, если вы предпочитаете скопировать код руками.

"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>
    </>
  )
}