Code Block
Code Skeleton
Скелетон загрузки кода: полосы повторяют форму листинга — отступы вложенности, пустую строку и короткую закрывающую скобку.
- skeleton
- loading
- code
- placeholder
Превью
Использовать с AI
- 1. Скопируйте ссылку.
- 2. Напишите агенту своими словами и вставьте её в предложение.
- 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.jsonhttps://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>
</>
)
}