Feedback
Progress Toast
Уведомление длинной операции с честным прогрессом: процент, полоса заполнения, счётчик файлов и отмена рядом.
- toast
- progress
- upload
- cancel
Превью
Использовать с AI
- 1. Скопируйте ссылку.
- 2. Напишите агенту своими словами и вставьте её в предложение.
- 3. Агент откроет ссылку и поставит компонент из registry.
размести это в шапке: https://vibeui.ru/c/toast-006
Загружаем фотографии
62%Показать полную инструкцию
То, что лежит по ссылке в развёрнутом виде. Нужна, если агент не может открыть ссылку — тогда вставьте этот текст целиком.
# Установка и размещение «toast-006» (Progress Toast) из VibeUI
## 1. Сначала установка — не пропускай, не пересоздавай
Выполни эту команду до того, как писать код:
npx shadcn@latest add https://vibeui.ru/r/toast-006.json
Registry item: https://vibeui.ru/r/toast-006.json
Ставится в: components/vibeui/toast-006.tsx (точный путь следует алиасам components.json этого проекта).
npm-зависимости: нет.
Registry-зависимости: нет.
Ставь из реестра. Не пересоздавай по описанию, не подменяй похожим
компонентом из другой библиотеки и не переписывай под стиль проекта.
## 2. Что это
Уведомление длинной операции с честным прогрессом: процент, полоса заполнения, счётчик файлов и отмена рядом.
Уведомление длинной операции: процент, полоса на CSS-переменной, счётчик и отмена. Ноль зависимостей, один файл, клиентского JS нет.
## 3. Как использовать
import { Toast006 } from "@/components/vibeui/toast-006"
<Toast006
title="Загружаем фотографии"
value={62}
countLabel="15 из 24 файлов"
cancelLabel="Отменить"
/>
Полный список пропсов — в установленном файле.
## 4. Куда поставить
Это мелкий inline-компонент. Поставь его ровно туда, куда просил
пользователь, внутрь существующей разметки. Не создавай ради него
новую страницу, секцию или обёртку. Если на этом месте уже стоит похожий
контрол — замени его, а не добавляй второй.
Куда поставить: ___
(Эту строку заполняет пользователь. Если она осталась пустой — спроси,
а не угадывай.)
## 5. Сохранить как установлено
- локальную палитру --vibeui-toast-006-* и не подменять её токенами вашей темы
- полосу на переменной: пересчёт ширины через calc дешевле перерисовки разметки
- role="progressbar" вместе с aria-valuenow — без них прогресс не читается вслух
- счётчик рядом с процентом: 62% без «15 из 24» не говорят, сколько ещё ждать
- кнопку отмены: длинную операцию обязательно должно быть чем остановить
- табличные цифры у процента и счётчика — иначе числа прыгают при каждом обновлении
## 6. Можно менять
- заголовок через title и значение прогресса через value
- подпись счётчика через countLabel
- подпись отмены через cancelLabel или убрать её пустой строкой
- цвет заполнения через переменную --vibeui-toast-006-tone
## 7. Правила
- Значение зажимается в 0–100: передать 120 безопасно, полоса не вылезет.
- Компонент ничего не загружает сам — value обновляет владелец операции.
- Отмена только вызывает onCancel: остановить запрос должен вызывающий код.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.
## 8. Проверка
- рендерится без ошибок в консоли;
- выглядит так же, как превью на странице VibeUI, откуда взята ссылка;
- если нет — ты изменил что-то из раздела 5, верни как было.Для разработчика
npx shadcn@latest add https://vibeui.ru/r/toast-006.jsonhttps://vibeui.ru/r/toast-006.jsonКомпонент самодостаточен: один файл, без зависимостей, собственная палитра в локальных переменных --vibeui-toast-006-*. Серверный: значение приходит пропом value и кладётся в переменную --vibeui-toast-006-value, ширину полосы считает calc — при перерисовке меняется одно число, а не разметка. Полоса размечена role="progressbar" с aria-valuenow, поэтому прогресс читается вслух. Значение зажимается в диапазон 0–100 и округляется, чтобы дробь не разъезжала в табличных цифрах.
Исходник компонента
Тот же файл, который поставит агент. Нужен, если вы предпочитаете скопировать код руками.
import type { ComponentPropsWithoutRef, CSSProperties } from "react"
export type Toast006Props = Omit<
ComponentPropsWithoutRef<"div">,
"children" | "title"
> & {
title?: string
/** Готово в процентах: определённый прогресс, а не бесконечная крутилка. */
value?: number
/** Что именно считается: «7 из 24 файлов». */
countLabel?: string
cancelLabel?: string
onCancel?: () => void
}
// Идея компонента: уведомление длинной операции с честным прогрессом. Процент
// живёт в CSS-переменной, поэтому полосу двигает одно число, а не пересборка
// разметки; рядом — счётчик и отмена, потому что ждать вслепую никто не готов.
const STYLES = `
:where([data-vibeui-block="toast-006"]){
--vibeui-toast-006-bg:oklch(0.22 0.014 265);
--vibeui-toast-006-fg:oklch(0.97 0.002 265);
--vibeui-toast-006-muted:oklch(0.76 0.008 265);
--vibeui-toast-006-track:oklch(1 0 0 / 14%);
--vibeui-toast-006-tone:oklch(0.7 0.16 200);
--vibeui-toast-006-value:0;
--vibeui-toast-006-radius:0.875rem;
--vibeui-toast-006-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="toast-006"]{
display:flex;flex-direction:column;gap:0.5rem;
width:100%;max-width:23rem;box-sizing:border-box;
padding:0.875rem 0.9375rem;
border-radius:var(--vibeui-toast-006-radius);
background:var(--vibeui-toast-006-bg);color:var(--vibeui-toast-006-fg);
font-family:var(--vibeui-toast-006-font);
box-shadow:0 20px 44px -24px oklch(0.15 0.02 265 / 65%);
}
[data-vibeui-block="toast-006"] [data-part="head"]{display:flex;align-items:baseline;gap:0.75rem}
[data-vibeui-block="toast-006"] [data-part="title"]{
margin:0;flex:1 1 auto;min-width:0;
font-size:0.875rem;font-weight:640;line-height:1.35;
overflow:hidden;text-overflow:ellipsis;white-space:nowrap;
}
[data-vibeui-block="toast-006"] [data-part="percent"]{
flex:none;font-size:0.875rem;font-weight:700;
font-variant-numeric:tabular-nums;color:var(--vibeui-toast-006-tone);
}
/* Полоса на переменной: прогресс двигает одно число, разметка не меняется. */
[data-vibeui-block="toast-006"] [data-part="track"]{
position:relative;height:0.375rem;border-radius:9999px;overflow:hidden;
background:var(--vibeui-toast-006-track);
}
[data-vibeui-block="toast-006"] [data-part="fill"]{
position:absolute;inset:0 auto 0 0;border-radius:inherit;
width:calc(var(--vibeui-toast-006-value) * 1%);
background:linear-gradient(90deg,var(--vibeui-toast-006-tone),color-mix(in oklab,var(--vibeui-toast-006-tone) 55%,oklch(0.85 0.13 150)));
transition:width .3s ease;
}
[data-vibeui-block="toast-006"] [data-part="foot"]{display:flex;align-items:center;justify-content:space-between;gap:0.75rem}
[data-vibeui-block="toast-006"] [data-part="count"]{font-size:0.75rem;line-height:1.4;color:var(--vibeui-toast-006-muted);font-variant-numeric:tabular-nums}
[data-vibeui-block="toast-006"] [data-part="cancel"]{
appearance:none;cursor:pointer;border:0;background:transparent;
padding:0.25rem 0.375rem;margin:-0.25rem -0.375rem;border-radius:0.375rem;
font:inherit;font-size:0.75rem;font-weight:600;
color:var(--vibeui-toast-006-muted);
transition:color .16s ease,background-color .16s ease;
}
[data-vibeui-block="toast-006"] [data-part="cancel"]:hover{color:var(--vibeui-toast-006-fg);background:oklch(1 0 0 / 10%)}
[data-vibeui-block="toast-006"] [data-part="cancel"]:focus-visible{outline:2px solid var(--vibeui-toast-006-tone);outline-offset:2px}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="toast-006"] *{animation:none!important;transition:none!important}}
`
/**
* Уведомление длинной операции: полоса прогресса, счётчик и отмена.
* Один файл, ноль зависимостей, собственная палитра.
*/
export function Toast006({
title = "Загружаем фотографии",
value = 62,
countLabel = "15 из 24 файлов",
cancelLabel = "Отменить",
onCancel,
className,
style,
...props
}: Toast006Props) {
const clamped = Math.min(100, Math.max(0, Math.round(value)))
const palette = {
"--vibeui-toast-006-value": clamped,
...style,
} as CSSProperties
return (
<>
<style href="vibeui-toast-006" precedence="medium">
{STYLES}
</style>
<div
{...props}
data-vibeui-block="toast-006"
role="status"
aria-live="polite"
className={className}
style={palette}
>
<div data-part="head">
<p data-part="title">{title}</p>
<span data-part="percent">{clamped}%</span>
</div>
<div
data-part="track"
role="progressbar"
aria-valuenow={clamped}
aria-valuemin={0}
aria-valuemax={100}
aria-label={title}
>
<span data-part="fill" />
</div>
<div data-part="foot">
<span data-part="count">{countLabel}</span>
{cancelLabel ? (
<button data-part="cancel" type="button" onClick={onCancel}>
{cancelLabel}
</button>
) : null}
</div>
</div>
</>
)
}