Toggle Group
Format Toolbar
Панель форматирования из двух групп-тумблеров с настоящими разделителями: слева множественный выбор начертаний, справа одиночный выбор выравнивания.
- togglegroup
- toolbar
- separator
- roving-tabindex
Превью
Использовать с AI
- 1. Скопируйте ссылку.
- 2. Напишите агенту своими словами и вставьте её в предложение.
- 3. Агент откроет ссылку и поставит компонент из registry.
размести это в шапке: https://vibeui.ru/c/togglegroup-007
Показать полную инструкцию
То, что лежит по ссылке в развёрнутом виде. Нужна, если агент не может открыть ссылку — тогда вставьте этот текст целиком.
# Установка и размещение «togglegroup-007» (Format Toolbar) из VibeUI
## 1. Сначала установка — не пропускай, не пересоздавай
Выполни эту команду до того, как писать код:
npx shadcn@latest add https://vibeui.ru/r/togglegroup-007.json
Registry item: https://vibeui.ru/r/togglegroup-007.json
Ставится в: components/vibeui/togglegroup-007.tsx (точный путь следует алиасам components.json этого проекта).
npm-зависимости: нет.
Registry-зависимости: нет.
Ставь из реестра. Не пересоздавай по описанию, не подменяй похожим
компонентом из другой библиотеки и не переписывай под стиль проекта.
## 2. Что это
Панель форматирования из двух групп-тумблеров с настоящими разделителями: слева множественный выбор начертаний, справа одиночный выбор выравнивания.
Панель форматирования с разделителями: множественный и одиночный выбор в одной панели, фокус ходит стрелками. Один файл, ноль зависимостей.
## 3. Как использовать
import { Togglegroup007 } from "@/components/vibeui/togglegroup-007"
<Togglegroup007
label="Форматирование"
defaultAlign="left"
defaultMarks={["bold"]}
/>
Полный список пропсов — в установленном файле.
## 4. Куда поставить
Это мелкий inline-компонент. Поставь его ровно туда, куда просил
пользователь, внутрь существующей разметки. Не создавай ради него
новую страницу, секцию или обёртку. Если на этом месте уже стоит похожий
контрол — замени его, а не добавляй второй.
Куда поставить: ___
(Эту строку заполняет пользователь. Если она осталась пустой — спроси,
а не угадывай.)
## 5. Сохранить как установлено
- локальную палитру --vibeui-togglegroup-007-* и не подменять её токенами вашей темы
- role="toolbar" с roving tabindex: восемь остановок в табе — это восемь лишних нажатий
- role="separator" у разделителей, а не просто нарисованную полоску
- имена у каждой группы: без них непонятно, где выбор складывается, а где исключает
- aria-pressed на каждой кнопке — это состояния, а не действия панели
- видимую обводку фокуса: панель значков без неё непроходима с клавиатуры
## 6. Можно менять
- имя панели через label
- начальное выравнивание через defaultAlign
- начальный набор начертаний через defaultMarks
- цвет нажатых кнопок через accent
## 7. Правила
- Панель узкая по смыслу: список инструментов зашит в файл, растить его бесконечно нельзя.
- onChange отдаёт объект { align, marks } — одиночный и множественный выбор вместе.
- Toolbar не заворачивает фокус на другую строку: при переносе панели пересмотрите навигацию.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.
## 8. Проверка
- рендерится без ошибок в консоли;
- выглядит так же, как превью на странице VibeUI, откуда взята ссылка;
- если нет — ты изменил что-то из раздела 5, верни как было.Для разработчика
npx shadcn@latest add https://vibeui.ru/r/togglegroup-007.jsonhttps://vibeui.ru/r/togglegroup-007.jsonОдин файл, ноль зависимостей, палитра --vibeui-togglegroup-007-*. Клиентский: useState на выравнивание, на набор начертаний и на активный индекс, useRef на список кнопок. Корень — role="toolbar" с aria-orientation, внутри три role="group" со своими именами, между ними role="separator": панель из восьми значков подряд неразличима на слух, а разделитель режет её на смысловые куски. Фокус ходит по всей панели roving tabindex'ом — стрелки, Home и End, — а поведение внутри групп разное: слева состояния складываются, справа взаимно исключаются.
Исходник компонента
Тот же файл, который поставит агент. Нужен, если вы предпочитаете скопировать код руками.
"use client"
import { Fragment, useRef, useState } from "react"
import type {
ComponentPropsWithoutRef,
CSSProperties,
KeyboardEvent,
} from "react"
export type Togglegroup007Props = Omit<
ComponentPropsWithoutRef<"div">,
"children" | "onChange"
> & {
label?: string
defaultAlign?: string
defaultMarks?: string[]
onChange?: (value: { align: string; marks: string[] }) => void
accent?: string
}
// Идея компонента: панель форматирования из двух групп-тумблеров, разделённых
// настоящими separator'ами. Слева множественный выбор начертаний, справа
// одиночный выбор выравнивания — разное поведение внутри одной панели, поэтому
// каждая группа несёт своё имя, а фокус ходит по всей панели стрелками.
const STYLES = `
:where([data-vibeui-block="togglegroup-007"]){
--vibeui-togglegroup-007-bg:oklch(1 0 0);
--vibeui-togglegroup-007-fg:oklch(0.22 0.014 265);
--vibeui-togglegroup-007-muted:oklch(0.55 0.014 265);
--vibeui-togglegroup-007-border:oklch(0.9 0.006 265);
--vibeui-togglegroup-007-surface:oklch(0.975 0.004 265);
--vibeui-togglegroup-007-accent:oklch(0.54 0.17 255);
--vibeui-togglegroup-007-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="togglegroup-007"]{
box-sizing:border-box;display:inline-flex;align-items:center;gap:0.375rem;
max-width:100%;padding:0.3125rem;
border:1px solid var(--vibeui-togglegroup-007-border);border-radius:0.75rem;
background:var(--vibeui-togglegroup-007-bg);color:var(--vibeui-togglegroup-007-fg);
font-family:var(--vibeui-togglegroup-007-font);
box-shadow:0 1px 2px oklch(0.2 0.02 265 / 8%);
}
[data-vibeui-block="togglegroup-007"] *{box-sizing:border-box}
[data-vibeui-block="togglegroup-007"] [data-part="set"]{display:inline-flex;gap:0.125rem}
[data-vibeui-block="togglegroup-007"] button{
appearance:none;cursor:pointer;font:inherit;
display:inline-flex;align-items:center;justify-content:center;
width:2rem;height:2rem;padding:0;border:0;border-radius:0.5rem;
background:transparent;color:var(--vibeui-togglegroup-007-muted);
transition:background-color .15s ease,color .15s ease;
}
[data-vibeui-block="togglegroup-007"] button svg{width:1rem;height:1rem}
[data-vibeui-block="togglegroup-007"] button:hover{background:var(--vibeui-togglegroup-007-surface);color:var(--vibeui-togglegroup-007-fg)}
[data-vibeui-block="togglegroup-007"] button:focus-visible{
outline:2px solid var(--vibeui-togglegroup-007-accent);outline-offset:1px;
}
[data-vibeui-block="togglegroup-007"] button[aria-pressed="true"]{
background:color-mix(in oklab,var(--vibeui-togglegroup-007-accent) 12%,white);
color:var(--vibeui-togglegroup-007-accent);
}
/* Разделитель объявлен ролью, а не просто нарисован: панель из девяти
значков подряд неразличима на слух, а separator режет её на группы. */
[data-vibeui-block="togglegroup-007"] [data-part="sep"]{
flex:none;width:1px;height:1.25rem;margin:0 0.1875rem;
background:var(--vibeui-togglegroup-007-border);
}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="togglegroup-007"] *{animation:none!important;transition:none!important}}
`
type Section = {
id: string
label: string
mode: "multi" | "single"
items: { id: string; label: string; d: string }[]
}
const SECTIONS: Section[] = [
{
id: "marks",
label: "Начертание",
mode: "multi",
items: [
{
id: "bold",
label: "Полужирный",
d: "M5.4 3h4a2.6 2.6 0 0 1 0 5.2h-4zm0 5.2h4.6a2.8 2.8 0 0 1 0 5.6H5.4z",
},
{
id: "italic",
label: "Курсив",
d: "M11.4 3.2H7.6M8.8 12.8H5M9.8 3.2 7 12.8",
},
{
id: "strike",
label: "Зачёркнутый",
d: "M3.2 8h9.6M11 4.6C10.4 3.6 9.3 3 8 3 6.3 3 5 3.9 5 5.3 5 6.4 5.8 7 7 7.5M5 11.4c.6 1 1.7 1.6 3 1.6 1.7 0 3-.9 3-2.3",
},
],
},
{
id: "align",
label: "Выравнивание",
mode: "single",
items: [
{ id: "left", label: "По левому краю", d: "M2.5 4h11M2.5 8h7M2.5 12h11" },
{ id: "center", label: "По центру", d: "M2.5 4h11M4.5 8h7M2.5 12h11" },
{
id: "right",
label: "По правому краю",
d: "M2.5 4h11M6.5 8h7M2.5 12h11",
},
],
},
{
id: "blocks",
label: "Блоки",
mode: "multi",
items: [
{
id: "list",
label: "Маркированный список",
d: "M6 4h7.5M6 8h7.5M6 12h7.5M3 4h.01M3 8h.01M3 12h.01",
},
{
id: "quote",
label: "Цитата",
d: "M3.5 12V8.5C3.5 5.8 4.9 4.3 7 4M9 12V8.5C9 5.8 10.4 4.3 12.5 4",
},
],
},
]
const FLAT = SECTIONS.flatMap((section) =>
section.items.map((item) => ({ section, item })),
)
/**
* Панель форматирования с разделителями: множественный и одиночный выбор
* в одной панели, фокус ходит стрелками. Один файл, ноль зависимостей.
*/
export function Togglegroup007({
label = "Форматирование",
defaultAlign = "left",
defaultMarks = ["bold"],
onChange,
accent,
className,
style,
...props
}: Togglegroup007Props) {
const [align, setAlign] = useState(defaultAlign)
const [marks, setMarks] = useState<string[]>(defaultMarks)
const [active, setActive] = useState(0)
const buttons = useRef<(HTMLButtonElement | null)[]>([])
const palette = {
...(accent ? { "--vibeui-togglegroup-007-accent": accent } : null),
...style,
} as CSSProperties
const focusAt = (index: number) => {
const last = FLAT.length - 1
const target = index < 0 ? last : index > last ? 0 : index
setActive(target)
buttons.current[target]?.focus()
}
const onKeyDown = (
event: KeyboardEvent<HTMLButtonElement>,
index: number,
) => {
if (event.key === "ArrowRight") {
event.preventDefault()
focusAt(index + 1)
} else if (event.key === "ArrowLeft") {
event.preventDefault()
focusAt(index - 1)
} else if (event.key === "Home") {
event.preventDefault()
focusAt(0)
} else if (event.key === "End") {
event.preventDefault()
focusAt(FLAT.length - 1)
}
}
const press = (section: Section, id: string) => {
if (section.mode === "single") {
setAlign(id)
onChange?.({ align: id, marks })
return
}
const next = marks.includes(id)
? marks.filter((mark) => mark !== id)
: [...marks, id]
setMarks(next)
onChange?.({ align, marks: next })
}
return (
<>
<style href="vibeui-togglegroup-007" precedence="medium">
{STYLES}
</style>
<div
{...props}
data-vibeui-block="togglegroup-007"
role="toolbar"
aria-label={label}
aria-orientation="horizontal"
className={className}
style={palette}
>
{SECTIONS.map((section, sectionIndex) => (
<Fragment key={section.id}>
{sectionIndex > 0 ? (
<span
data-part="sep"
role="separator"
aria-orientation="vertical"
/>
) : null}
<span data-part="set" role="group" aria-label={section.label}>
{section.items.map((item) => {
const index = FLAT.findIndex(
(entry) => entry.item.id === item.id,
)
const pressed =
section.mode === "single"
? align === item.id
: marks.includes(item.id)
return (
<button
key={item.id}
ref={(node) => {
buttons.current[index] = node
}}
type="button"
aria-pressed={pressed}
aria-label={item.label}
title={item.label}
tabIndex={index === active ? 0 : -1}
onKeyDown={(event) => onKeyDown(event, index)}
onFocus={() => setActive(index)}
onClick={() => press(section, item.id)}
>
<svg viewBox="0 0 16 16" fill="none" aria-hidden="true">
<path
d={item.d}
fill={item.id === "bold" ? "currentColor" : "none"}
stroke="currentColor"
strokeWidth={item.id === "bold" ? 0 : 1.4}
strokeLinecap="round"
strokeLinejoin="round"
/>
</svg>
</button>
)
})}
</span>
</Fragment>
))}
</div>
</>
)
}