Carousel

Centering Thumbs

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

  • carousel
  • gallery
  • thumbnails
  • keyboard

Превью

1440pxHost theme

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

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

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

1/6

Утро в порту

Мурманск

Стрелками ← и → можно перейти к соседнему кадру.
Показать полную инструкцию

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

# Установка и размещение «carousel-013» (Centering Thumbs) из VibeUI

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

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

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

## 2. Что это
Галерея с полосой миниатюр, где выбранная сама доезжает до центра полосы, а по кадрам ходят стрелки клавиатуры.

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

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

<Carousel013
  label="Галерея"
  shots={[
    { title: "Утро в порту", place: "Мурманск", hue: 220 },
    { title: "Дорога на перевал", place: "Алтай", hue: 150 },
  ]}
/>

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

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

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

## 5. Сохранить как установлено
- локальную палитру --vibeui-carousel-013-* и не подменять её токенами вашей темы
- block:"nearest" в scrollIntoView — иначе к центру подтянется вся страница
- рамку у выбранной миниатюры: приглушение соседей на телефоне почти не видно
- миниатюры как кнопки с подписью «Кадр N»: у div'а нет ни роли, ни имени
- перенос фокуса на выбранную миниатюру при стрелках, иначе клавиатура теряет место
- aria-current на выбранной миниатюре, а не только визуальную рамку

## 6. Можно менять
- кадры через shots: заголовок, место и оттенок
- подпись галереи через label
- цвет акцента через accent
- размер миниатюры в правиле width у [data-part="thumb"]

## 7. Правила
- Кадры здесь градиентные: с фотографиями замените подложку на <img> с alt.
- Миниатюр больше двадцати превращают полосу в отдельную задачу навигации.
- Свайпа по большому кадру нет: переключение идёт миниатюрами и стрелками.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.

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

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

npx shadcn@latest add https://vibeui.ru/r/carousel-013.json
https://vibeui.ru/r/carousel-013.json

Компонент самодостаточен: один файл, без зависимостей, палитра в локальных переменных --vibeui-carousel-013-*. Клиентский ("use client") — позицию держит useState. Миниатюр обычно больше, чем влезает в ширину, поэтому выбранная доводится до центра вызовом scrollIntoView({block:"nearest",inline:"center"}): block:"nearest" не даёт браузеру дёрнуть всю страницу. Миниатюры — настоящие кнопки с подписью «Кадр N», выбранная помечена aria-current и рамкой, а не только яркостью: приглушение соседей на маленьком экране почти незаметно.

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

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

"use client"

import { useEffect, useRef, useState } from "react"
import type { ComponentPropsWithoutRef, CSSProperties } from "react"

export type Carousel013Shot = {
  title: string
  place?: string
  hue?: number
}

export type Carousel013Props = Omit<
  ComponentPropsWithoutRef<"section">,
  "children"
> & {
  shots?: Carousel013Shot[]
  label?: string
  accent?: string
}

// Идея компонента: полоса миниатюр под кадром, по которой ходят стрелками.
// Миниатюр обычно больше, чем влезает в ширину, поэтому выбранная сама
// доезжает до центра полосы — scrollIntoView с inline:"center" и
// block:"nearest", чтобы прокрутить полосу и не дёрнуть страницу. Выбор
// помечен рамкой и подписью «кадр N», а не только яркостью: приглушение
// соседей на маленьком экране почти незаметно.
const STYLES = `
:where([data-vibeui-block="carousel-013"]){
--vibeui-carousel-013-bg:oklch(1 0 0);
--vibeui-carousel-013-fg:oklch(0.22 0.014 265);
--vibeui-carousel-013-muted:oklch(0.58 0.014 265);
--vibeui-carousel-013-border:oklch(0.91 0.006 265);
--vibeui-carousel-013-accent:oklch(0.55 0.19 262);
--vibeui-carousel-013-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="carousel-013"]{
display:flex;flex-direction:column;gap:0.5rem;
width:100%;max-width:26rem;box-sizing:border-box;padding:0.875rem;
background:var(--vibeui-carousel-013-bg);
border:1px solid var(--vibeui-carousel-013-border);border-radius:1rem;
font-family:var(--vibeui-carousel-013-font);color:var(--vibeui-carousel-013-fg);
}
[data-vibeui-block="carousel-013"] [data-part="stage"]{
position:relative;display:flex;flex-direction:column;justify-content:flex-end;
aspect-ratio:16 / 10;padding:0.875rem;box-sizing:border-box;overflow:hidden;
border-radius:0.875rem;
background:
radial-gradient(90% 80% at 20% 20%,oklch(0.9 0.06 var(--vibeui-carousel-013-hue,250)),transparent 70%),
linear-gradient(150deg,oklch(0.74 0.1 var(--vibeui-carousel-013-hue,250)),oklch(0.42 0.11 var(--vibeui-carousel-013-hue,250)));
color:oklch(0.99 0.003 265);
}
[data-vibeui-block="carousel-013"] [data-part="name"]{margin:0;font-size:1rem;font-weight:680;line-height:1.2}
[data-vibeui-block="carousel-013"] [data-part="place"]{margin:0.125rem 0 0;font-size:0.75rem;color:oklch(0.93 0.01 265)}
[data-vibeui-block="carousel-013"] [data-part="counter"]{
position:absolute;right:0.625rem;top:0.625rem;
padding:0.125rem 0.4375rem;border-radius:9999px;
background:oklch(0.2 0.02 265 / 45%);color:oklch(1 0 0);
font-size:0.6875rem;font-weight:650;font-variant-numeric:tabular-nums;
}
[data-vibeui-block="carousel-013"] [data-part="thumbs"]{
display:flex;gap:0.375rem;margin:0;padding:0.125rem 0 0.25rem;list-style:none;
overflow-x:auto;overscroll-behavior-x:contain;scroll-behavior:smooth;scrollbar-width:none;
}
[data-vibeui-block="carousel-013"] [data-part="thumbs"]::-webkit-scrollbar{display:none}
[data-vibeui-block="carousel-013"] [data-part="thumb"]{
appearance:none;cursor:pointer;flex:none;padding:0;
width:3.5rem;aspect-ratio:4 / 3;border-radius:0.5rem;overflow:hidden;
border:2px solid transparent;
background:linear-gradient(150deg,oklch(0.82 0.08 var(--vibeui-carousel-013-hue,250)),oklch(0.55 0.1 var(--vibeui-carousel-013-hue,250)));
opacity:.65;transition:opacity .16s ease,border-color .16s ease;
}
[data-vibeui-block="carousel-013"] [data-part="thumb"]:hover{opacity:1}
[data-vibeui-block="carousel-013"] [data-part="thumb"]:focus-visible{outline:2px solid var(--vibeui-carousel-013-accent);outline-offset:2px}
/* Рамка, а не только яркость: приглушение соседей на телефоне почти не видно. */
[data-vibeui-block="carousel-013"] [data-part="thumb"][aria-current="true"]{
opacity:1;border-color:var(--vibeui-carousel-013-accent);
}
[data-vibeui-block="carousel-013"] [data-part="hint"]{
font-size:0.6875rem;color:var(--vibeui-carousel-013-muted);
}
@media (prefers-reduced-motion:reduce){
[data-vibeui-block="carousel-013"] [data-part="thumbs"]{scroll-behavior:auto}
[data-vibeui-block="carousel-013"] *{animation:none!important;transition:none!important}
}
`

