FAQ Columns
Вопросы двумя колонками, все ответы на виду — для коротких ответов, где аккордеон только берёт лишний клик. Раскладка на columns, а не сетке: сетка выравнивает пары по строкам и оставляет дыры.
Редактируемые поля
Секция «faq». Весь контент приходит пропсами — ниже то, что конструктор даст поправить, не трогая код.
| Проп | Что это | Тип |
|---|---|---|
| eyebrow | Надпись сверху | text |
| title | Заголовок | text |
| sub | Описание | richtext |
| items | Вопросы | list · до 10 |
| contact | Ссылка «остался вопрос» | text |
Все пропсы
Разобрано из кода записи: обязательные — без «?», у остальных показано значение по умолчанию.
| Проп | Тип | По умолчанию | Что это |
|---|---|---|---|
| eyebrow? | string | "вопросы" | |
| title? | string | "Коротко о том, как мы работаем" | |
| sub? | string | — | |
| items? | FaqColumnsItem[] | ITEMS | |
| contact? | string | "Остался вопрос — напишите" | Ссылка «остались вопросы». |
| contactHref? | string | "#" | |
| background? | ReactNode | — | Сокет фона: любой эффект с `mount.role: "background"`, например `<AuroraField />`. Занят — секция снимает собственную заливку, чтобы не спорить за слой. |
FaqColumnsItem — что внутри
- q: string
- a: string
Установка
npx shadcn@latest add https://motiva.pages.dev/r/faq-columns.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.
Экспорт
Код
const css = `.fqc { 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); }
.fqc-in { max-width: var(--ds-container, 1120px); margin-inline: auto;
padding-inline: var(--ds-gutter, clamp(18px, 5vw, 54px)); }
.fqc-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)); }
.fqc-h { margin: 0; max-width: 24ch; font-size: var(--ds-text-xl, 2rem); font-weight: 750;
letter-spacing: var(--ds-tracking-tight, -0.03em); text-wrap: balance; }
.fqc-sub { margin: var(--ds-3, 12px) 0 0; max-width: 52ch;
font-size: var(--ds-text-md, 1rem); line-height: var(--ds-leading-body, 1.55);
color: var(--ds-muted, oklch(0.72 0.02 265)); }
/* колонки, а не сетка: сетка выравнивает пары по строкам и оставляет дыры */
.fqc-list { margin-top: var(--ds-7, 54px);
columns: 2; column-gap: var(--ds-7, 54px); }
@media (max-width: 720px) { .fqc-list { columns: 1; } }
.fqc-item { break-inside: avoid; margin: 0 0 var(--ds-5, 24px);
padding-top: var(--ds-4, 16px);
border-top: 1px solid var(--ds-border, oklch(0.3 0.02 275)); }
.fqc-q { margin: 0 0 var(--ds-2, 8px); font-size: var(--ds-text-md, 1rem);
font-weight: 650; letter-spacing: var(--ds-tracking-tight, -0.02em); }
.fqc-a { margin: 0; max-width: 46ch; font-size: var(--ds-text-sm, 0.9rem);
line-height: var(--ds-leading-body, 1.55); color: var(--ds-muted, oklch(0.72 0.02 265));
text-wrap: pretty; }
.fqc-more { display: inline-flex; align-items: center; gap: 6px;
margin-top: var(--ds-4, 16px); text-decoration: none;
font-size: var(--ds-text-sm, 0.9rem); font-weight: 600;
color: var(--ds-accent, oklch(0.72 0.16 300)); }
.fqc-more:hover { text-decoration: underline; }
.fqc-more:focus-visible { outline: 2px solid var(--ds-accent-ring, oklch(0.72 0.16 300 / 0.35));
outline-offset: 4px; border-radius: var(--ds-radius-sm, 8px); }
/* СОКЕТ ФОНА. Слой лежит на z-index -1 внутри своего stacking context: он рисуется
поверх заливки секции, но под всем содержимым — поэтому контенту не нужно ни
position, ни z-index, и вёрстка секции не меняется вовсе.
Тон переопределяет ТОКЕНЫ, а не перечисляет классы: все дети и так читают
--ds-fg/--ds-muted, значит пара фон+текст чинится в одном месте.
Скрим обязателен: у живого фона яркость гуляет по кадру, и цвет текста, читаемый
и на провале, и на вспышке, подобрать нельзя — контраст надо создавать. */
.fqc { position: relative; isolation: isolate; }
.fqc-bg { position: absolute; inset: 0; z-index: -1; }
.fqc[data-slot-bg] { background: transparent; }
.fqc-bg::after { content: ""; position: absolute; inset: 0; pointer-events: none; }
.fqc[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); }
.fqc[data-tone="dark"] .fqc-bg::after {
background: oklch(0.09 0.02 265 / calc(var(--fqc-scrim, 0.5) * 0.9)); }
.fqc[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); }
.fqc[data-tone="light"] .fqc-bg::after {
background: oklch(0.99 0 0 / calc(var(--fqc-scrim, 0.5) * 0.9)); }
`;
import type { ReactNode } from "react";
export interface FaqColumnsItem {
q: string;
a: string;
}
export interface FaqColumnsProps {
eyebrow?: string;
title?: string;
sub?: string;
items?: FaqColumnsItem[];
/** Ссылка «остались вопросы». */
contact?: string;
contactHref?: string;
/**
* Сокет фона: любой эффект с `mount.role: "background"`, например `<AuroraField />`.
* Занят — секция снимает собственную заливку, чтобы не спорить за слой.
*/
background?: ReactNode;
/** Какой текст читается поверх фона; приходит из `mount.tone` подставленной записи. */
tone?: "dark" | "light";
/** Плотность скрима между фоном и текстом; 0 — выключить. */
scrim?: number;
}
const ITEMS: FaqColumnsItem[] = [
{ q: "Сколько занимает проект?", a: "Лендинг — 2–3 недели, сайт — 4–6. Срок фиксируем в договоре вместе с объёмом." },
{ q: "Как устроена оплата?", a: "40% на старте, 30% после утверждения дизайна, 30% на релизе." },
{ q: "Кто пишет тексты?", a: "По умолчанию вы, мы даём структуру и объёмы. Можем взять на себя отдельной строкой." },
{ q: "Что с поддержкой?", a: "Месяц входит в стоимость: правки контента и мелкие доработки. Дальше по часам." },
{ q: "Отдаёте исходники?", a: "Да, всё: репозиторий, макеты, дизайн-систему. Вендор-лока нет." },
{ q: "Работаете по договору?", a: "Да, с актами и закрывающими. С самозанятыми и юрлицами одинаково." },
];
/**
* Вопросы двумя колонками, все ответы на виду — вариант `faq-accordion` для коротких
* ответов.
*
* И это не про вкус, а про решение, которое стоит принимать осознанно. Аккордеон
* оправдан, когда ответы длинные и список нужно окинуть взглядом целиком. Если ответ
* помещается в две строки, аккордеон только вредит: он берёт клик за то, что и так
* поместилось на экран, ломает поиск по странице глазами и заставляет открывать пункты
* по очереди, чтобы понять, есть ли там нужное. Здесь ответы короткие — значит, открыты.
*
* Раскладка — `columns`, а не сетка. Разница существенная: сетка выравнивает пары по
* строкам, и рядом с коротким ответом появляется дыра во всю высоту длинного. Колонки
* пакуют пункты подряд, поэтому пустот не остаётся. `break-inside: avoid` не даёт
* разорвать вопрос и ответ между колонками — без него это первое, что ломается.
*/
export function FaqColumns({
eyebrow = "вопросы",
title = "Коротко о том, как мы работаем",
sub,
items = ITEMS,
contact = "Остался вопрос — напишите",
contactHref = "#",
background,
tone,
scrim = 0.5,
}: FaqColumnsProps) {
return (
<section
className="fqc"
data-slot-bg={background ? "" : undefined}
data-tone={tone}
style={{ textAlign: "start", ["--fqc-scrim" as string]: scrim }}
>
<style href="motiva-faq-columns" precedence="medium">{css}</style>
{background && <div className="fqc-bg">{background}</div>}
<div className="fqc-in">
{/* data-slot: адрес слота для inline-правки в конструкторе (/build) */}
{eyebrow && <p className="fqc-eyebrow" data-slot="eyebrow">{eyebrow}</p>}
{title && <h2 className="fqc-h" data-slot="title">{title}</h2>}
{sub && <p className="fqc-sub" data-slot="sub">{sub}</p>}
<div className="fqc-list">
{items.map((it, i) => (
<div key={it.q} className="fqc-item">
{/* data-slot + data-idx + data-field: адрес поля пункта для inline-правки
в конструкторе (/build). */}
<h3 className="fqc-q" data-slot="items" data-idx={i} data-field="q">{it.q}</h3>
<p className="fqc-a" data-slot="items" data-idx={i} data-field="a">{it.a}</p>
</div>
))}
</div>
{contact && (
<a className="fqc-more" href={contactHref}>
{contact} <span aria-hidden>→</span>
</a>
)}
</div>
</section>
);
}