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

Video Chapters

Ролик с главами — вариант video-facade для видео длиннее минуты: клик по главе перематывает и играет, досматривать целиком не обязательно. Активная глава подсвечивается по времени ролика (timeupdate), а не по последнему клику — ролик едет дальше, подсветка идёт за ним, как караоке. Контролы нативные: свои крутилки поверх — минус доступность.

cssclickbasic~1 КБreduced-motion ✓
↗

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

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

ПропЧто этоТип
eyebrowНадпись сверхуtext
titleЗаголовокtext
subПодзаголовокtext
chaptersГлавыlist · до 6

Все пропсы

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

ПропТипПо умолчаниюЧто это
eyebrow?string"экскурсия"
title?string"Продукт за пятнадцать секунд"
sub?string"Кликните главу — ролик перемотается. До…
poster?string"https://motiva.pages.dev/video/mesh-128…
chapters?VideoChapter[]CHAPTERS
background?ReactNode—Сокет фона: любой эффект с `mount.role: "background"`, например `<AuroraField />`. Занят — секция снимает собственную заливку, чтобы не спорить за слой.
VideoChapter — что внутри
  • at: string— Начало главы (формат «0:12»).
  • title: string
  • note?: string

Установка

npx shadcn@latest add https://motiva.pages.dev/r/video-chapters.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

Код

"use client";

import { useEffect, useRef, useState } from "react";
import type { ReactNode } from "react";
const css = `.vch { position: relative; isolation: isolate; 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); }
.vch-in { max-width: var(--ds-container, 1120px); margin-inline: auto;
  padding-inline: var(--ds-gutter, clamp(18px, 5vw, 54px)); }
.vch-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)); }
.vch-h { margin: 0; font-size: var(--ds-text-xl, 2rem); font-weight: 750;
  letter-spacing: var(--ds-tracking-tight, -0.03em); }
.vch-sub { margin: var(--ds-2, 10px) 0 0; max-width: 56ch;
  font-size: var(--ds-text-sm, 0.92rem); line-height: var(--ds-leading-body, 1.55);
  color: var(--ds-muted, oklch(0.72 0.02 265)); }

.vch-grid { display: grid; gap: clamp(20px, 3.5vw, 44px); margin-top: var(--ds-6, 36px);
  grid-template-columns: minmax(0, 7fr) minmax(0, 5fr); align-items: start; }
@media (max-width: 760px) { .vch-grid { grid-template-columns: minmax(0, 1fr); } }

.vch-frame { position: relative; border-radius: var(--ds-radius-lg, 20px); overflow: hidden;
  background: oklch(0.1 0.015 270); }
.vch-frame video { display: block; width: 100%; aspect-ratio: 16 / 9; object-fit: cover; }

.vch-list { margin: 0; padding: 0; list-style: none;
  display: grid; gap: var(--ds-2, 10px); }
.vch-chap { display: grid; grid-template-columns: auto 1fr; align-items: baseline;
  gap: 4px 14px; width: 100%; padding: 12px 16px; text-align: start;
  border: 1px solid var(--ds-border, oklch(0.3 0.02 275));
  border-radius: var(--ds-radius, 14px); cursor: pointer;
  background: var(--ds-surface, oklch(0.17 0.02 273));
  color: inherit; font: inherit;
  transition: border-color var(--ds-fast, 0.18s); }
.vch-chap:hover { border-color: var(--ds-accent, oklch(0.72 0.16 300)); }
.vch-chap:focus-visible { outline: 2px solid var(--ds-accent, oklch(0.72 0.16 300)); outline-offset: 2px; }
/* активная глава — по времени ролика, не по последнему клику: ролик сам едет дальше */
.vch-chap[data-active] { border-color: var(--ds-accent, oklch(0.72 0.16 300));
  background: color-mix(in oklab, var(--ds-accent, oklch(0.72 0.16 300)) 10%, var(--ds-surface, oklch(0.17 0.02 273))); }
.vch-time { font-family: var(--ds-font-mono, ui-monospace, monospace);
  font-size: var(--ds-text-xs, 0.74rem);
  color: var(--ds-accent, oklch(0.72 0.16 300)); }
.vch-name { font-size: var(--ds-text-sm, 0.94rem); font-weight: 640;
  letter-spacing: var(--ds-tracking-tight, -0.02em); }
.vch-note { grid-column: 2; margin: 0;
  font-size: var(--ds-text-xs, 0.8rem); line-height: 1.45;
  color: var(--ds-muted, oklch(0.72 0.02 265)); }

@media (prefers-reduced-motion: reduce) { .vch-chap { transition: none; } }

/* СОКЕТ ФОНА — контракт как у остальных секций */
.vch-bg { position: absolute; inset: 0; z-index: -1; }
.vch[data-slot-bg] { background: transparent; }
.vch-bg::after { content: ""; position: absolute; inset: 0; pointer-events: none; }
.vch[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); }
.vch[data-tone="dark"] .vch-bg::after {
  background: oklch(0.09 0.02 265 / calc(var(--vch-scrim, 0.5) * 0.9)); }
.vch[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); }
.vch[data-tone="light"] .vch-bg::after {
  background: oklch(0.99 0 0 / calc(var(--vch-scrim, 0.5) * 0.9)); }
`;

