Motiva
Мои коллекции
← каталог

Showcase Gallery

Витрина работ: по наведению приближается картинка внутри неподвижной рамки, а не карточка — соседи не сдвигаются и раскладка не пересчитывается.

csshoverrevealbasic~2 КБreduced-motion ✓
↗
↕ демо длиннее кадра — прокрутите его

Редактируемые поля

Секция «showcase». Весь контент приходит пропсами — ниже то, что конструктор даст поправить, не трогая код.

ПропЧто этоТип
eyebrowНадпись сверхуtext
titleЗаголовокtext
itemsКарточкиlist · до 8

Все пропсы

Разобрано из кода записи: обязательные — без «?», у остальных показано значение по умолчанию.

ПропТипПо умолчаниюЧто это
eyebrow?string"работы"
title?string"Свежее из студии"
items?ShowcaseItem[]ITEMS
background?ReactNode—Сокет фона: любой эффект с `mount.role: "background"`, например `<AuroraField />`. Занят — секция снимает собственную заливку, чтобы не спорить за слой.
ShowcaseItem — что внутри
  • src: string— Адрес картинки — свой или любой CDN.
  • title: string
  • tag?: string
  • wide?: boolean— Растянуть на две колонки.

Установка

npx shadcn@latest add https://motiva.pages.dev/r/showcase-gallery.json
Что нужно в проекте до установки
  1. Файл components.json в корне

    Из него CLI узнаёт, куда класть файлы. Алиасы — в такой форме:

    "aliases": { "components": "@/components", "lib": "@/lib" }

    Нет файла — установка не начнётся вовсе.

  2. Алиас @ объявлен дважды

    В корневом tsconfig.json и в конфиге сборщика. В Vite корневой tsconfig часто содержит только references — этого мало.

    "paths": { "@/*": ["./src/*"] }        // tsconfig.json
    resolve.alias = { "@": "/src" }        // vite.config.ts

    Без paths CLI молча создаёт папку с именем @.

  3. Токены подключены один раз на приложение

    Они приезжают вместе с записью — достаточно импортировать их в точке входа:

    import "@/styles/motiva-tokens.css";

    Без них блок потеряет цвета, ритм и тему.

  4. Своя типографика не спорит с блоком

    Наследуемые свойства протекают внутрь: text-align: center на обёртке отцентрует содержимое секции. То же касается font-familyи line-height.

  5. Проект без TypeScript? всё равно нужен tsconfig

    CLI грузит tsconfig.json безусловно, а при "tsx": false идёт за jsconfig.json и падает так же. Минимум — файл с pathsи "tsx": true в components.json.

    Приехавший рядом .tsx можно не трогать — вам нужен .vanilla.js.

Экспорт

↓ Скачать .zip

Код

