Video Chapters
Ролик с главами — вариант video-facade для видео длиннее минуты: клик по главе перематывает и играет, досматривать целиком не обязательно. Активная глава подсвечивается по времени ролика (timeupdate), а не по последнему клику — ролик едет дальше, подсветка идёт за ним, как караоке. Контролы нативные: свои крутилки поверх — минус доступность.
Редактируемые поля
Секция «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Что нужно в проекте до установки
Файл
components.jsonв корнеИз него CLI узнаёт, куда класть файлы. Алиасы — в такой форме:
"aliases": { "components": "@/components", "lib": "@/lib" }Нет файла — установка не начнётся вовсе.
Алиас
@объявлен дваждыВ корневом
tsconfig.jsonи в конфиге сборщика. В Vite корневой tsconfig часто содержит толькоreferences— этого мало."paths": { "@/*": ["./src/*"] } // tsconfig.json resolve.alias = { "@": "/src" } // vite.config.tsБез
pathsCLI молча создаёт папку с именем@.Токены подключены один раз на приложение
Они приезжают вместе с записью — достаточно импортировать их в точке входа:
import "@/styles/motiva-tokens.css";Без них блок потеряет цвета, ритм и тему.
Своя типографика не спорит с блоком
Наследуемые свойства протекают внутрь:
text-align: centerна обёртке отцентрует содержимое секции. То же касаетсяfont-familyиline-height.Проект без TypeScript? всё равно нужен tsconfig
CLI грузит
tsconfig.jsonбезусловно, а при"tsx": falseидёт заjsconfig.jsonи падает так же. Минимум — файл сpathsи"tsx": trueвcomponents.json.Приехавший рядом
.tsxможно не трогать — вам нужен.vanilla.js.
Экспорт
Код
"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>
);
}