Button Group
Editor Toolbar
A toolbar with roving tabindex: Tab enters once and from there arrows, Home and End walk the icons — exactly as the toolbar pattern requires.
- buttongroup
- toolbar
- keyboard
- icons
Preview
Use it with AI
- 1. Copy the link.
- 2. Write to your agent in your own words and drop the link into the sentence.
- 3. The agent opens the link and installs the component from the registry.
put this in the header: https://vibeui.ru/c/buttongroup-004?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 "buttongroup-004" (Editor 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/buttongroup-004.json
Registry item: https://vibeui.ru/r/buttongroup-004.json
Installs to: components/vibeui/buttongroup-004.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 toolbar with roving tabindex: Tab enters once and from there arrows, Home and End walk the icons — exactly as the toolbar pattern requires.
A toolbar that takes a single Tab stop: arrows, Home and End navigate inside it. Zero dependencies, one file, a client component.
## 3. How to use it
import { Buttongroup004 } from "@/components/vibeui/buttongroup-004"
<Buttongroup004
tools={[{ id: "bold", label: "Bold" }, { id: "link", label: "Link" }]}
label="Formatting"
showLabels={false}
/>
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-buttongroup-004-* palette — do not swap it for your theme tokens
- the roving tabindex: without it a six-icon bar steals six Tab presses from the page
- role="toolbar" together with aria-orientation — they are the promise of arrow keys to a screen reader
- the wrap-around on the arrows: the toolbar pattern asks for a cycle, not a dead end at the edge
- the index sync in onFocus — otherwise after a mouse click the arrows resume from the wrong button
- the aria-label on each button while captions are hidden: a bare icon has no accessible name
## 6. You may change
- the set of instruments through tools
- the accessible toolbar name through label
- visible text captions through showLabels
- the focus ring colour through accent
## 7. Rules
- The buttons carry no onClick: wire your editor commands at install time.
- The divider is hard-coded after the third button — move it into your data for another set.
- For toggle buttons (bold is on) add aria-pressed: roving tabindex announces no state by itself.
- 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/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 снимается, чтобы имя не задваивалось.
Component source
The same file your agent installs. Here in case you would rather copy it by hand.
"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>
</>
)
}