Accordion

Checklist Accordion

Аккордеон-чеклист онбординга: нумерованные шаги, галочки у выполненных и прогресс, который считается из самих шагов. Раскрыт первый невыполненный.

accordion
checklist
onboarding
progress

Превью

1440pxHost theme

Использовать с AI

1. Скопируйте ссылку.
2. Напишите агенту своими словами и вставьте её в предложение.
3. Агент откроет ссылку и поставит компонент из registry.

размести это в шапке: https://vibeui.ru/c/accordion-006

Настройка проекта

2 из 4

Создать проект2 минуты

Название и адрес можно поменять позже: адрес проекта не влияет на публичный домен.

Выбрать блоки10 минут

Соберите страницу из готовых блоков каталога. Порядок меняется перетаскиванием, лишнее удаляется.

Подключить домен5 минут

Добавьте A-запись на наш адрес у регистратора. Сертификат выпускается автоматически, обычно за пару минут.

Пригласить командупо желанию

Участники приглашаются по почте и получают роль редактора или читателя. Количество не ограничено тарифом.

Заголовок

Открыт шаг

Акцент

Показать полную инструкцию

То, что лежит по ссылке в развёрнутом виде. Нужна, если агент не может открыть ссылку — тогда вставьте этот текст целиком.

# Установка и размещение «accordion-006» (Checklist Accordion) из VibeUI

## 1. Сначала установка — не пропускай, не пересоздавай
Выполни эту команду до того, как писать код:
npx shadcn@latest add https://vibeui.ru/r/accordion-006.json

Registry item: https://vibeui.ru/r/accordion-006.json
Ставится в: components/vibeui/accordion-006.tsx (точный путь следует алиасам components.json этого проекта).
npm-зависимости: нет.
Registry-зависимости: нет.

Ставь из реестра. Не пересоздавай по описанию, не подменяй похожим
компонентом из другой библиотеки и не переписывай под стиль проекта.

## 2. Что это
Аккордеон-чеклист онбординга: нумерованные шаги, галочки у выполненных и прогресс, который считается из самих шагов. Раскрыт первый невыполненный.

Аккордеон-чеклист для онбординга: заголовок со счётчиком и полосой прогресса, нумерованные плитки шагов, галочка и приглушённая подпись у выполненных. Прогресс считается из шагов, поэтому разойтись со списком не может, а раскрытым открывается первый невыполненный шаг. Ноль зависимостей, один файл, своя палитра, клиентского JS нет.

## 3. Как использовать
import { Accordion006 } from "@/components/vibeui/accordion-006"

<Accordion006
  title="Настройка проекта"
  steps={[
    { title: "Создать проект", hint: "2 минуты", done: true, body: "Название можно поменять позже." },
    { title: "Подключить домен", hint: "5 минут", body: "Добавьте A-запись у регистратора." },
  ]}
/>

Полный список пропсов — в установленном файле.

## 4. Куда поставить
Это мелкий inline-компонент. Поставь его ровно туда, куда просил
пользователь, внутрь существующей разметки. Не создавай ради него
новую страницу, секцию или обёртку. Если на этом месте уже стоит похожий
контрол — замени его, а не добавляй второй.

Куда поставить: ___
(Эту строку заполняет пользователь. Если она осталась пустой — спроси,
а не угадывай.)

## 5. Сохранить как установлено
- локальную палитру --vibeui-accordion-006-* и не подменять её токенами вашей темы (bg-primary, bg-muted и подобными)
- подсчёт прогресса из массива шагов, а не отдельным пропом: число и список обязаны иметь один источник
- раскрытие первого невыполненного шага по умолчанию — это и делает компонент чеклистом, а не просто списком
- галочку у выполненного шага вместо одного лишь цвета: состояние должно читаться и в печати
- разметку progressbar у полосы с aria-valuenow и aria-valuemax
- нативные details/summary: состояние работает до гидратации
- @container-запрос, прячущий подсказки в узкой колонке
- блок <style> внутри компонента — в нём вся палитра, плитки и полоса

## 6. Можно менять
- массив steps: заголовок, текст, подсказка справа и флаг done
- title — заголовок чеклиста
- defaultOpen — если нужно раскрыть конкретный шаг вместо первого невыполненного
- акцент через проп accent — цвет кольца фокуса
- максимальную ширину и внешние отступы через className

## 7. Правила
- Флаг done приходит снаружи: компонент ничего не отмечает сам и не хранит состояние между заходами.
- Больше шести шагов в онбординге не работает — длинный список читается как работа, а не как начало.
- Когда все шаги выполнены, чеклист стоит убрать со страницы целиком, а не оставлять полностью зелёным.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.