export interface VideoChapter {
  /** Начало главы (формат «0:12»). */
  at: string;
  title: string;
  note?: string;
}

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

const CHAPTERS: VideoChapter[] = [
  { at: "0:00", title: "Первый запуск", note: "Что видно сразу после установки" },
  { at: "0:04", title: "Живая сетка", note: "Данные приезжают потоком, без кнопки «обновить»" },
  { at: "0:09", title: "Тёмная тема", note: "Одно число меняет всю палитру" },
  { at: "0:13", title: "Экспорт", note: "Отчёт заказчику одной ссылкой" },
];

/** «м:сс» → секунды; ошибка формата честно даёт 0, а не NaN-перемотку. */
const toSec = (t: string) => {
  const m = /^(\d+):([0-5]?\d)$/.exec(t.trim());
  return m ? Number(m[1]) * 60 + Number(m[2]) : 0;
};

/**
 * Ролик с ГЛАВАМИ — вариант `video-facade` для случая, когда видео длиннее минуты
 * и смотреть его целиком никто не обязан: клик по главе перематывает и играет.
 *
 * Активная глава подсвечивается ПО ВРЕМЕНИ РОЛИКА (`timeupdate`), а не по
 * последнему клику: ролик едет дальше — подсветка идёт за ним, как караоке.
 * Управление — нативные контролы `<video>`: свои крутилки перемотки поверх
 * нативных — это минус доступность, а не плюс дизайну.
 */
export function VideoChapters({
  eyebrow = "экскурсия",
  title = "Продукт за пятнадцать секунд",
  sub = "Кликните главу — ролик перемотается. Досматривать целиком не обязательно.",
  src = "https://motiva.pages.dev/video/mesh-1280x720.mp4",
  poster = "https://motiva.pages.dev/video/mesh-1280x720-poster.jpg",
  chapters = CHAPTERS,
  background,
  tone,
  scrim = 0.5,
}: VideoChaptersProps) {
  const video = useRef<HTMLVideoElement>(null);
  const [active, setActive] = useState(0);

  useEffect(() => {
    const v = video.current;
    if (!v) return;
    const marks = chapters.map((c) => toSec(c.at));
    const onTime = () => {
      let i = 0;
      for (let k = 0; k < marks.length; k++) if (v.currentTime >= marks[k]! - 0.2) i = k;
      setActive(i);
    };
    v.addEventListener("timeupdate", onTime);
    return () => v.removeEventListener("timeupdate", onTime);
  }, [chapters.map((c) => c.at).join("|")]);

  const jump = (i: number) => {
    const v = video.current;
    if (!v) return;
    v.currentTime = toSec(chapters[i]!.at);
    setActive(i);
    v.play().catch(() => {});
  };

  return (
    <section
      className="vch"
      data-slot-bg={background ? "" : undefined}
      data-tone={tone}
      style={{ textAlign: "start", ["--vch-scrim" as string]: scrim }}
    >
      <style href="motiva-video-chapters" precedence="medium">{css}</style>

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

      <div className="vch-in">
        {eyebrow && <p className="vch-eyebrow" data-slot="eyebrow">{eyebrow}</p>}
        {title && <h2 className="vch-h" data-slot="title">{title}</h2>}
        {sub && <p className="vch-sub" data-slot="sub">{sub}</p>}

        <div className="vch-grid">
          <div className="vch-frame">
            <video ref={video} src={src} poster={poster} controls preload="metadata" playsInline muted />
          </div>

          <ol className="vch-list">
            {chapters.map((c, i) => (
              <li key={c.title}>
                <button
                  type="button"
                  className="vch-chap"
                  data-active={active === i ? "" : undefined}
                  onClick={() => jump(i)}
                >
                  <span className="vch-time" data-slot="chapters" data-idx={i} data-field="at">{c.at}</span>
                  <span className="vch-name" data-slot="chapters" data-idx={i} data-field="title">{c.title}</span>
                  {c.note && <p className="vch-note" data-slot="chapters" data-idx={i} data-field="note">{c.note}</p>}
                </button>
              </li>
            ))}
          </ol>
        </div>
      </div>
    </section>
  );
}
лицензия: MITавтор: Motivaисточник: оригинал (Motiva)v1.0.0