Button Group
Role Ladder
Роли лестницей от старшей к младшей: выбор подсвечивает и сам сегмент, и все правее — так видно, что редактор умеет всё, что умеет читатель.
- buttongroup
- roles
- permissions
- sibling
Превью
1440pxHost theme
Использовать с AI
- 1. Скопируйте ссылку.
- 2. Напишите агенту своими словами и вставьте её в предложение.
- 3. Агент откроет ссылку и поставит компонент из registry.
размести это в шапке: https://vibeui.ru/c/buttongroup-050
Показать полную инструкцию
То, что лежит по ссылке в развёрнутом виде. Нужна, если агент не может открыть ссылку — тогда вставьте этот текст целиком.
# Установка и размещение «buttongroup-050» (Role Ladder) из VibeUI
## 1. Сначала установка — не пропускай, не пересоздавай
Выполни эту команду до того, как писать код:
npx shadcn@latest add https://vibeui.ru/r/buttongroup-050.json
Registry item: https://vibeui.ru/r/buttongroup-050.json
Ставится в: components/vibeui/buttongroup-050.tsx (точный путь следует алиасам components.json этого проекта).
npm-зависимости: нет.
Registry-зависимости: нет.
Ставь из реестра. Не пересоздавай по описанию, не подменяй похожим
компонентом из другой библиотеки и не переписывай под стиль проекта.
## 2. Что это
Роли лестницей от старшей к младшей: выбор подсвечивает и сам сегмент, и все правее — так видно, что редактор умеет всё, что умеет читатель.
Выбор роли лестницей, где младшие права подсвечиваются вместе с выбранной. Ноль зависимостей, один файл, серверный компонент.
## 3. Как использовать
import { Buttongroup050 } from "@/components/vibeui/buttongroup-050"
<Buttongroup050
roles={[{ id: "editor", label: "Редактор", scope: "правка контента" }]}
defaultValue="editor"
hint="Роль включает права правее неё."
name="role"
/>
Полный список пропсов — в установленном файле.
## 4. Куда поставить
Это мелкий inline-компонент. Поставь его ровно туда, куда просил
пользователь, внутрь существующей разметки. Не создавай ради него
новую страницу, секцию или обёртку. Если на этом месте уже стоит похожий
контрол — замени его, а не добавляй второй.
Куда поставить: ___
(Эту строку заполняет пользователь. Если она осталась пустой — спроси,
а не угадывай.)
## 5. Сохранить как установлено
- локальную палитру --vibeui-buttongroup-050-* и не подменять её токенами вашей темы
- порядок от старшей роли к младшей: подсветка построена на соседнем комбинаторе и порядок здесь смысловой
- разную силу заливки у выбранной и включённых ролей — иначе непонятно, что именно выбрано
- подпись прав второй строкой: названия ролей в каждом продукте значат своё
- поясняющую строку под группой — приём с подсветкой правее сам себя не объясняет
- clear:both у legend: legend с float:left иначе заставит grid-детей обтекать себя
## 6. Можно менять
- набор ролей и их права через roles
- исходную роль через defaultValue
- поясняющую строку через hint и имя группы через label
- имя поля формы через name и цвет выделения через accent
## 7. Правила
- Порядок ролей обязан идти по убыванию прав: иначе подсветка соврёт о вложенности.
- Больше четырёх ролей не помещаются в равные колонки на телефоне.
- Компонент не проверяет права: назначение роли делает ваш код после отправки формы.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.
## 8. Проверка
- рендерится без ошибок в консоли;
- выглядит так же, как превью на странице VibeUI, откуда взята ссылка;
- если нет — ты изменил что-то из раздела 5, верни как было.Для разработчика
npx shadcn@latest add https://vibeui.ru/r/buttongroup-050.jsonhttps://vibeui.ru/r/buttongroup-050.jsonКомпонент самодостаточен: один файл, без зависимостей, собственная палитра в переменных --vibeui-buttongroup-050-*. Серверный: выбор держат radio внутри fieldset. Вложенность прав показана соседним комбинатором: [data-part="step"]:has(input:checked) ~ [data-part="step"] заливает все младшие роли слабее, чем выбранную. Поэтому порядок сегментов не декоративный, а смысловой — перестановка сломает логику. Границы схлопнуты через margin-inline-start:-1px, скругления только крайним, выбранная роль поднята z-index:1, сфокусированная — z-index:2. Legend видимый, с float:left;width:100%;clear:both, иначе следующие grid-дети обтекали бы его.
Исходник компонента
Тот же файл, который поставит агент. Нужен, если вы предпочитаете скопировать код руками.
import type { ComponentPropsWithoutRef, CSSProperties } from "react"
export type Buttongroup050Role = {
id: string
label: string
scope: string
}
export type Buttongroup050Props = Omit<
ComponentPropsWithoutRef<"fieldset">,
"children"
> & {
roles?: Buttongroup050Role[]
defaultValue?: string
hint?: string
label?: string
name?: string
accent?: string
}
// Идея компонента: роли выстроены лестницей от старшей к младшей, и выбор
// подсвечивает не только сам сегмент, но и все, что правее. Это показывает
// вложенность прав: редактор умеет всё, что умеет читатель. Приём держится
// на соседнем комбинаторе — label:has(input:checked) ~ label, — поэтому
// порядок сегментов не декоративный, а смысловой: перестановка сломает
// логику. Младшие сегменты залиты слабее старшего: включённое право и
// выбранная роль не должны выглядеть одинаково.
const STYLES = `
:where([data-vibeui-block="buttongroup-050"]){
--vibeui-buttongroup-050-surface:oklch(1 0 0);
--vibeui-buttongroup-050-fg:oklch(0.25 0.016 265);
--vibeui-buttongroup-050-muted:oklch(0.58 0.014 265);
--vibeui-buttongroup-050-border:oklch(0.89 0.008 265);
--vibeui-buttongroup-050-accent:oklch(0.48 0.16 285);
--vibeui-buttongroup-050-radius:0.75rem;
--vibeui-buttongroup-050-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="buttongroup-050"]{
box-sizing:border-box;display:block;width:100%;max-width:30rem;
margin:0;padding:0;border:0;
font-family:var(--vibeui-buttongroup-050-font);
}
[data-vibeui-block="buttongroup-050"] *{box-sizing:border-box}
[data-vibeui-block="buttongroup-050"] legend{
padding:0;margin:0 0 0.5rem;float:left;width:100%;clear:both;
color:var(--vibeui-buttongroup-050-fg);
font-size:0.8125rem;font-weight:650;line-height:1.35;
}
[data-vibeui-block="buttongroup-050"] [data-part="track"]{
display:grid;grid-auto-flow:column;grid-auto-columns:1fr;isolation:isolate;clear:both;
}
[data-vibeui-block="buttongroup-050"] [data-part="step"]{
position:relative;z-index:0;
display:flex;flex-direction:column;align-items:center;justify-content:center;gap:0.1875rem;
min-height:3.5rem;padding:0.5rem 0.375rem;margin-inline-start:-1px;
border:1px solid var(--vibeui-buttongroup-050-border);
background:var(--vibeui-buttongroup-050-surface);
cursor:pointer;text-align:center;
transition:background-color .16s ease,border-color .16s ease;
}
[data-vibeui-block="buttongroup-050"] [data-part="step"]:first-child{
margin-inline-start:0;
border-start-start-radius:var(--vibeui-buttongroup-050-radius);
border-end-start-radius:var(--vibeui-buttongroup-050-radius);
}
[data-vibeui-block="buttongroup-050"] [data-part="step"]:last-child{
border-start-end-radius:var(--vibeui-buttongroup-050-radius);
border-end-end-radius:var(--vibeui-buttongroup-050-radius);
}
[data-vibeui-block="buttongroup-050"] input{
position:absolute;inset:0;width:100%;height:100%;margin:0;opacity:0;cursor:pointer;
}
[data-vibeui-block="buttongroup-050"] [data-part="name"]{
color:var(--vibeui-buttongroup-050-fg);
font-size:0.8125rem;font-weight:650;line-height:1.2;
}
[data-vibeui-block="buttongroup-050"] [data-part="scope"]{
color:var(--vibeui-buttongroup-050-muted);
font-size:0.6875rem;line-height:1.25;
}
/* Выбранная роль включает все, что правее: младшие права залиты слабее. */
[data-vibeui-block="buttongroup-050"] [data-part="step"]:has(input:checked) ~ [data-part="step"]{
background:oklch(0.975 0.015 285);
}
[data-vibeui-block="buttongroup-050"] [data-part="step"]:has(input:checked){
z-index:1;
background:oklch(0.95 0.04 285);
border-color:var(--vibeui-buttongroup-050-accent);
}
[data-vibeui-block="buttongroup-050"] [data-part="step"]:has(input:checked) [data-part="name"]{
color:var(--vibeui-buttongroup-050-accent);
}
[data-vibeui-block="buttongroup-050"] [data-part="step"]:has(input:focus-visible){
z-index:2;outline:2px solid var(--vibeui-buttongroup-050-accent);outline-offset:1px;
}
[data-vibeui-block="buttongroup-050"] [data-part="hint"]{
display:flex;align-items:flex-start;gap:0.375rem;
margin:0.5rem 0 0;
color:var(--vibeui-buttongroup-050-muted);
font-size:0.75rem;line-height:1.4;
}
[data-vibeui-block="buttongroup-050"] [data-part="hint"] svg{
width:0.9375rem;height:0.9375rem;flex:none;margin-top:0.0625rem;
stroke:currentColor;fill:none;stroke-width:1.9;stroke-linecap:round;
}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="buttongroup-050"] *{animation:none!important;transition:none!important}}
`
const DEFAULT_ROLES: Buttongroup050Role[] = [
{ id: "owner", label: "Владелец", scope: "биллинг и удаление" },
{ id: "admin", label: "Админ", scope: "настройки и люди" },
{ id: "editor", label: "Редактор", scope: "правка контента" },
{ id: "viewer", label: "Читатель", scope: "только просмотр" },
]
/**
* Роли лестницей: выбранная подсвечивает все младшие, права видно вложенными.
* Один файл, ноль зависимостей, серверный компонент.
*/
export function Buttongroup050({
roles = DEFAULT_ROLES,
defaultValue = "editor",
hint = "Роль включает все права, что правее неё.",
label = "Роль участника",
name = "buttongroup-050",
accent,
className,
style,
...props
}: Buttongroup050Props) {
const palette = {
...(accent ? { "--vibeui-buttongroup-050-accent": accent } : null),
...style,
} as CSSProperties
return (
<>
<style href="vibeui-buttongroup-050" precedence="medium">
{STYLES}
</style>
<fieldset
{...props}
data-vibeui-block="buttongroup-050"
className={className}
style={palette}
>
<legend>{label}</legend>
<div data-part="track">
{roles.map((role) => (
<label key={role.id} data-part="step">
<input
type="radio"
name={name}
value={role.id}
defaultChecked={role.id === defaultValue}
/>
<span data-part="name">{role.label}</span>
<span data-part="scope">{role.scope}</span>
</label>
))}
</div>
<p data-part="hint">
<svg viewBox="0 0 24 24" aria-hidden="true">
<path d="M12 8h.01M11 12h1v5h1M12 3a9 9 0 1 0 0 18 9 9 0 0 0 0-18" />
</svg>
<span>{hint}</span>
</p>
</fieldset>
</>
)
}