Button Group

Editor Toolbar

Панель инструментов с roving tabindex: Tab заходит внутрь один раз, дальше по значкам ходят стрелки, Home и End — как требует паттерн toolbar.

  • buttongroup
  • toolbar
  • keyboard
  • icons

Превью

1440pxHost theme

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

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

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

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

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

# Установка и размещение «buttongroup-004» (Editor Toolbar) из VibeUI

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

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

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

## 2. Что это
Панель инструментов с roving tabindex: Tab заходит внутрь один раз, дальше по значкам ходят стрелки, Home и End — как требует паттерн toolbar.

Панель инструментов, которая занимает одну остановку Tab: внутри навигация стрелками, Home и End. Ноль зависимостей, один файл, клиентский компонент.

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

<Buttongroup004
  tools={[{ id: "bold", label: "Жирный" }, { id: "link", label: "Ссылка" }]}
  label="Форматирование"
  showLabels={false}
/>

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

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

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

## 5. Сохранить как установлено
- локальную палитру --vibeui-buttongroup-004-* и не подменять её токенами вашей темы
- roving tabindex: без него панель из шести значков крадёт шесть нажатий Tab у страницы
- role="toolbar" вместе с aria-orientation — по ним скринридер обещает пользователю стрелки
- перенос по кругу в стрелках: паттерн toolbar требует именно цикла, а не упора в край
- синхронизацию индекса в onFocus — иначе после клика мышью стрелки поедут не с той кнопки
- aria-label у кнопки, пока подписи скрыты: голый значок не имеет доступного имени

## 6. Можно менять
- набор инструментов через tools
- доступное имя панели через label
- показ текстовых подписей через showLabels
- цвет обводки фокуса через accent

## 7. Правила
- Кнопки без onClick: подключите свои команды редактора при установке.
- Разделитель стоит после третьей кнопки жёстко — под свой набор перенесите его в данные.
- Для кнопок-тумблеров (жирный включён) добавьте aria-pressed: сам roving tabindex состояние не объявляет.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.

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

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

npx shadcn@latest add https://vibeui.ru/r/buttongroup-004.json
https://vibeui.ru/r/buttongroup-004.json

Компонент самодостаточен: один файл, без зависимостей, собственная палитра в переменных --vibeui-buttongroup-004-*. Клиентский: useState хранит индекс активной кнопки, useRef держит панель, обработчик onKeyDown разбирает ArrowLeft/ArrowRight с переносом по кругу и Home/End. Активной кнопке ставится tabIndex=0, остальным -1 — это roving tabindex из паттерна toolbar WAI-ARIA. onFocus синхронизирует индекс, если фокус пришёл мышью. Значки — инлайновые SVG с stroke="currentColor", разделитель между третьей и четвёртой кнопкой рисуется отдельным узлом. Подписи включаются пропсом showLabels: тогда aria-label снимается, чтобы имя не задваивалось.

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

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

"use client"

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

export type Buttongroup004Tool = {
  id: string
  label: string
}

export type Buttongroup004Props = Omit<
  ComponentPropsWithoutRef<"div">,
  "children"
> & {
  tools?: Buttongroup004Tool[]
  label?: string
  showLabels?: boolean
  accent?: string
}

// Идея компонента: панель инструментов ведёт себя как один элемент табуляции.
// Внутрь Tab заходит один раз, дальше по кнопкам ходят стрелки, Home и End —
// это roving tabindex, требование паттерна toolbar из WAI-ARIA. Без него
// панель из восьми значков крадёт восемь нажатий Tab у остальной страницы.
const STYLES = `
:where([data-vibeui-block="buttongroup-004"]){
--vibeui-buttongroup-004-surface:oklch(1 0 0);
--vibeui-buttongroup-004-fg:oklch(0.27 0.016 265);
--vibeui-buttongroup-004-muted:oklch(0.52 0.014 265);
--vibeui-buttongroup-004-border:oklch(0.89 0.008 265);
--vibeui-buttongroup-004-hover:oklch(0.96 0.004 265);
--vibeui-buttongroup-004-accent:oklch(0.55 0.17 265);
--vibeui-buttongroup-004-radius:0.75rem;
--vibeui-buttongroup-004-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="buttongroup-004"]{
box-sizing:border-box;display:inline-flex;align-items:center;gap:0.125rem;
padding:0.25rem;
border:1px solid var(--vibeui-buttongroup-004-border);
border-radius:var(--vibeui-buttongroup-004-radius);
background:var(--vibeui-buttongroup-004-surface);
font-family:var(--vibeui-buttongroup-004-font);
box-shadow:0 1px 2px oklch(0.2 0.02 265 / 6%);
}
[data-vibeui-block="buttongroup-004"] *{box-sizing:border-box}
[data-vibeui-block="buttongroup-004"] [data-part="tool"]{
appearance:none;cursor:pointer;font:inherit;
display:inline-flex;flex-direction:column;align-items:center;justify-content:center;gap:0.1875rem;
min-width:2rem;height:2rem;padding:0 0.375rem;
border:0;border-radius:0.5rem;background:transparent;
color:var(--vibeui-buttongroup-004-muted);
transition:background-color .16s ease,color .16s ease;
}
[data-vibeui-block="buttongroup-004"][data-labels="on"] [data-part="tool"]{height:2.75rem;min-width:2.75rem}
[data-vibeui-block="buttongroup-004"] [data-part="tool"]:hover{
background:var(--vibeui-buttongroup-004-hover);
color:var(--vibeui-buttongroup-004-fg);
}
[data-vibeui-block="buttongroup-004"] [data-part="tool"]:focus-visible{
outline:2px solid var(--vibeui-buttongroup-004-accent);outline-offset:1px;
color:var(--vibeui-buttongroup-004-fg);
}
[data-vibeui-block="buttongroup-004"] [data-part="tool"] svg{width:1rem;height:1rem;flex:none}
[data-vibeui-block="buttongroup-004"] [data-part="text"]{font-size:0.5625rem;font-weight:600;letter-spacing:0.01em}
[data-vibeui-block="buttongroup-004"] [data-part="divider"]{
width:1px;align-self:stretch;margin:0.25rem 0.25rem;
background:var(--vibeui-buttongroup-004-border);
}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="buttongroup-004"] *{animation:none!important;transition:none!important}}
`

