Display
Ticked Goal Ring
Кольцевая шкала с делениями и засечкой цели: видно и сколько сделано, и сколько было обещано, поэтому перевыполнение читается сразу, без сравнения двух чисел.
- progress
- ring
- goal
- display
Превью
Использовать с AI
- 1. Скопируйте ссылку.
- 2. Напишите агенту своими словами и вставьте её в предложение.
- 3. Агент откроет ссылку и поставит компонент из registry.
размести это в шапке: https://vibeui.ru/c/progress-003
Показать полную инструкцию
То, что лежит по ссылке в развёрнутом виде. Нужна, если агент не может открыть ссылку — тогда вставьте этот текст целиком.
# Установка и размещение «progress-003» (Ticked Goal Ring) из VibeUI
## 1. Сначала установка — не пропускай, не пересоздавай
Выполни эту команду до того, как писать код:
npx shadcn@latest add https://vibeui.ru/r/progress-003.json
Registry item: https://vibeui.ru/r/progress-003.json
Ставится в: components/vibeui/progress-003.tsx (точный путь следует алиасам components.json этого проекта).
npm-зависимости: нет.
Registry-зависимости: нет.
Ставь из реестра. Не пересоздавай по описанию, не подменяй похожим
компонентом из другой библиотеки и не переписывай под стиль проекта.
## 2. Что это
Кольцевая шкала с делениями и засечкой цели: видно и сколько сделано, и сколько было обещано, поэтому перевыполнение читается сразу, без сравнения двух чисел.
Кольцевая шкала: conic-gradient под радиальной маской, деления вторым conic-слоем и повёрнутая засечка цели. Ноль зависимостей, один файл, серверный рендер.
## 3. Как использовать
import { Progress003 } from "@/components/vibeui/progress-003"
<Progress003 value={72} target={85} label="План квартала" unit="выполнено" />
Полный список пропсов — в установленном файле.
## 4. Куда поставить
Это мелкий inline-компонент. Поставь его ровно туда, куда просил
пользователь, внутрь существующей разметки. Не создавай ради него
новую страницу, секцию или обёртку. Если на этом месте уже стоит похожий
контрол — замени его, а не добавляй второй.
Куда поставить: ___
(Эту строку заполняет пользователь. Если она осталась пустой — спроси,
а не угадывай.)
## 5. Сохранить как установлено
- локальную палитру --vibeui-progress-003-* и не подменять её токенами вашей темы
- радиальную маску на дуге и делениях: без неё кольцо станет закрашенным кругом
- число поверх кольца, а не внутри маскированного слоя — иначе маска вырежет и цифры
- поворот засечки на target × 3.6deg: любая другая формула разойдётся с дугой
- моноширинные цифры: при обычных подпись дёргается на каждом обновлении
- собственную светлую подложку: число и подписи тёмные и на тёмном фоне исчезнут
## 6. Можно менять
- факт через value и цель через target
- заголовок через label и подпись под числом через unit
- диаметр и толщину кольца через переменные размера
- цвет дуги через переменную акцента
## 7. Правила
- value и target зажимаются в 0–100: показать перевыполнение сверх ста процентов кольцо не может.
- Шаг делений задан в repeating-conic-gradient: менять его надо в двух местах — в CSS и в подписи.
- На диаметре меньше 5rem деления сливаются в серую кайму, уберите слой ticks.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.
## 8. Проверка
- рендерится без ошибок в консоли;
- выглядит так же, как превью на странице VibeUI, откуда взята ссылка;
- если нет — ты изменил что-то из раздела 5, верни как было.Для разработчика
npx shadcn@latest add https://vibeui.ru/r/progress-003.jsonhttps://vibeui.ru/r/progress-003.jsonКомпонент самодостаточен: один файл, без зависимостей, собственная палитра в локальных переменных --vibeui-progress-003-*. Серверный: хуков нет. Дуга — conic-gradient, вырезанный радиальной маской, поэтому кольцо остаётся одним элементом без svg и без круга-заглушки в центре. Деления — второй слой, repeating-conic-gradient цвета подложки поверх дуги под той же маской: риски «прорезаны» в кольце, а не нарисованы отдельными элементами. Засечка цели — абсолютный слой, повёрнутый на target × 3.6deg, поэтому положение считается прямо из процента. Число лежит поверх кольца, а не внутри маскированного элемента: маска вырезала бы и цифры. role="progressbar" с aria-valuetext, который называет и факт, и цель.
Исходник компонента
Тот же файл, который поставит агент. Нужен, если вы предпочитаете скопировать код руками.
import type { ComponentPropsWithoutRef, CSSProperties } from "react"
export type Progress003Props = Omit<
ComponentPropsWithoutRef<"div">,
"children"
> & {
value?: number
/** Отметка цели на шкале: до неё план, после — перевыполнение. */
target?: number
label?: string
unit?: string
}
// Идея компонента: кольцевая шкала с делениями и меткой цели. Дуга и риски
// нарисованы двумя conic-gradient в одном элементе, метка цели — засечка,
// повёрнутая на нужный угол. Поэтому кольцо остаётся одним div без svg, а
// «сколько сделано» и «сколько было обещано» видно одновременно.
const STYLES = `
:where([data-vibeui-block="progress-003"]){
--vibeui-progress-003-size:8rem;
--vibeui-progress-003-thickness:0.75rem;
--vibeui-progress-003-value:0;
--vibeui-progress-003-target:0;
--vibeui-progress-003-bg:oklch(1 0 0);
--vibeui-progress-003-fg:oklch(0.24 0.014 265);
--vibeui-progress-003-muted:oklch(0.55 0.014 265);
--vibeui-progress-003-border:oklch(0.9 0.006 265);
--vibeui-progress-003-track:oklch(0.93 0.006 265);
--vibeui-progress-003-accent:oklch(0.58 0.16 155);
--vibeui-progress-003-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="progress-003"]{
display:inline-flex;flex-direction:column;align-items:center;gap:0.625rem;
box-sizing:border-box;padding:1.125rem 1.25rem;
background:var(--vibeui-progress-003-bg);
border:1px solid var(--vibeui-progress-003-border);border-radius:1.125rem;
font-family:var(--vibeui-progress-003-font);color:var(--vibeui-progress-003-fg);
text-align:center;
}
[data-vibeui-block="progress-003"] [data-part="dial"]{
position:relative;display:grid;place-items:center;
width:var(--vibeui-progress-003-size);height:var(--vibeui-progress-003-size);
}
/* Дуга: conic-gradient, вырезанный радиальной маской — кольцо без svg. */
[data-vibeui-block="progress-003"] [data-part="arc"]{
position:absolute;inset:0;border-radius:9999px;
background:conic-gradient(
var(--vibeui-progress-003-accent) calc(var(--vibeui-progress-003-value) * 1%),
var(--vibeui-progress-003-track) 0);
mask:radial-gradient(farthest-side,transparent calc(100% - var(--vibeui-progress-003-thickness)),#000 calc(100% - var(--vibeui-progress-003-thickness)));
transition:background .35s ease;
}
/* Риски: второй conic-gradient поверх дуги, повторяющийся каждые 30 градусов. */
[data-vibeui-block="progress-003"] [data-part="ticks"]{
position:absolute;inset:0;border-radius:9999px;pointer-events:none;
background:repeating-conic-gradient(var(--vibeui-progress-003-bg) 0deg 1.4deg,transparent 1.4deg 30deg);
mask:radial-gradient(farthest-side,transparent calc(100% - var(--vibeui-progress-003-thickness)),#000 calc(100% - var(--vibeui-progress-003-thickness)));
}
/* Метка цели: засечка, повёрнутая на долю круга — видно план поверх факта. */
[data-vibeui-block="progress-003"] [data-part="goal"]{
position:absolute;inset:0;pointer-events:none;
transform:rotate(calc(var(--vibeui-progress-003-target) * 3.6deg));
}
[data-vibeui-block="progress-003"] [data-part="goal"]::before{
content:"";position:absolute;left:50%;top:-2px;
width:2px;height:calc(var(--vibeui-progress-003-thickness) + 4px);
margin-left:-1px;border-radius:1px;
background:var(--vibeui-progress-003-fg);
}
[data-vibeui-block="progress-003"] [data-part="value"]{
position:relative;font-size:calc(var(--vibeui-progress-003-size) * 0.22);
font-weight:700;line-height:1;font-variant-numeric:tabular-nums;
}
[data-vibeui-block="progress-003"] [data-part="unit"]{
font-size:0.6875rem;font-weight:600;color:var(--vibeui-progress-003-muted);
letter-spacing:0.04em;text-transform:uppercase;
}
[data-vibeui-block="progress-003"] [data-part="label"]{
font-size:0.8125rem;font-weight:650;
}
[data-vibeui-block="progress-003"] [data-part="goalnote"]{
font-size:0.6875rem;color:var(--vibeui-progress-003-muted);
font-variant-numeric:tabular-nums;
}
@media (prefers-reduced-motion:reduce){
[data-vibeui-block="progress-003"] *{animation:none!important;transition:none!important}
}
`
/**
* Кольцевая шкала с делениями и меткой цели.
* Один файл, ноль зависимостей, собственная палитра.
*/
export function Progress003({
value = 72,
target = 85,
label = "План квартала",
unit = "выполнено",
className,
style,
...props
}: Progress003Props) {
const done = Math.min(100, Math.max(0, value))
const goal = Math.min(100, Math.max(0, target))
const palette = {
"--vibeui-progress-003-value": done,
"--vibeui-progress-003-target": goal,
...style,
} as CSSProperties
return (
<>
<style href="vibeui-progress-003" precedence="medium">
{STYLES}
</style>
<div
{...props}
data-vibeui-block="progress-003"
className={className}
style={palette}
>
<div
data-part="dial"
role="progressbar"
aria-label={label}
aria-valuemin={0}
aria-valuemax={100}
aria-valuenow={Math.round(done)}
aria-valuetext={`${Math.round(done)} процентов при цели ${Math.round(goal)}`}
>
<span data-part="arc" />
<span data-part="ticks" aria-hidden="true" />
<span data-part="goal" aria-hidden="true" />
<span data-part="value">{Math.round(done)}%</span>
</div>
<span data-part="unit">{unit}</span>
<span data-part="label">{label}</span>
<span data-part="goalnote">Цель {Math.round(goal)}%</span>
</div>
</>
)
}