Badge
Filter Chips
Плашки-фильтры кнопками: состояние в aria-pressed, а у выбранной ещё и галочка — не только цвет.
- badge
- filter
- toggle
- a11y
Превью
Использовать с AI
- 1. Скопируйте ссылку.
- 2. Напишите агенту своими словами и вставьте её в предложение.
- 3. Агент откроет ссылку и поставит компонент из registry.
размести это в шапке: https://vibeui.ru/c/badge-011
Показать полную инструкцию
То, что лежит по ссылке в развёрнутом виде. Нужна, если агент не может открыть ссылку — тогда вставьте этот текст целиком.
# Установка и размещение «badge-011» (Filter Chips) из VibeUI
## 1. Сначала установка — не пропускай, не пересоздавай
Выполни эту команду до того, как писать код:
npx shadcn@latest add https://vibeui.ru/r/badge-011.json
Registry item: https://vibeui.ru/r/badge-011.json
Ставится в: components/vibeui/badge-011.tsx (точный путь следует алиасам components.json этого проекта).
npm-зависимости: нет.
Registry-зависимости: нет.
Ставь из реестра. Не пересоздавай по описанию, не подменяй похожим
компонентом из другой библиотеки и не переписывай под стиль проекта.
## 2. Что это
Плашки-фильтры кнопками: состояние в aria-pressed, а у выбранной ещё и галочка — не только цвет.
Ряд переключаемых плашек-фильтров: кнопки с aria-pressed, галочка у выбранной и цвета из одного акцента. Ноль зависимостей, один файл, своя палитра.
## 3. Как использовать
import { Badge011 } from "@/components/vibeui/badge-011"
<Badge011
options={["Все", "Открытые", "Мои"]}
defaultValue={["Открытые"]}
onChange={(value) => setFilters(value)}
/>
Полный список пропсов — в установленном файле.
## 4. Куда поставить
Это мелкий inline-компонент. Поставь его ровно туда, куда просил
пользователь, внутрь существующей разметки. Не создавай ради него
новую страницу, секцию или обёртку. Если на этом месте уже стоит похожий
контрол — замени его, а не добавляй второй.
Куда поставить: ___
(Эту строку заполняет пользователь. Если она осталась пустой — спроси,
а не угадывай.)
## 5. Сохранить как установлено
- локальную палитру --vibeui-badge-011-* и не подменять её токенами вашей темы
- кнопки с aria-pressed вместо ссылок: фильтр меняет выборку, а не адрес
- стилизацию выбранного через селектор [aria-pressed="true"] — состояние и вид не разъезжаются
- галочку у выбранной плашки: один цвет не различают при дальтонизме
- высоту 1.75rem: в фильтр надо попадать пальцем
- перенос ряда на вторую строку — фильтров бывает много
## 6. Можно менять
- массив options и стартовый defaultValue
- обработчик onChange
- акцент через проп accent
- форму: скруглённый прямоугольник вместо пилюли
## 7. Правила
- Компонент держит выбор у себя: связывать его с запросом и адресом должен вызывающий код.
- Взаимоисключающие варианты — это не фильтр, а переключатель: для них нужны radio, а не aria-pressed.
- Значение «Все» логично сбрасывает остальные: это правило добавляется в onChange вызывающего кода.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.
## 8. Проверка
- рендерится без ошибок в консоли;
- выглядит так же, как превью на странице VibeUI, откуда взята ссылка;
- если нет — ты изменил что-то из раздела 5, верни как было.Для разработчика
npx shadcn@latest add https://vibeui.ru/r/badge-011.jsonhttps://vibeui.ru/r/badge-011.jsonКомпонент самодостаточен: один файл, без зависимостей, собственная палитра в локальных переменных --vibeui-badge-011-*. Клиентский: "use client". Каждая плашка — <button> с aria-pressed, а не ссылка: адрес не меняется, состояние переключается на месте. Выбранное состояние стилизуется селектором по aria-pressed, поэтому разметка и доступность не расходятся. Цвета выбранной плашки считаются из акцента через color-mix.
Исходник компонента
Тот же файл, который поставит агент. Нужен, если вы предпочитаете скопировать код руками.
"use client"
import { useState } from "react"
import type { ComponentPropsWithoutRef, CSSProperties } from "react"
export type Badge011Props = Omit<
ComponentPropsWithoutRef<"div">,
"children" | "onChange"
> & {
options?: string[]
defaultValue?: string[]
onChange?: (value: string[]) => void
accent?: string
}
// Идея компонента: плашки-фильтры, которые можно нажимать. Они объявлены
// кнопками с aria-pressed, а не ссылками: состояние переключается на месте и
// адрес страницы не меняется. Выбранная плашка отличается не только цветом —
// у неё галочка, иначе выбор не виден при дальтонизме.
const STYLES = `
:where([data-vibeui-block="badge-011"]){
--vibeui-badge-011-bg:oklch(0.97 0.003 265);
--vibeui-badge-011-fg:oklch(0.32 0.014 265);
--vibeui-badge-011-border:oklch(0.89 0.006 265);
--vibeui-badge-011-accent:oklch(0.55 0.17 265);
--vibeui-badge-011-on-bg:color-mix(in oklab,var(--vibeui-badge-011-accent) 14%,oklch(1 0 0));
--vibeui-badge-011-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="badge-011"]{
display:flex;flex-wrap:wrap;gap:0.375rem;
font-family:var(--vibeui-badge-011-font);
}
[data-vibeui-block="badge-011"] button{
appearance:none;cursor:pointer;
display:inline-flex;align-items:center;gap:0.375rem;
height:1.75rem;padding:0 0.6875rem;
border:1px solid var(--vibeui-badge-011-border);border-radius:9999px;
background:var(--vibeui-badge-011-bg);color:var(--vibeui-badge-011-fg);
font:inherit;font-size:0.75rem;font-weight:500;line-height:1;
}
[data-vibeui-block="badge-011"] button:hover{border-color:oklch(0.82 0.008 265)}
[data-vibeui-block="badge-011"] button:focus-visible{outline:2px solid var(--vibeui-badge-011-accent);outline-offset:1px}
/* Выбранная плашка отличается галочкой, а не только цветом. */
[data-vibeui-block="badge-011"] button[aria-pressed="true"]{
background:var(--vibeui-badge-011-on-bg);
border-color:color-mix(in oklab,var(--vibeui-badge-011-accent) 45%,oklch(1 0 0));
color:color-mix(in oklab,var(--vibeui-badge-011-accent) 75%,oklch(0.2 0.02 265));
font-weight:600;
}
[data-vibeui-block="badge-011"] [data-part="tick"]{
width:0.3125rem;height:0.5rem;margin-top:-0.125rem;flex:none;
border-right:1.5px solid currentColor;border-bottom:1.5px solid currentColor;
transform:rotate(45deg);
}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="badge-011"] *{animation:none!important;transition:none!important}}
`
const DEFAULT_OPTIONS = ["Все", "Открытые", "Мои", "Срочные", "В архиве"]
/**
* Плашки-фильтры: кнопки с aria-pressed и галочкой у выбранной.
* Один файл, ноль зависимостей, собственная палитра.
*/
export function Badge011({
options = DEFAULT_OPTIONS,
defaultValue = ["Открытые"],
onChange,
accent,
className,
style,
...props
}: Badge011Props) {
const [value, setValue] = useState<string[]>(defaultValue)
const palette = {
...(accent ? { "--vibeui-badge-011-accent": accent } : null),
...style,
} as CSSProperties
const toggle = (option: string) => {
const next = value.includes(option)
? value.filter((item) => item !== option)
: [...value, option]
setValue(next)
onChange?.(next)
}
return (
<>
<style href="vibeui-badge-011" precedence="medium">
{STYLES}
</style>
<div
{...props}
data-vibeui-block="badge-011"
className={className}
style={palette}
>
{options.map((option) => {
const on = value.includes(option)
return (
<button
key={option}
type="button"
aria-pressed={on}
onClick={() => toggle(option)}
>
{on ? <span data-part="tick" aria-hidden="true" /> : null}
{option}
</button>
)
})}
</div>
</>
)
}