const DEFAULT_TOOLS: Buttongroup004Tool[] = [
  { id: "bold", label: "Жирный" },
  { id: "italic", label: "Курсив" },
  { id: "link", label: "Ссылка" },
  { id: "list", label: "Список" },
  { id: "quote", label: "Цитата" },
  { id: "code", label: "Код" },
]

const ICONS: Record<string, string> = {
  bold: "M6 3.5h5a3.25 3.25 0 0 1 0 6.5H6zM6 10h5.5a3.25 3.25 0 0 1 0 6.5H6z",
  italic: "M10 3.5h5m-7 13h5M12.5 3.5l-2.5 13",
  link: "M9 12a3.5 3.5 0 0 0 5 0l2-2a3.5 3.5 0 0 0-5-5l-1 1M11 8a3.5 3.5 0 0 0-5 0l-2 2a3.5 3.5 0 0 0 5 5l1-1",
  list: "M7 5.5h11M7 10h11M7 14.5h11M3.5 5.5h.01M3.5 10h.01M3.5 14.5h.01",
  quote:
    "M8 5.5C5.5 6.8 4.5 8.7 4.5 11v3.5h4V10H6.4c.1-1.3.7-2.3 1.9-3zM17 5.5c-2.5 1.3-3.5 3.2-3.5 5.5v3.5h4V10h-2.1c.1-1.3.7-2.3 1.9-3z",
  code: "M8 6.5 3.5 10 8 13.5M14 6.5 18.5 10 14 13.5",
}

/**
 * Панель инструментов с roving tabindex: стрелки, Home и End.
 * Один файл, ноль зависимостей, собственная палитра.
 */
export function Buttongroup004({
  tools = DEFAULT_TOOLS,
  label = "Форматирование",
  showLabels = false,
  accent,
  className,
  style,
  ...props
}: Buttongroup004Props) {
  const [active, setActive] = useState(0)
  const bar = useRef<HTMLDivElement>(null)

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

  function focusAt(next: number) {
    const buttons =
      bar.current?.querySelectorAll<HTMLButtonElement>('[data-part="tool"]')
    setActive(next)
    buttons?.[next]?.focus()
  }

  function onKeyDown(event: KeyboardEvent<HTMLDivElement>) {
    const last = tools.length - 1
    const step =
      event.key === "ArrowRight" ? 1 : event.key === "ArrowLeft" ? -1 : 0

    if (step !== 0) {
      event.preventDefault()
      focusAt((active + step + tools.length) % tools.length)
      return
    }

    if (event.key === "Home") {
      event.preventDefault()
      focusAt(0)
    }

    if (event.key === "End") {
      event.preventDefault()
      focusAt(last)
    }
  }

  return (
    <>
      <style href="vibeui-buttongroup-004" precedence="medium">
        {STYLES}
      </style>
      <div
        {...props}
        ref={bar}
        data-vibeui-block="buttongroup-004"
        data-labels={showLabels ? "on" : "off"}
        role="toolbar"
        aria-orientation="horizontal"
        aria-label={label}
        onKeyDown={onKeyDown}
        className={className}
        style={palette}
      >
        {tools.map((tool, index) => (
          <span key={tool.id} style={{ display: "contents" }}>
            {index === 3 ? (
              <span data-part="divider" aria-hidden="true" />
            ) : null}
            <button
              type="button"
              data-part="tool"
              tabIndex={index === active ? 0 : -1}
              aria-label={showLabels ? undefined : tool.label}
              onFocus={() => setActive(index)}
            >
              <svg viewBox="0 0 22 20" fill="none" aria-hidden="true">
                <path
                  d={ICONS[tool.id] ?? ICONS.code}
                  stroke="currentColor"
                  strokeWidth="1.6"
                  strokeLinecap="round"
                  strokeLinejoin="round"
                />
              </svg>
              {showLabels ? <span data-part="text">{tool.label}</span> : null}
            </button>
          </span>
        ))}
      </div>
    </>
  )
}