Button Group
Vertical Actions
Вертикальная группа для узкой колонки: кнопки во всю ширину, границы схлопнуты по вертикали, подпись слева, подсказка справа.
- buttongroup
- vertical
- sidebar
- actions
Превью
Использовать с AI
- 1. Скопируйте ссылку.
- 2. Напишите агенту своими словами и вставьте её в предложение.
- 3. Агент откроет ссылку и поставит компонент из registry.
размести это в шапке: https://vibeui.ru/c/buttongroup-007
Показать полную инструкцию
То, что лежит по ссылке в развёрнутом виде. Нужна, если агент не может открыть ссылку — тогда вставьте этот текст целиком.
# Установка и размещение «buttongroup-007» (Vertical Actions) из VibeUI
## 1. Сначала установка — не пропускай, не пересоздавай
Выполни эту команду до того, как писать код:
npx shadcn@latest add https://vibeui.ru/r/buttongroup-007.json
Registry item: https://vibeui.ru/r/buttongroup-007.json
Ставится в: components/vibeui/buttongroup-007.tsx (точный путь следует алиасам components.json этого проекта).
npm-зависимости: нет.
Registry-зависимости: нет.
Ставь из реестра. Не пересоздавай по описанию, не подменяй похожим
компонентом из другой библиотеки и не переписывай под стиль проекта.
## 2. Что это
Вертикальная группа для узкой колонки: кнопки во всю ширину, границы схлопнуты по вертикали, подпись слева, подсказка справа.
Список действий, сложенный в столбец для узкой колонки: одна сцепка вместо порванной на две строки строки кнопок. Ноль зависимостей, один файл, серверный компонент.
## 3. Как использовать
import { Buttongroup007 } from "@/components/vibeui/buttongroup-007"
<Buttongroup007
actions={[{ label: "Переименовать", hint: "F2" }, { label: "Переместить", hint: "⌘M" }]}
label="Операции с файлом"
width={16}
/>
Полный список пропсов — в установленном файле.
## 4. Куда поставить
Это мелкий inline-компонент. Поставь его ровно туда, куда просил
пользователь, внутрь существующей разметки. Не создавай ради него
новую страницу, секцию или обёртку. Если на этом месте уже стоит похожий
контрол — замени его, а не добавляй второй.
Куда поставить: ___
(Эту строку заполняет пользователь. Если она осталась пустой — спроси,
а не угадывай.)
## 5. Сохранить как установлено
- локальную палитру --vibeui-buttongroup-007-* и не подменять её токенами вашей темы
- схлопнутые границы по вертикали: две соседние рамки дают линию в два пикселя
- z-index при фокусе — нижнюю границу кнопки перекрывает следующая, и обводка иначе видна только сверху
- скругления только у первой и последней кнопки, чтобы столбец читался одной деталью
- выравнивание подписи по левому краю: по центру глаз теряет колонку названий
- собственную светлую подложку кнопок — без неё тёмный текст пропадает на тёмном фоне
## 6. Можно менять
- набор действий и подсказок через actions
- доступное имя группы через label
- ширину столбца через width
- цвет обводки фокуса через accent
## 7. Правила
- Подсказка справа — не горячая клавиша по умолчанию: туда одинаково ложатся счётчик и размер.
- Подписи не переносятся по умолчанию только визуально: длинный текст растянет строку по высоте.
- Кнопки без onClick: подключите свои обработчики при установке.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.
## 8. Проверка
- рендерится без ошибок в консоли;
- выглядит так же, как превью на странице VibeUI, откуда взята ссылка;
- если нет — ты изменил что-то из раздела 5, верни как было.Для разработчика
npx shadcn@latest add https://vibeui.ru/r/buttongroup-007.jsonhttps://vibeui.ru/r/buttongroup-007.jsonКомпонент самодостаточен: один файл, без зависимостей, собственная палитра в переменных --vibeui-buttongroup-007-*. Серверный: хуков нет. Ширина считается от собственной: width:100% с max-width из --vibeui-buttongroup-007-width, значение приходит пропсом width в rem. Границы схлопнуты по вертикали через margin-block-start:-1px, скругления логическими свойствами достаются только первой и последней кнопке. Кнопка с фокусом поднимается z-index:2, потому что соседняя перекрывает её нижнюю границу. Подпись занимает всё свободное место (flex:1 1 auto; min-width:0), подсказка прижата к правому краю и набрана табличными цифрами.
Исходник компонента
Тот же файл, который поставит агент. Нужен, если вы предпочитаете скопировать код руками.
import type { ComponentPropsWithoutRef, CSSProperties } from "react"
export type Buttongroup007Action = {
label: string
hint?: string
}
export type Buttongroup007Props = Omit<
ComponentPropsWithoutRef<"div">,
"children"
> & {
actions?: Buttongroup007Action[]
label?: string
width?: number
accent?: string
}
// Идея компонента: в узкой колонке горизонтальная группа рвётся на две
// строки и перестаёт читаться как одна деталь. Здесь она сложена в столбец:
// кнопки во всю ширину, границы схлопнуты по вертикали, скругления остались
// только у верхней и нижней. Подпись прижата к левому краю, подсказка — к
// правому: так глаз идёт по одной колонке названий, а не по центру.
const STYLES = `
:where([data-vibeui-block="buttongroup-007"]){
--vibeui-buttongroup-007-surface:oklch(1 0 0);
--vibeui-buttongroup-007-fg:oklch(0.26 0.016 265);
--vibeui-buttongroup-007-muted:oklch(0.58 0.014 265);
--vibeui-buttongroup-007-border:oklch(0.89 0.008 265);
--vibeui-buttongroup-007-hover:oklch(0.965 0.004 265);
--vibeui-buttongroup-007-accent:oklch(0.55 0.17 265);
--vibeui-buttongroup-007-radius:0.75rem;
--vibeui-buttongroup-007-width:16rem;
--vibeui-buttongroup-007-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="buttongroup-007"]{
box-sizing:border-box;display:flex;flex-direction:column;isolation:isolate;
width:100%;max-width:var(--vibeui-buttongroup-007-width);
font-family:var(--vibeui-buttongroup-007-font);
}
[data-vibeui-block="buttongroup-007"] *{box-sizing:border-box}
[data-vibeui-block="buttongroup-007"] button{
appearance:none;cursor:pointer;font:inherit;
position:relative;z-index:0;
display:flex;align-items:center;gap:0.625rem;
width:100%;min-height:2.375rem;padding:0 0.75rem;margin-block-start:-1px;
border:1px solid var(--vibeui-buttongroup-007-border);
background:var(--vibeui-buttongroup-007-surface);
color:var(--vibeui-buttongroup-007-fg);
font-size:0.8125rem;font-weight:600;line-height:1.3;text-align:start;
transition:background-color .16s ease;
}
[data-vibeui-block="buttongroup-007"] button:first-child{
margin-block-start:0;
border-start-start-radius:var(--vibeui-buttongroup-007-radius);
border-start-end-radius:var(--vibeui-buttongroup-007-radius);
}
[data-vibeui-block="buttongroup-007"] button:last-child{
border-end-start-radius:var(--vibeui-buttongroup-007-radius);
border-end-end-radius:var(--vibeui-buttongroup-007-radius);
}
[data-vibeui-block="buttongroup-007"] button:hover{z-index:1;background:var(--vibeui-buttongroup-007-hover)}
/* Соседняя кнопка перекрывает нижнюю границу текущей, поэтому обводке
фокуса нужен свой слой — иначе она видна только сверху. */
[data-vibeui-block="buttongroup-007"] button:focus-visible{
z-index:2;
outline:2px solid var(--vibeui-buttongroup-007-accent);outline-offset:1px;
}
[data-vibeui-block="buttongroup-007"] [data-part="dot"]{
width:0.375rem;height:0.375rem;flex:none;border-radius:9999px;
background:var(--vibeui-buttongroup-007-accent);opacity:.35;
}
[data-vibeui-block="buttongroup-007"] button:hover [data-part="dot"]{opacity:1}
[data-vibeui-block="buttongroup-007"] [data-part="name"]{flex:1 1 auto;min-width:0}
[data-vibeui-block="buttongroup-007"] [data-part="hint"]{
flex:none;color:var(--vibeui-buttongroup-007-muted);
font-size:0.75rem;font-weight:500;font-variant-numeric:tabular-nums;
}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="buttongroup-007"] *{animation:none!important;transition:none!important}}
`
const DEFAULT_ACTIONS: Buttongroup007Action[] = [
{ label: "Переименовать", hint: "F2" },
{ label: "Переместить", hint: "⌘M" },
{ label: "Скачать копию", hint: "2,4 МБ" },
{ label: "История версий", hint: "12" },
]
/**
* Вертикальная группа кнопок во всю ширину узкой колонки.
* Один файл, ноль зависимостей, собственная палитра.
*/
export function Buttongroup007({
actions = DEFAULT_ACTIONS,
label = "Операции с файлом",
width = 16,
accent,
className,
style,
...props
}: Buttongroup007Props) {
const palette = {
"--vibeui-buttongroup-007-width": `${width}rem`,
...(accent ? { "--vibeui-buttongroup-007-accent": accent } : null),
...style,
} as CSSProperties
return (
<>
<style href="vibeui-buttongroup-007" precedence="medium">
{STYLES}
</style>
<div
{...props}
data-vibeui-block="buttongroup-007"
role="group"
aria-label={label}
className={className}
style={palette}
>
{actions.map((action) => (
<button key={action.label} type="button">
<span data-part="dot" aria-hidden="true" />
<span data-part="name">{action.label}</span>
{action.hint ? <span data-part="hint">{action.hint}</span> : null}
</button>
))}
</div>
</>
)
}