VibeUI

Inputs

Details Tree

Дерево каскада на нативных details и radio: уровни раскрываются без JavaScript, а выбранная ветка подсвечивается по всей глубине через :has().

  • cascader
  • details
  • no-js
  • form

Превью

1440pxHost theme

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

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

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

Куда положить файл

Документы
Договоры
Бухгалтерия
Материалы
Презентации
Медиа

Уровни — нативные details, лист — radio с общим именем: дерево отправляется обычной формой даже без JavaScript.

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

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

# Установка и размещение «cascader-008» (Details Tree) из VibeUI

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

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

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

## 2. Что это
Дерево каскада на нативных details и radio: уровни раскрываются без JavaScript, а выбранная ветка подсвечивается по всей глубине через :has().

Каскадное дерево на details и radio: раскрытие и выбор работают без клиентского JS и уходят обычной отправкой формы. Один файл, ноль зависимостей, серверный компонент.

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

<Cascader008 name="destination" heading="Куда положить файл" />

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

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

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

## 5. Сохранить как установлено
- локальную палитру --vibeui-cascader-008-* и не подменять её токенами вашей темы
- общее имя у всех radio: без него в форму уедет несколько значений вместо одного
- подсветку пути через :has(input:checked) — при свёрнутых ветках отметка иначе невидима
- value листа в виде полного пути: имя листа без ветки неоднозначно на стороне сервера
- заголовок абзацем вместо legend: legend с float заставляет соседние flex-дети обтекать его
- собственную светлую подложку панели: на тёмной карточке каталога тёмный текст пропадает

## 6. Можно менять
- имя поля формы через name
- заголовок панели через heading
- дерево и начально раскрытые ветки через tree
- акцентный цвет через accent

## 7. Правила
- details не анимирует раскрытие по высоте — поворот стрелки здесь единственная анимация и она отключается по prefers-reduced-motion.
- Раскрытые ветки сбрасываются при перерисовке: их состояние живёт в DOM, а не в пропсах.
- Выбирается только лист: чтобы разрешить выбор ветки, нужен radio рядом с summary.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.

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

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

npx shadcn@latest add https://vibeui.ru/r/cascader-008.json
https://vibeui.ru/r/cascader-008.json

Компонент самодостаточен: один файл, без зависимостей, собственная палитра в локальных переменных --vibeui-cascader-008-*. Серверный: хуков нет, раскрытие уровней ведёт нативный details, выбор — radio с общим именем, поэтому дерево уходит обычной формой даже без JavaScript. Правило details:has(input:checked) > summary подсвечивает всю цепочку родителей: при свёрнутых уровнях иначе не видно, где стоит отметка. Заголовок сделан абзацем, а не legend: legend с float ломает поток соседних flex-детей.

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

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

import type { CSSProperties, ReactNode } from "react"

export type Cascader008Node = {
  label: string
  open?: boolean
  children?: Cascader008Node[]
}

export type Cascader008Props = {
  name?: string
  heading?: string
  tree?: Cascader008Node[]
  accent?: string
  className?: string
  style?: CSSProperties
}