const css = `.shg { width: 100%; padding-block: var(--ds-section-y, var(--ds-8, 80px));
  background: var(--ds-bg, oklch(0.14 0.02 275));
  color: var(--ds-fg, oklch(0.95 0.01 265));
  font-family: var(--ds-font, system-ui, sans-serif); }
.shg-in { max-width: var(--ds-container, 1120px); margin-inline: auto;
  padding-inline: var(--ds-gutter, clamp(18px, 5vw, 54px)); }
.shg-eyebrow { margin: 0 0 var(--ds-2, 8px);
  font-family: var(--ds-font-mono, ui-monospace, monospace);
  font-size: var(--ds-text-xs, 0.75rem); letter-spacing: 0.16em; text-transform: uppercase;
  color: var(--ds-accent, oklch(0.72 0.16 300)); }
.shg-h { margin: 0 0 var(--ds-6, 36px); font-size: var(--ds-text-xl, 2rem); font-weight: 750;
  letter-spacing: var(--ds-tracking-tight, -0.03em); }

/* dense — иначе авто-раскладка кладёт плитки строго по порядку и НЕ возвращается
   заполнять дыру, которую оставила широкая: при переносе появляются пустые клетки.
   Расплата честная: визуальный порядок может разойтись с порядком в разметке,
   поэтому приём годится для галереи и не годится там, где порядок несёт смысл. */
.shg-grid { display: grid; gap: var(--ds-3, 12px);
  grid-template-columns: repeat(3, 1fr); grid-auto-flow: row dense; }
@media (max-width: 760px) { .shg-grid { grid-template-columns: repeat(2, 1fr); } }
@media (max-width: 460px) { .shg-grid { grid-template-columns: 1fr; } }

.shg-card { position: relative; display: block; overflow: hidden; text-decoration: none;
  border-radius: var(--ds-radius, 14px); aspect-ratio: 4 / 3;
  background: var(--ds-surface, oklch(0.18 0.02 275));
  border: 1px solid var(--ds-border, oklch(0.3 0.02 275)); }
.shg-card[data-wide="1"] { grid-column: span 2; }
@media (max-width: 460px) { .shg-card[data-wide="1"] { grid-column: span 1; } }
/* приближается картинка внутри рамки: раскладка не трогается, соседи стоят */
.shg-card img { display: block; width: 100%; height: 100%; object-fit: cover;
  transition: transform var(--ds-slow, 0.6s) var(--ds-ease-out, cubic-bezier(0.16, 1, 0.3, 1)); }
.shg-card:hover img, .shg-card:focus-visible img { transform: scale(1.06); }
.shg-card:focus-visible { outline: 2px solid var(--ds-accent, oklch(0.72 0.16 300));
  outline-offset: 3px; }

.shg-meta { position: absolute; inset: auto 0 0 0; padding: var(--ds-6, 36px) var(--ds-4, 16px) var(--ds-3, 12px);
  background: linear-gradient(to top, oklch(0 0 0 / 0.78), oklch(0 0 0 / 0));
  color: oklch(0.98 0 0);
  transform: translateY(24%); opacity: 0;
  transition: transform var(--ds-base, 0.32s) var(--ds-ease-out, cubic-bezier(0.16, 1, 0.3, 1)),
              opacity var(--ds-base, 0.32s); }
.shg-card:hover .shg-meta, .shg-card:focus-visible .shg-meta { transform: none; opacity: 1; }
.shg-t { display: block; font-weight: 700; font-size: var(--ds-text-md, 1rem);
  letter-spacing: var(--ds-tracking-tight, -0.03em); }
.shg-g { font-family: var(--ds-font-mono, ui-monospace, monospace);
  font-size: var(--ds-text-xs, 0.72rem); opacity: 0.8; }

@media (prefers-reduced-motion: reduce) {
  .shg-card img, .shg-meta { transition: none; }
  .shg-meta { transform: none; opacity: 1; }
}

/* СОКЕТ ФОНА. Слой лежит на z-index -1 внутри своего stacking context: он рисуется
   поверх заливки секции, но под всем содержимым — поэтому контенту не нужно ни
   position, ни z-index, и вёрстка секции не меняется вовсе.
   Тон переопределяет ТОКЕНЫ, а не перечисляет классы: все дети и так читают
   --ds-fg/--ds-muted, значит пара фон+текст чинится в одном месте.
   Скрим обязателен: у живого фона яркость гуляет по кадру, и цвет текста, читаемый
   и на провале, и на вспышке, подобрать нельзя — контраст надо создавать. */
.shg { position: relative; isolation: isolate; }
.shg-bg { position: absolute; inset: 0; z-index: -1; }
.shg[data-slot-bg] { background: transparent; }
.shg-bg::after { content: ""; position: absolute; inset: 0; pointer-events: none; }
.shg[data-tone="dark"] { --ds-fg: oklch(0.96 0.01 265); --ds-muted: oklch(0.84 0.02 265);
  --ds-border: oklch(0.98 0.01 265 / 0.16); color: var(--ds-fg); }
.shg[data-tone="dark"] .shg-bg::after {
  background: oklch(0.09 0.02 265 / calc(var(--shg-scrim, 0.5) * 0.9)); }
.shg[data-tone="light"] { --ds-fg: oklch(0.2 0.02 265); --ds-muted: oklch(0.42 0.02 265);
  --ds-border: oklch(0.2 0.02 265 / 0.14); color: var(--ds-fg); }
.shg[data-tone="light"] .shg-bg::after {
  background: oklch(0.99 0 0 / calc(var(--shg-scrim, 0.5) * 0.9)); }
`;
import type { ReactNode } from "react";
export interface ShowcaseItem {
  /** Адрес картинки — свой или любой CDN. */
  src: string;
  title: string;
  tag?: string;
  /** Растянуть на две колонки. */
  wide?: boolean;
}

