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 в корне — с алиасами в форме"components": "@/components". Нет файла — CLI не поймёт, куда класть.
  2. Алиас @ объявлен дважды: "paths": {"@/*": ["./src/*"]} в корневом tsconfig.json (в Vite он часто содержит только references — тогда CLI создаёт папку@) и resolve.alias в конфиге сборщика.
  3. Токены подключены один раз на приложение:import "@/styles/motiva-tokens.css" — они приезжают вместе с записью. Без них секция потеряет цвета, ритм и тему.
  4. Своя типографика не должна спорить: если у вас на обёрткеtext-align: center, он протечёт внутрь блоков.
  5. Проект без TypeScript? Всё равно нужен минимальныйtsconfig.json с pathsи "tsx": true в components.json: CLI грузит tsconfig безусловно, а с "tsx": false идёт за jsconfig.json и падает так же. Приехавший рядом.tsx можно не трогать — вам нужен.vanilla.js.

Экспорт

↓ Скачать .zip

Код

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.5»); 0 — выключить. */
  scrim?: number;
}

const p = (id: number) => `https://motiva.pages.dev/img/${id}-900x675.jpg`;

const ITEMS: ShowcaseItem[] = [
  { src: p(1016), title: "Nordwind", tag: "айдентика", wide: true },
  { src: p(1043), title: "Kernel", tag: "сайт" },
  { src: p(1057), title: "Luma", tag: "моушен" },
  { src: p(1067), title: "Vertex", tag: "продукт", wide: true },
  { src: p(1074), title: "Okapi", tag: "бренд" },
  { src: p(1080), 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>{`
        .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)); }
      `}</style>

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

      <div className="shg-in">
        {eyebrow && <p className="shg-eyebrow">{eyebrow}</p>}
        <h2 className="shg-h">{title}</h2>

        <div className="shg-grid">
          {items.map((it) => (
            <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">
                <span className="shg-t">{it.title}</span>
                {it.tag && <span className="shg-g">{it.tag}</span>}
              </span>
            </a>
          ))}
        </div>
      </div>
    </section>
  );
}
лицензия: MITавтор: Motivaисточник: оригинал (Motiva)v1.0.0