// Идея компонента: каскад, который переживёт выключенный JS. Ветки — нативные
// <details>, лист — radio с общим именем, поэтому дерево можно положить в
// обычную форму и отправить POST'ом. Выбранная ветка подсвечивается по всей
// глубине через :has(input:checked): без этого при свёрнутых уровнях
// непонятно, где именно стоит отметка.
const STYLES = `
:where([data-vibeui-block="cascader-008"]){
--vibeui-cascader-008-bg:oklch(1 0 0);
--vibeui-cascader-008-fg:oklch(0.23 0.014 160);
--vibeui-cascader-008-muted:oklch(0.54 0.012 160);
--vibeui-cascader-008-border:oklch(0.9 0.006 160);
--vibeui-cascader-008-accent:oklch(0.5 0.13 165);
--vibeui-cascader-008-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="cascader-008"]{
display:flex;flex-direction:column;gap:0.5rem;
width:100%;max-width:22rem;box-sizing:border-box;padding:0.875rem;
background:var(--vibeui-cascader-008-bg);color:var(--vibeui-cascader-008-fg);
border:1px solid var(--vibeui-cascader-008-border);border-radius:1rem;
font-family:var(--vibeui-cascader-008-font);
box-shadow:0 18px 40px -32px oklch(0.2 0.03 160 / 55%);
}
[data-vibeui-block="cascader-008"] *{box-sizing:border-box}
[data-vibeui-block="cascader-008"] [data-part="legend"]{
padding:0;margin:0 0 0.125rem;font-size:0.8125rem;font-weight:650;
letter-spacing:-0.01em;
}
[data-vibeui-block="cascader-008"] [data-part="set"]{
border:0;margin:0;padding:0;min-width:0;
}
[data-vibeui-block="cascader-008"] [data-part="node"]{
border-radius:0.5rem;
}
[data-vibeui-block="cascader-008"] summary{
display:flex;align-items:center;gap:0.5rem;
padding:0.3125rem 0.4375rem;border-radius:0.5rem;cursor:pointer;
font-size:0.8125rem;list-style:none;
transition:background-color .14s ease,color .14s ease;
}
[data-vibeui-block="cascader-008"] summary::-webkit-details-marker{display:none}
[data-vibeui-block="cascader-008"] summary:hover{
background:color-mix(in oklab,var(--vibeui-cascader-008-accent) 9%,transparent);
}
[data-vibeui-block="cascader-008"] summary:focus-visible{
outline:2px solid var(--vibeui-cascader-008-accent);outline-offset:-2px;
}
[data-vibeui-block="cascader-008"] [data-part="tw"]{
flex:0 0 auto;width:0.375rem;height:0.375rem;
border-right:1.5px solid var(--vibeui-cascader-008-muted);
border-top:1.5px solid var(--vibeui-cascader-008-muted);
transform:rotate(45deg);
transition:transform .16s ease;
}
[data-vibeui-block="cascader-008"] [data-part="node"][open] > summary [data-part="tw"]{
transform:rotate(135deg);
}
/* Отметка может лежать в свёрнутой ветке — подсвечиваем весь путь до неё. */
[data-vibeui-block="cascader-008"] [data-part="node"]:has(input:checked) > summary{
color:var(--vibeui-cascader-008-accent);font-weight:650;
}
[data-vibeui-block="cascader-008"] [data-part="branch"]{
display:flex;flex-direction:column;gap:0.0625rem;
margin:0.125rem 0 0.25rem 0.6875rem;padding:0 0 0 0.6875rem;
border-left:1px solid var(--vibeui-cascader-008-border);
}
[data-vibeui-block="cascader-008"] [data-part="leaf"]{
display:flex;align-items:center;gap:0.5rem;
padding:0.3125rem 0.4375rem;border-radius:0.5rem;cursor:pointer;
font-size:0.78125rem;
transition:background-color .14s ease;
}
[data-vibeui-block="cascader-008"] [data-part="leaf"]:hover{
background:color-mix(in oklab,var(--vibeui-cascader-008-accent) 9%,transparent);
}
[data-vibeui-block="cascader-008"] [data-part="leaf"]:has(input:focus-visible){
outline:2px solid var(--vibeui-cascader-008-accent);outline-offset:-2px;
}
[data-vibeui-block="cascader-008"] [data-part="leaf"]:has(input:checked){
color:var(--vibeui-cascader-008-accent);font-weight:600;
background:color-mix(in oklab,var(--vibeui-cascader-008-accent) 12%,transparent);
}
[data-vibeui-block="cascader-008"] input[type="radio"]{
flex:0 0 auto;width:0.875rem;height:0.875rem;margin:0;
accent-color:var(--vibeui-cascader-008-accent);
}
[data-vibeui-block="cascader-008"] [data-part="hint"]{
margin:0;padding-top:0.5rem;border-top:1px solid var(--vibeui-cascader-008-border);
font-size:0.6875rem;line-height:1.4;color:var(--vibeui-cascader-008-muted);
}
@media (prefers-reduced-motion:reduce){
[data-vibeui-block="cascader-008"] *{animation:none!important;transition:none!important}
}
`

const DEFAULT_TREE: Cascader008Node[] = [
  {
    label: "Документы",
    open: true,
    children: [
      {
        label: "Договоры",
        open: true,
        children: [
          { label: "Рамочные" },
          { label: "Дополнительные соглашения" },
        ],
      },
      {
        label: "Бухгалтерия",
        children: [{ label: "Счета" }, { label: "Акты" }],
      },
    ],
  },
  {
    label: "Материалы",
    children: [
      {
        label: "Презентации",
        children: [{ label: "Для клиентов" }, { label: "Внутренние" }],
      },
      { label: "Медиа", children: [{ label: "Логотипы" }, { label: "Фото" }] },
    ],
  },
]

/**
 * Дерево на <details> и radio: каскадный выбор без единой строки клиентского JS.
 * Один файл, ноль зависимостей, собственная палитра.
 */
export function Cascader008({
  name = "vibeui-cascader-008",
  heading = "Куда положить файл",
  tree = DEFAULT_TREE,
  accent,
  className,
  style,
}: Cascader008Props) {
  const renderNodes = (nodes: Cascader008Node[], trail: string[]): ReactNode =>
    nodes.map((node) => {
      const path = [...trail, node.label]

      if (!node.children?.length) {
        return (
          <label key={path.join("/")} data-part="leaf">
            <input
              type="radio"
              name={name}
              value={path.join("/")}
              defaultChecked={path.join("/") === "Документы/Договоры/Рамочные"}
            />
            {node.label}
          </label>
        )
      }

      return (
        <details key={path.join("/")} data-part="node" open={node.open}>
          <summary>
            <i data-part="tw" aria-hidden="true" />
            {node.label}
          </summary>
          <div data-part="branch">{renderNodes(node.children, path)}</div>
        </details>
      )
    })

  const palette = {
    ...(accent ? { "--vibeui-cascader-008-accent": accent } : null),
    ...style,
  } as CSSProperties

  return (
    <>
      <style href="vibeui-cascader-008" precedence="medium">
        {STYLES}
      </style>
      <div
        data-vibeui-block="cascader-008"
        className={className}
        style={palette}
      >
        <fieldset data-part="set">
          <p data-part="legend">{heading}</p>
          {renderNodes(tree, [])}
        </fieldset>
        <p data-part="hint">
          Уровни — нативные details, лист — radio с общим именем: дерево
          отправляется обычной формой даже без JavaScript.
        </p>
      </div>
    </>
  )
}