## 8. Проверка
- рендерится без ошибок в консоли;
- выглядит так же, как превью на странице VibeUI, откуда взята ссылка;
- если нет — ты изменил что-то из раздела 5, верни как было.

Для разработчика

npx shadcn@latest add https://vibeui.ru/r/accordion-006.json

https://vibeui.ru/r/accordion-006.json

Компонент самодостаточен: один файл, без зависимостей, собственная палитра в локальных переменных --vibeui-accordion-006-*. Шапка несёт счётчик «сделано из всего» и полосу прогресса; и то и другое считается из массива шагов, отдельного пропа с числом нет. Раскрытие держат нативные <details>/<summary>, а открытым по умолчанию оказывается первый шаг без флага done — пользователь попадает туда, где остановился. Ширина полосы приходит переменной --vibeui-accordion-006-progress. В узкой колонке подсказки справа скрываются через @container.

Исходник компонента

Тот же файл, который поставит агент. Нужен, если вы предпочитаете скопировать код руками.

import type { ComponentPropsWithoutRef, CSSProperties } from "react"

export type Accordion006Step = {
  title: string
  body: string
  /** Шаг выполнен: номер заменяется галочкой, подпись гасится. */
  done?: boolean
  /** Подпись справа: сколько займёт, что понадобится. */
  hint?: string
}

export type Accordion006Props = Omit<
  ComponentPropsWithoutRef<"div">,
  "children"
> & {
  title?: string
  steps?: Accordion006Step[]
  /** Номер раскрытого шага. По умолчанию — первый невыполненный. */
  defaultOpen?: number
  accent?: string
}

// Идея компонента: аккордеон-чеклист для онбординга. Слева нумерованные
// плитки, выполненные помечены галочкой, сверху — счётчик и полоса прогресса,
// которая считается из самих шагов, а не задаётся отдельно. Раскрыт по
// умолчанию первый невыполненный шаг: пользователь попадает туда, где остановился.
const STYLES = `
:where([data-vibeui-block="accordion-006"]){
--vibeui-accordion-006-fg:oklch(0.22 0.014 265);
--vibeui-accordion-006-muted:oklch(0.52 0.014 265);
--vibeui-accordion-006-bg:oklch(1 0 0);
--vibeui-accordion-006-border:oklch(0.91 0.006 265);
--vibeui-accordion-006-track:oklch(0.93 0.006 265);
--vibeui-accordion-006-accent:oklch(0.55 0.2 262);
--vibeui-accordion-006-accent-fg:oklch(1 0 0);
--vibeui-accordion-006-done:oklch(0.58 0.15 152);
--vibeui-accordion-006-radius:1rem;
--vibeui-accordion-006-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
container-type:inline-size;
}
[data-vibeui-block="accordion-006"]{
width:100%;max-width:40rem;box-sizing:border-box;overflow:hidden;
border:1px solid var(--vibeui-accordion-006-border);
border-radius:var(--vibeui-accordion-006-radius);
background:var(--vibeui-accordion-006-bg);
color:var(--vibeui-accordion-006-fg);font-family:var(--vibeui-accordion-006-font);
}
[data-vibeui-block="accordion-006"] [data-part="head"]{
display:flex;flex-direction:column;gap:0.625rem;
padding:1.125rem 1.25rem;border-bottom:1px solid var(--vibeui-accordion-006-border);
}
[data-vibeui-block="accordion-006"] [data-part="head-row"]{
display:flex;align-items:baseline;justify-content:space-between;gap:1rem;
}
[data-vibeui-block="accordion-006"] [data-part="title"]{margin:0;font-size:1rem;font-weight:620}
[data-vibeui-block="accordion-006"] [data-part="count"]{
font-size:0.8125rem;color:var(--vibeui-accordion-006-muted);font-variant-numeric:tabular-nums;
}
/* Прогресс считается из шагов: разойтись со списком он не может. */
[data-vibeui-block="accordion-006"] [data-part="track"]{
height:0.25rem;border-radius:9999px;background:var(--vibeui-accordion-006-track);overflow:hidden;
}
[data-vibeui-block="accordion-006"] [data-part="bar"]{
height:100%;border-radius:inherit;background:var(--vibeui-accordion-006-done);
width:calc(var(--vibeui-accordion-006-progress,0) * 1%);
transition:width .3s cubic-bezier(.32,.72,0,1);
}
[data-vibeui-block="accordion-006"] details + details{border-top:1px solid var(--vibeui-accordion-006-border)}
[data-vibeui-block="accordion-006"] summary{
display:flex;align-items:flex-start;gap:0.75rem;
padding:0.9375rem 1.25rem;cursor:pointer;list-style:none;
font-size:0.9375rem;line-height:1.4;
}
[data-vibeui-block="accordion-006"] summary::-webkit-details-marker{display:none}
[data-vibeui-block="accordion-006"] summary:focus-visible{outline:2px solid var(--vibeui-accordion-006-accent);outline-offset:-2px}
/* Плитка шага: номер, а у выполненного — галочка на зелёной заливке. */
[data-vibeui-block="accordion-006"] [data-part="mark"]{
display:flex;align-items:center;justify-content:center;flex:none;
width:1.5rem;height:1.5rem;border-radius:0.5rem;
border:1px solid var(--vibeui-accordion-006-border);
font-size:0.75rem;font-weight:650;line-height:1;
color:var(--vibeui-accordion-006-muted);
}
[data-vibeui-block="accordion-006"] details[data-done="true"] [data-part="mark"]{
background:var(--vibeui-accordion-006-done);border-color:var(--vibeui-accordion-006-done);
color:var(--vibeui-accordion-006-accent-fg);
}
[data-vibeui-block="accordion-006"] [data-part="text"]{flex:1 1 auto;min-width:0;font-weight:550}
[data-vibeui-block="accordion-006"] details[data-done="true"] [data-part="text"]{color:var(--vibeui-accordion-006-muted);font-weight:500}
[data-vibeui-block="accordion-006"] [data-part="hint"]{
flex:none;font-size:0.75rem;color:var(--vibeui-accordion-006-muted);white-space:nowrap;
}
[data-vibeui-block="accordion-006"] [data-part="body"]{
margin:0;padding:0 1.25rem 1.125rem 3.5rem;
font-size:0.875rem;line-height:1.6;color:var(--vibeui-accordion-006-muted);max-width:58ch;
}
@container (max-width: 26rem){
[data-vibeui-block="accordion-006"] [data-part="hint"]{display:none}
[data-vibeui-block="accordion-006"] [data-part="body"]{padding-left:1.25rem}
}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="accordion-006"] *{animation:none!important;transition:none!important}}
`

