Buttons
Add To Cart Button
Кнопка «в корзину», у которой после добавления меняется не только вид, но и смысл клика: теперь она ведёт в корзину.
- button
- cart
- commerce
- stateful
Превью
Использовать с AI
- 1. Скопируйте ссылку.
- 2. Напишите агенту своими словами и вставьте её в предложение.
- 3. Агент откроет ссылку и поставит компонент из registry.
размести это в шапке: https://vibeui.ru/c/button-049
Показать полную инструкцию
То, что лежит по ссылке в развёрнутом виде. Нужна, если агент не может открыть ссылку — тогда вставьте этот текст целиком.
# Установка и размещение «button-049» (Add To Cart Button) из VibeUI
## 1. Сначала установка — не пропускай, не пересоздавай
Выполни эту команду до того, как писать код:
npx shadcn@latest add https://vibeui.ru/r/button-049.json
Registry item: https://vibeui.ru/r/button-049.json
Ставится в: components/vibeui/button-049.tsx (точный путь следует алиасам components.json этого проекта).
npm-зависимости: нет.
Registry-зависимости: нет.
Ставь из реестра. Не пересоздавай по описанию, не подменяй похожим
компонентом из другой библиотеки и не переписывай под стиль проекта.
## 2. Что это
Кнопка «в корзину», у которой после добавления меняется не только вид, но и смысл клика: теперь она ведёт в корзину.
Кнопка товара с двумя состояниями. До добавления — акцентная «В корзину» со значком сумки; после — зелёная «В корзине — открыть» с галочкой, и клик уже ведёт в корзину, а не добавляет второй раз. Изменение уходит в aria-live, поэтому его слышно и без экрана. Ноль зависимостей, один файл.
## 3. Как использовать
import { Button049 } from "@/components/vibeui/button-049"
<Button049 onAdd={addToCart} onOpenCart={openCart}>
В корзину
</Button049>
Полный список пропсов — в установленном файле.
## 4. Куда поставить
Это мелкий inline-компонент. Поставь его ровно туда, куда просил
пользователь, внутрь существующей разметки. Не создавай ради него
новую страницу, секцию или обёртку. Если на этом месте уже стоит похожий
контрол — замени его, а не добавляй второй.
Куда поставить: ___
(Эту строку заполняет пользователь. Если она осталась пустой — спроси,
а не угадывай.)
## 5. Сохранить как установлено
- смену смысла клика вместе с состоянием: повторное добавление одного товара — почти всегда ошибка пользователя
- скрытую строку aria-live: без неё факт добавления доходит только глазами
- фиксированную минимальную ширину — иначе кнопка прыгает при смене подписи
- смену значка сумки на галочку вместе с цветом: цвет один не различают все пользователи
- два разных обработчика onAdd и onOpenCart — приложению нужно знать, какое из действий произошло
- зелёную палитру состояния «в корзине», отличную от акцента покоя
## 6. Можно менять
- подписи children и addedLabel
- обработчики onAdd и onOpenCart
- начальное состояние — проп defaultAdded
- акцентный цвет — проп accent
- внешние отступы через className
## 7. Правила
- Компонент не знает про корзину: он только переключает состояние и зовёт обработчики. Синхронизация с реальной корзиной — задача приложения.
- Не оставляй состояние «в корзине», если запрос на сервер провалился: сбрасывай его через defaultAdded или пересоздание.
- Не превращай кнопку в счётчик количества — для этого нужен отдельный степпер.
- Не выноси CSS-переменные в globals.css: компонент должен оставаться одним файлом.
## 8. Проверка
- рендерится без ошибок в консоли;
- выглядит так же, как превью на странице VibeUI, откуда взята ссылка;
- если нет — ты изменил что-то из раздела 5, верни как было.Для разработчика
npx shadcn@latest add https://vibeui.ru/r/button-049.jsonhttps://vibeui.ru/r/button-049.jsonКомпонент самодостаточен: один файл, без зависимостей, собственная палитра в локальных переменных --vibeui-button-049-*. Клиентский компонент: состояние «в корзине» внутреннее, наружу уходят два разных обработчика — onAdd и onOpenCart, компонент сам решает, какой вызвать. Минимальная ширина зафиксирована, поэтому при смене подписи кнопка не прыгает. Смена состояния объявляется скрытой строкой role="status" с aria-live="polite".
Исходник компонента
Тот же файл, который поставит агент. Нужен, если вы предпочитаете скопировать код руками.
"use client"
import { useState } from "react"
import type { ComponentPropsWithoutRef, CSSProperties } from "react"
export type Button049Props = Omit<
ComponentPropsWithoutRef<"button">,
"children" | "onClick"
> & {
children?: string
/** Подпись после добавления: она же приглашение перейти в корзину. */
addedLabel?: string
defaultAdded?: boolean
onAdd?: () => void
onOpenCart?: () => void
accent?: string
}
// Идея компонента: одна кнопка на два разных действия. Пока товара нет
// в корзине — «В корзину»; после добавления она меняет и цвет, и смысл:
// теперь ведёт в корзину. Смена состояния объявляется в aria-live, иначе
// человек со скринридером не узнает, что добавление прошло.
const STYLES = `
:where([data-vibeui-block="button-049"]){
--vibeui-button-049-accent:oklch(0.53 0.16 275);
--vibeui-button-049-done:oklch(0.5 0.13 155);
--vibeui-button-049-fg:oklch(0.99 0.01 275);
--vibeui-button-049-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="button-049"]{
position:relative;appearance:none;border:0;cursor:pointer;box-sizing:border-box;
display:inline-flex;align-items:center;justify-content:center;gap:0.5rem;
min-width:11.5rem;height:2.75rem;padding:0 1.125rem;border-radius:0.75rem;
background:var(--vibeui-button-049-accent);color:var(--vibeui-button-049-fg);
font-family:var(--vibeui-button-049-font);font-size:0.875rem;font-weight:650;line-height:1;
transition:background-color .2s ease,filter .16s ease;
}
[data-vibeui-block="button-049"][data-added="true"]{background:var(--vibeui-button-049-done)}
[data-vibeui-block="button-049"]:hover:not(:disabled){filter:brightness(1.07)}
[data-vibeui-block="button-049"]:focus-visible{outline:2px solid var(--vibeui-button-049-accent);outline-offset:3px}
[data-vibeui-block="button-049"][data-added="true"]:focus-visible{outline-color:var(--vibeui-button-049-done)}
[data-vibeui-block="button-049"]:disabled{cursor:not-allowed;opacity:.55}
/* Корзина: короб с ручкой, обе части — грани псевдоэлементов. */
[data-vibeui-block="button-049"] [data-part="bag"]{position:relative;flex:none;width:1rem;height:1.0625rem}
[data-vibeui-block="button-049"] [data-part="bag"]::before{
content:"";position:absolute;left:0;bottom:0;width:1rem;height:0.75rem;
box-sizing:border-box;border:1.75px solid currentColor;border-radius:0.1875rem;
}
[data-vibeui-block="button-049"] [data-part="bag"]::after{
content:"";position:absolute;left:0.25rem;top:0;width:0.5rem;height:0.4375rem;
box-sizing:border-box;border:1.75px solid currentColor;border-bottom:0;
border-radius:0.25rem 0.25rem 0 0;
}
[data-vibeui-block="button-049"] [data-part="check"]{position:relative;flex:none;width:1rem;height:1.0625rem}
[data-vibeui-block="button-049"] [data-part="check"]::after{
content:"";position:absolute;left:0.1875rem;top:50%;width:0.375rem;height:0.6875rem;
margin-top:-0.4375rem;box-sizing:border-box;
border:2px solid currentColor;border-top:0;border-left:0;transform:rotate(42deg);
}
[data-vibeui-block="button-049"] [data-part="live"]{
position:absolute;width:1px;height:1px;overflow:hidden;clip-path:inset(50%);white-space:nowrap;
}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="button-049"]{transition:none!important}}
`
/**
* Кнопка «в корзину» с состоянием «в корзине», которое меняет и смысл клика.
* Один файл, ноль зависимостей, собственная палитра.
*/
export function Button049({
children = "В корзину",
addedLabel = "В корзине — открыть",
defaultAdded = false,
onAdd,
onOpenCart,
accent,
type = "button",
className,
style,
...props
}: Button049Props) {
const [added, setAdded] = useState(defaultAdded)
const palette = {
...(accent ? { "--vibeui-button-049-accent": accent } : null),
...style,
} as CSSProperties
return (
<>
<style href="vibeui-button-049" precedence="medium">
{STYLES}
</style>
<button
{...props}
type={type}
data-vibeui-block="button-049"
data-added={String(added)}
className={className}
style={palette}
onClick={() => {
if (added) {
onOpenCart?.()
return
}
setAdded(true)
onAdd?.()
}}
>
<span
data-part={added ? "check" : "bag"}
aria-hidden="true"
key={added ? "check" : "bag"}
/>
{added ? addedLabel : children}
<span data-part="live" role="status" aria-live="polite">
{added ? "Товар добавлен в корзину" : ""}
</span>
</button>
</>
)
}