const DEFAULT_SHOTS: Carousel013Shot[] = [
  { title: "Утро в порту", place: "Мурманск", hue: 220 },
  { title: "Дорога на перевал", place: "Алтай", hue: 150 },
  { title: "Старый мост", place: "Псков", hue: 40 },
  { title: "Тихая бухта", place: "Приморье", hue: 190 },
  { title: "Поле под снегом", place: "Вологда", hue: 280 },
  { title: "Крыши на закате", place: "Казань", hue: 20 },
]

/**
 * Галерея с полосой миниатюр: выбранная доезжает до центра, стрелки работают.
 * Один файл, ноль зависимостей, собственная палитра.
 */
export function Carousel013({
  shots = DEFAULT_SHOTS,
  label = "Галерея",
  accent,
  className,
  style,
  ...props
}: Carousel013Props) {
  const [index, setIndex] = useState(0)
  const strip = useRef<HTMLDivElement>(null)

  useEffect(() => {
    strip.current
      ?.querySelector(`[data-part="thumb"][aria-current="true"]`)
      ?.scrollIntoView({ block: "nearest", inline: "center" })
  }, [index])

  function go(next: number) {
    const target = (next + shots.length) % shots.length
    setIndex(target)
    const buttons = strip.current?.querySelectorAll("[data-part='thumb']")
    ;(buttons?.[target] as HTMLButtonElement | undefined)?.focus()
  }

  const shot = shots[index]

  const palette = {
    "--vibeui-carousel-013-hue": shot.hue ?? 250,
    ...(accent ? { "--vibeui-carousel-013-accent": accent } : null),
    ...style,
  } as CSSProperties

  return (
    <>
      <style href="vibeui-carousel-013" precedence="medium">
        {STYLES}
      </style>
      <section
        {...props}
        data-vibeui-block="carousel-013"
        aria-roledescription="карусель"
        aria-label={label}
        className={className}
        style={palette}
      >
        <div data-part="stage">
          <span data-part="counter">
            {index + 1}/{shots.length}
          </span>
          <p data-part="name">{shot.title}</p>
          {shot.place ? <p data-part="place">{shot.place}</p> : null}
        </div>
        <div
          data-part="thumbs"
          ref={strip}
          role="group"
          aria-label="Кадры"
          onKeyDown={(event) => {
            if (event.key === "ArrowRight") {
              event.preventDefault()
              go(index + 1)
            }
            if (event.key === "ArrowLeft") {
              event.preventDefault()
              go(index - 1)
            }
          }}
        >
          {shots.map((item, position) => (
            <button
              key={item.title}
              type="button"
              data-part="thumb"
              aria-current={position === index}
              aria-label={`Кадр ${position + 1}: ${item.title}`}
              style={
                {
                  "--vibeui-carousel-013-hue": item.hue ?? 250,
                } as CSSProperties
              }
              onClick={() => setIndex(position)}
            />
          ))}
        </div>
        <span data-part="hint">
          Стрелками ← и → можно перейти к соседнему кадру.
        </span>
      </section>
    </>
  )
}