const DEFAULT_STEPS: Accordion006Step[] = [
  {
    title: "Создать проект",
    hint: "2 минуты",
    done: true,
    body: "Название и адрес можно поменять позже: адрес проекта не влияет на публичный домен.",
  },
  {
    title: "Выбрать блоки",
    hint: "10 минут",
    done: true,
    body: "Соберите страницу из готовых блоков каталога. Порядок меняется перетаскиванием, лишнее удаляется.",
  },
  {
    title: "Подключить домен",
    hint: "5 минут",
    body: "Добавьте A-запись на наш адрес у регистратора. Сертификат выпускается автоматически, обычно за пару минут.",
  },
  {
    title: "Пригласить команду",
    hint: "по желанию",
    body: "Участники приглашаются по почте и получают роль редактора или читателя. Количество не ограничено тарифом.",
  },
]

/**
 * Аккордеон-чеклист онбординга: шаги, галочки и общий прогресс.
 * Один файл, ноль зависимостей, собственная палитра.
 */
export function Accordion006({
  title = "Настройка проекта",
  steps = DEFAULT_STEPS,
  defaultOpen,
  accent,
  className,
  style,
  ...props
}: Accordion006Props) {
  const done = steps.filter((step) => step.done).length
  const progress = steps.length ? (done / steps.length) * 100 : 0
  const firstOpen = steps.findIndex((step) => !step.done)
  const openIndex = defaultOpen ?? (firstOpen === -1 ? 0 : firstOpen)

  const palette = {
    "--vibeui-accordion-006-progress": progress,
    ...(accent ? { "--vibeui-accordion-006-accent": accent } : null),
    ...style,
  } as CSSProperties

  return (
    <>
      <style href="vibeui-accordion-006" precedence="medium">
        {STYLES}
      </style>
      <div
        {...props}
        data-vibeui-block="accordion-006"
        className={className}
        style={palette}
      >
        <div data-part="head">
          <div data-part="head-row">
            <p data-part="title">{title}</p>
            <span data-part="count">
              {done} из {steps.length}
            </span>
          </div>
          <div
            data-part="track"
            role="progressbar"
            aria-label={title}
            aria-valuemin={0}
            aria-valuemax={steps.length}
            aria-valuenow={done}
          >
            <div data-part="bar" />
          </div>
        </div>
        {steps.map((step, index) => (
          <details
            key={step.title}
            open={index === openIndex}
            data-done={step.done || undefined}
          >
            <summary>
              <span data-part="mark" aria-hidden="true">
                {step.done ? "✓" : index + 1}
              </span>
              <span data-part="text">{step.title}</span>
              {step.hint ? <span data-part="hint">{step.hint}</span> : null}
            </summary>
            <p data-part="body">{step.body}</p>
          </details>
        ))}
      </div>
    </>
  )
}