export interface ShowcaseGalleryProps {
  eyebrow?: string;
  title?: string;
  items?: ShowcaseItem[];
  /**
   * Сокет фона: любой эффект с `mount.role: "background"`, например `<AuroraField />`.
   * Занят — секция снимает собственную заливку, чтобы не спорить за слой.
   */
  background?: ReactNode;
  /** Какой текст читается поверх фона; приходит из `mount.tone` подставленной записи. */
  tone?: "dark" | "light";
  /** Плотность скрима между фоном и текстом; 0 — выключить. */
  scrim?: number;
}

/* Демо-работы записаны литералами, а не собираются хелпером: этот массив читает индексер
   (`extractListDemos`), и форма конструктора показывает по нему те же карточки, что видно
   в превью. Собранный из вызовов список данными не является — разобрать его нечем. */
const ITEMS: ShowcaseItem[] = [
  { src: "https://motiva.pages.dev/img/1016-900x675.jpg", title: "Nordwind", tag: "айдентика", wide: true },
  { src: "https://motiva.pages.dev/img/1043-900x675.jpg", title: "Kernel", tag: "сайт" },
  { src: "https://motiva.pages.dev/img/1057-900x675.jpg", title: "Luma", tag: "моушен" },
  { src: "https://motiva.pages.dev/img/1067-900x675.jpg", title: "Vertex", tag: "продукт", wide: true },
  { src: "https://motiva.pages.dev/img/1074-900x675.jpg", title: "Okapi", tag: "бренд" },
  { src: "https://motiva.pages.dev/img/1080-900x675.jpg", title: "Solaris", tag: "упаковка", wide: true },
];

/**
 * Витрина работ: сетка карточек, у которых по наведению приближается картинка и выезжает
 * подпись.
 *
 * Ключевое: увеличивается КАРТИНКА внутри неподвижной рамки, а не сама карточка. Соседи
 * не сдвигаются, сетка не пересчитывается, и весь ховер живёт на одном `transform` —
 * ни одного кадра с перерасчётом раскладки.
 *
 * Картинки грузятся лениво и с явными пропорциями у контейнера: место под них
 * зарезервировано заранее, поэтому при подгрузке ничего не прыгает (нулевой CLS).
 */
export function ShowcaseGallery({
  eyebrow = "работы",
  title = "Свежее из студии",
  items = ITEMS,
  background,
  tone,
  scrim = 0.5,
}: ShowcaseGalleryProps) {
  return (
    <section
      className="shg"
      data-slot-bg={background ? "" : undefined}
      data-tone={tone}
      style={{ textAlign: "start", ["--shg-scrim" as string]: scrim }}
    >
      <style href="motiva-showcase-gallery" precedence="medium">{css}</style>

      {background && <div className="shg-bg">{background}</div>}

      <div className="shg-in">
        {/* data-slot: адрес слота для inline-правки в конструкторе (/build) */}
        {eyebrow && <p className="shg-eyebrow" data-slot="eyebrow">{eyebrow}</p>}
        {title && <h2 className="shg-h" data-slot="title">{title}</h2>}

        <div className="shg-grid">
          {items.map((it, i) => (
            <a key={it.title} className="shg-card" data-wide={it.wide ? "1" : "0"} href="#">
              <img src={it.src} alt={it.title} loading="lazy" />
              <span className="shg-meta">
                {/* data-slot + data-idx + data-field: адрес поля карточки для inline-правки
                    в конструкторе. src живёт в атрибуте img — не размечается. */}
                <span className="shg-t" data-slot="items" data-idx={i} data-field="title">{it.title}</span>
                {it.tag && <span className="shg-g" data-slot="items" data-idx={i} data-field="tag">{it.tag}</span>}
              </span>
            </a>
          ))}
        </div>
      </div>
    </section>
  );
}
лицензия: MITавтор: Motivaисточник: оригинал (Motiva)v1.0.0