Button Group
Editor Toolbar
Панель инструментов с roving tabindex: Tab заходит внутрь один раз, дальше по значкам ходят стрелки, Home и End — как требует паттерн toolbar.
- buttongroup
- toolbar
- keyboard
- icons
Превью
Использовать с AI
- 1. Скопируйте ссылку.
- 2. Напишите агенту своими словами и вставьте её в предложение.
- 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.jsonhttps://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>
</>
)
}