Code Block

Code Skeleton

Скелетон загрузки кода: полосы повторяют форму листинга — отступы вложенности, пустую строку и короткую закрывающую скобку.

  • skeleton
  • loading
  • code
  • placeholder

Превью

1440pxHost theme

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

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

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

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

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

# Установка и размещение «codeblock-014» (Code Skeleton) из VibeUI

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

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

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

## 2. Что это
Скелетон загрузки кода: полосы повторяют форму листинга — отступы вложенности, пустую строку и короткую закрывающую скобку.

Скелетон блока кода: шапка и строки, повторяющие форму листинга, с бегущим бликом. Ноль зависимостей, детерминированная раскладка, клиентского JS нет.

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

<Codeblock014 rows={6} label="Загрузка кода" />

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

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

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

## 5. Сохранить как установлено
- локальную палитру --vibeui-codeblock-014-* и не подменять её токенами вашей темы
- детерминированную таблицу ширин: Math.random разъезжается между сервером и клиентом и ломает гидратацию
- форму листинга — отступы и пустую строку: ровные одинаковые полосы читаются как абзац, а не как код
- role=status с aria-busy и скрытую подпись: без них загрузка не объявляется читалке экрана
- правило prefers-reduced-motion: бесконечный блик — раздражитель для части людей
- высоту строки скелетона, равную интервалу настоящего кода: иначе подмена дёргает раскладку

## 6. Можно менять
- число строк через rows
- подпись для читалки экрана через label
- таблицу формы строк в константе внутри файла
- цвет полос и скорость блика

## 7. Правила
- Скелетон обязан совпадать по высоте с настоящим блоком, иначе при загрузке страница прыгает.
- Таблица формы короче списка строк и повторяется по кругу: при большом rows узор становится заметным.
- Полосы скрыты от читалки экрана — она получает только подпись, а не набор пустых элементов.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.

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

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

npx shadcn@latest add https://vibeui.ru/r/codeblock-014.json
https://vibeui.ru/r/codeblock-014.json

Компонент самодостаточен: один файл, без зависимостей, собственная палитра в локальных переменных --vibeui-codeblock-014-*. Серверный: хуков нет. Ширины и отступы строк берутся из константной таблицы формы и повторяются по кругу — случайные значения разъезжались бы между сервером и клиентом и ломали гидратацию. Блик бежит по background-position, а не по transform, поэтому не нужен дополнительный слой; высота строки задана переменной и совпадает с межстрочным интервалом настоящего листинга. У корня role=status и aria-busy, подпись спрятана визуально, но доступна читалке экрана.

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

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

import type { CSSProperties } from "react"

export type Codeblock014Props = {
  rows?: number
  label?: string
  className?: string
  style?: CSSProperties
}

// Идея компонента: скелетон именно кода, а не абзаца. Ширины и отступы строк
// повторяют форму листинга — вложенность, пустая строка, короткая закрывающая
// скобка, — поэтому подмена на настоящий код не дёргает раскладку.
const STYLES = `
:where([data-vibeui-block="codeblock-014"]){
--vibeui-codeblock-014-bg:oklch(0.21 0.012 265);
--vibeui-codeblock-014-head:oklch(0.25 0.014 265);
--vibeui-codeblock-014-border:oklch(1 0 0 / 12%);
--vibeui-codeblock-014-bar:oklch(1 0 0 / 11%);
--vibeui-codeblock-014-shine:oklch(1 0 0 / 22%);
--vibeui-codeblock-014-row:1.375rem;
}
[data-vibeui-block="codeblock-014"]{
display:block;width:100%;max-width:30rem;box-sizing:border-box;overflow:hidden;
border:1px solid var(--vibeui-codeblock-014-border);border-radius:0.75rem;
background:var(--vibeui-codeblock-014-bg);
}
[data-vibeui-block="codeblock-014"] [data-part="head"]{
display:flex;align-items:center;gap:0.5rem;
padding:0.5625rem 0.875rem;
background:var(--vibeui-codeblock-014-head);
border-bottom:1px solid var(--vibeui-codeblock-014-border);
}
[data-vibeui-block="codeblock-014"] [data-part="body"]{
padding:0.75rem 0.875rem;
}
[data-vibeui-block="codeblock-014"] [data-part="row"]{
display:flex;align-items:center;height:var(--vibeui-codeblock-014-row);
}
[data-vibeui-block="codeblock-014"] [data-part="bar"]{
display:block;height:0.5rem;border-radius:999px;
background:var(--vibeui-codeblock-014-bar);
background-image:linear-gradient(90deg,transparent 0%,var(--vibeui-codeblock-014-shine) 50%,transparent 100%);
background-size:220% 100%;background-repeat:no-repeat;
animation:vibeui-codeblock-014-sweep 1.5s ease-in-out infinite;
}
[data-vibeui-block="codeblock-014"] [data-part="head"] [data-part="bar"]{height:0.625rem}
[data-vibeui-block="codeblock-014"] [data-part="gap"]{display:block;height:0.5rem;width:0}
[data-vibeui-block="codeblock-014"] [data-part="label"]{
position:absolute;width:1px;height:1px;margin:-1px;padding:0;
border:0;clip-path:inset(50%);overflow:hidden;white-space:nowrap;
}
@keyframes vibeui-codeblock-014-sweep{
from{background-position:120% 0}
to{background-position:-120% 0}
}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="codeblock-014"] *{animation:none!important;transition:none!important}}
`

// Форма листинга: отступ вложенности и доля ширины строки. Значения заданы
// таблицей, а не случайным числом: случайное разъезжается между сервером и
// клиентом и портит гидратацию.
const SHAPE = [
  { indent: 0, width: 62 },
  { indent: 1, width: 78 },
  { indent: 1, width: 45 },
  { indent: 2, width: 70 },
  { indent: 1, width: 0 },
  { indent: 1, width: 54 },
  { indent: 0, width: 18 },
]

/** Скелетон загрузки блока кода: шапка и строки формы листинга. */
export function Codeblock014({
  rows = 6,
  label = "Загрузка кода",
  className,
  style,
}: Codeblock014Props) {
  const count = Math.max(1, Math.round(rows))

  return (
    <>
      <style href="vibeui-codeblock-014" precedence="medium">
        {STYLES}
      </style>
      <div
        data-vibeui-block="codeblock-014"
        className={className}
        style={style}
        role="status"
        aria-busy="true"
      >
        <span data-part="label">{label}</span>
        <div data-part="head" aria-hidden="true">
          <span data-part="bar" style={{ width: "35%" }} />
          <span data-part="bar" style={{ width: "12%" }} />
        </div>
        <div data-part="body" aria-hidden="true">
          {Array.from({ length: count }, (_, index) => {
            const shape = SHAPE[index % SHAPE.length]

            return (
              <div data-part="row" key={index}>
                {shape.width === 0 ? (
                  <span data-part="gap" />
                ) : (
                  <span
                    data-part="bar"
                    style={{
                      marginInlineStart: `${shape.indent * 1.25}rem`,
                      width: `${shape.width}%`,
                    }}
                  />
                )}
              </div>
            )
          })}
        </div>
      </div>
    </>
  )
}