Toggle
Favorite Star
Кнопка избранного со счётчиком: звезда заливается, число рядом меняется в тот же миг, а сам счётчик вынесен из имени кнопки.
- toggle
- favorite
- counter
- aria-pressed
Превью
Использовать с AI
- 1. Скопируйте ссылку.
- 2. Напишите агенту своими словами и вставьте её в предложение.
- 3. Агент откроет ссылку и поставит компонент из registry.
размести это в шапке: https://vibeui.ru/c/toggle-003
Показать полную инструкцию
То, что лежит по ссылке в развёрнутом виде. Нужна, если агент не может открыть ссылку — тогда вставьте этот текст целиком.
# Установка и размещение «toggle-003» (Favorite Star) из VibeUI
## 1. Сначала установка — не пропускай, не пересоздавай
Выполни эту команду до того, как писать код:
npx shadcn@latest add https://vibeui.ru/r/toggle-003.json
Registry item: https://vibeui.ru/r/toggle-003.json
Ставится в: components/vibeui/toggle-003.tsx (точный путь следует алиасам components.json этого проекта).
npm-зависимости: нет.
Registry-зависимости: нет.
Ставь из реестра. Не пересоздавай по описанию, не подменяй похожим
компонентом из другой библиотеки и не переписывай под стиль проекта.
## 2. Что это
Кнопка избранного со счётчиком: звезда заливается, число рядом меняется в тот же миг, а сам счётчик вынесен из имени кнопки.
Строка объекта с кнопкой избранного: звезда заливается, счётчик обновляется рядом и не попадает в имя кнопки. Один файл, ноль зависимостей, клиентский компонент.
## 3. Как использовать
import { Toggle003 } from "@/components/vibeui/toggle-003"
<Toggle003
title="Годовой отчёт по продажам"
count={128}
label="В избранное"
/>
Полный список пропсов — в установленном файле.
## 4. Куда поставить
Это мелкий inline-компонент. Поставь его ровно туда, куда просил
пользователь, внутрь существующей разметки. Не создавай ради него
новую страницу, секцию или обёртку. Если на этом месте уже стоит похожий
контрол — замени его, а не добавляй второй.
Куда поставить: ___
(Эту строку заполняет пользователь. Если она осталась пустой — спроси,
а не угадывай.)
## 5. Сохранить как установлено
- локальную палитру --vibeui-toggle-003-* и не подменять её токенами вашей темы
- счётчик вне кнопки: внутри он становится частью имени и мешает его слушать
- заливку звезды вдобавок к цвету — одним оттенком состояние показывать нельзя
- aria-label кнопки: значок без подписи не имеет имени вовсе
- правило prefers-reduced-motion: всплеск звезды обязан отключаться
- собственную светлую подложку строки: тёмный текст обязан нести свой фон
## 6. Можно менять
- заголовок объекта через title
- базовое число через count
- имя кнопки через label
- цвет отметки через accent
## 7. Правила
- Счётчик считается от count и текущего состояния — на сервере храните исходное число, а не показанное.
- role="status" озвучивает изменение числа: в списке из сотни строк это может быть шумно.
- Не заменяйте кнопку чекбоксом: избранное — действие над объектом, а не поле формы.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.
## 8. Проверка
- рендерится без ошибок в консоли;
- выглядит так же, как превью на странице VibeUI, откуда взята ссылка;
- если нет — ты изменил что-то из раздела 5, верни как было.Для разработчика
npx shadcn@latest add https://vibeui.ru/r/toggle-003.jsonhttps://vibeui.ru/r/toggle-003.jsonОдин файл, ноль зависимостей, палитра --vibeui-toggle-003-*. Клиентский: useState. Счётчик лежит вне кнопки в span с role="status": внутри он приклеился бы к имени и скринридер читал бы «В избранное 128, нажато». Отметка показана двумя признаками — заливкой звезды через fill:currentColor и цветом рамки, — а короткая анимация появления привязана к [aria-pressed="true"] и отключается по prefers-reduced-motion. Это toggle, а не checkbox: избранное меняется сразу и относится к объекту, а не к полю формы.
Исходник компонента
Тот же файл, который поставит агент. Нужен, если вы предпочитаете скопировать код руками.
"use client"
import { useState } from "react"
import type { ComponentPropsWithoutRef, CSSProperties } from "react"
export type Toggle003Props = Omit<
ComponentPropsWithoutRef<"article">,
"children" | "onChange" | "title"
> & {
title?: string
count?: number
label?: string
defaultPressed?: boolean
onChange?: (pressed: boolean) => void
accent?: string
}
// Идея компонента: кнопка избранного, у которой нажатие сразу меняет и
// значок, и счётчик рядом. Счётчик вынесен из кнопки: внутри он приклеился бы
// к её имени, и скринридер прочитал бы «В избранное 128, нажато».
const STYLES = `
:where([data-vibeui-block="toggle-003"]){
--vibeui-toggle-003-bg:oklch(1 0 0);
--vibeui-toggle-003-fg:oklch(0.22 0.014 265);
--vibeui-toggle-003-muted:oklch(0.55 0.014 265);
--vibeui-toggle-003-border:oklch(0.9 0.006 265);
--vibeui-toggle-003-accent:oklch(0.72 0.16 75);
--vibeui-toggle-003-hover:oklch(0.97 0.004 265);
--vibeui-toggle-003-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="toggle-003"]{
box-sizing:border-box;display:flex;align-items:center;gap:0.75rem;
width:100%;max-width:22rem;padding:0.75rem 0.875rem;
border:1px solid var(--vibeui-toggle-003-border);border-radius:0.875rem;
background:var(--vibeui-toggle-003-bg);color:var(--vibeui-toggle-003-fg);
font-family:var(--vibeui-toggle-003-font);
}
[data-vibeui-block="toggle-003"] *{box-sizing:border-box}
[data-vibeui-block="toggle-003"] [data-part="text"]{min-width:0;flex:1}
[data-vibeui-block="toggle-003"] h3{
margin:0;font-size:0.875rem;font-weight:650;line-height:1.3;
overflow:hidden;text-overflow:ellipsis;white-space:nowrap;
}
[data-vibeui-block="toggle-003"] [data-part="count"]{
display:block;margin-top:0.125rem;font-size:0.75rem;color:var(--vibeui-toggle-003-muted);
font-variant-numeric:tabular-nums;
}
[data-vibeui-block="toggle-003"] button{
appearance:none;cursor:pointer;font:inherit;flex:none;
display:inline-flex;align-items:center;justify-content:center;
width:2.25rem;height:2.25rem;padding:0;
border:1px solid var(--vibeui-toggle-003-border);border-radius:9999px;
background:var(--vibeui-toggle-003-bg);color:var(--vibeui-toggle-003-muted);
transition:background-color .16s ease,color .16s ease,border-color .16s ease;
}
[data-vibeui-block="toggle-003"] button:hover{background:var(--vibeui-toggle-003-hover)}
[data-vibeui-block="toggle-003"] button:focus-visible{
outline:2px solid var(--vibeui-toggle-003-accent);outline-offset:2px;
}
[data-vibeui-block="toggle-003"] svg{width:1.125rem;height:1.125rem}
[data-vibeui-block="toggle-003"] svg path{
fill:none;stroke:currentColor;stroke-width:1.5;stroke-linejoin:round;
}
/* Отмеченная звезда не только красится, но и заливается: цвет один — плохой
признак для тех, кто его не различает. */
[data-vibeui-block="toggle-003"] button[aria-pressed="true"]{
color:var(--vibeui-toggle-003-accent);border-color:var(--vibeui-toggle-003-accent);
}
[data-vibeui-block="toggle-003"] button[aria-pressed="true"] svg{animation:vibeui-toggle-003-pop .22s ease}
[data-vibeui-block="toggle-003"] button[aria-pressed="true"] svg path{fill:currentColor}
@keyframes vibeui-toggle-003-pop{
0%{transform:scale(.75)}
60%{transform:scale(1.18)}
100%{transform:scale(1)}
}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="toggle-003"] *{animation:none!important;transition:none!important}}
`
/**
* Кнопка избранного со счётчиком: звезда заливается, число рядом меняется
* сразу. Один файл, ноль зависимостей, собственная палитра.
*/
export function Toggle003({
title = "Годовой отчёт по продажам",
count = 128,
label = "В избранное",
defaultPressed = false,
onChange,
accent,
className,
style,
...props
}: Toggle003Props) {
const [pressed, setPressed] = useState(defaultPressed)
const palette = {
...(accent ? { "--vibeui-toggle-003-accent": accent } : null),
...style,
} as CSSProperties
const total = pressed ? count + 1 : count
return (
<>
<style href="vibeui-toggle-003" precedence="medium">
{STYLES}
</style>
<article
{...props}
data-vibeui-block="toggle-003"
className={className}
style={palette}
>
<div data-part="text">
<h3>{title}</h3>
<span data-part="count" role="status">
{total} в избранном
</span>
</div>
<button
type="button"
aria-pressed={pressed}
aria-label={label}
title={label}
onClick={() => {
setPressed(!pressed)
onChange?.(!pressed)
}}
>
<svg viewBox="0 0 20 20" aria-hidden="true">
<path d="M10 2.4l2.28 4.7 5.12.72-3.7 3.63.87 5.13L10 14.16l-4.57 2.42.87-5.13-3.7-3.63 5.12-.72z" />
</svg>
</button>
</article>
</>
)
}