Reveal FAQ
FAQ
Section title on the left, accordion on the right, answers that fade in, and an optional image that appears beside the list for the open item.
실제로 돌아가는 부품입니다. 눌러 보고 입력해 보세요.
내 앱에 넣기
아직 npm 패키지가 없어서 Taster 리포를 받아 그 안의 명령을 씁니다. 내 앱 폴더가 들어 있는 폴더에서 한 번만 받습니다.
git clone https://github.com/makim-414/taster.git && npm ci --prefix taster/packages/engine내 앱 폴더에서 이 부품을 넣습니다. 부품 파일과 토큰 파일이
src/components/taster에 들어갑니다.node ../taster/packages/engine/cli.mjs add marketing/reveal-faq --from https://taster-six.vercel.app --dir src/components/taster부품은 Tailwind 클래스로 그리고, Taster 프리셋이 그 클래스를 토큰에 연결합니다. Tailwind CSS 를 설치하고,
tokens.css를 앱 루트에서 한 번 불러온 뒤, 앱 루트에 이 설정을 둡니다. 프리셋이 없으면 빌드는 되어도 부품이 스타일 없이 나옵니다.// tailwind.config.cjs module.exports = { presets: [require('./src/components/taster/tailwind-preset.cjs')], content: ['./index.html', './src/**/*.{ts,tsx}'], };Tailwind v3 는 이 파일을 그대로 읽습니다. v4 는 Tailwind 를 불러오는
src/의 스타일시트 맨 위에 이 두 줄을 넣습니다.@import "tailwindcss"; @config "../tailwind.config.cjs";tokens.css는:root에--bg,--text,--border,--accent를 정의합니다. 내 앱의 스타일시트가 같은 이름을 뒤에서 다시 정의하면 그쪽 색이 이깁니다. 새 Vite 앱의 스타터 CSS 처럼 그런 변수가 있으면 지우거나 이름을 바꾸세요.
언제 쓰나요
- Split title FAQSection title on the left, accordion on the right, answers that fade in, and an optional image that appears beside the list for the open item.
대신 없애 주는 AI 티
- Whole sentence as a giant headline (TYP-04)
정보
코드 보기
import * as React from 'react'
import { cn } from '../blocks/_cn'
import { useStyleOnce } from '../motion/_motion'
// Reveal FAQ: the heading and a help line on the left, a one-open accordion on the right. Answers
// fade in when they open; set reveal="letters" for the original letter-by-letter blur.
// Source: the layout and the letter reveal follow "text-reveal-faqs" by Ruixen on 21st.dev
// (https://21st.dev/@ruixen.ui/components/text-reveal-faqs). That listing states no license, so no
// code was taken from it: this is an independent implementation, first written for a template
// marketplace landing. Native <details name> gives the one-open accordion with no library, and a
// CSS animation with a per-letter delay replays on every open.
// The fade is the default because patterns/split-title-faq advises against a letter reveal on every
// open; the letter mode stays for a single, short FAQ where the effect is the point. Letters are grouped
// by word so Korean lines break between words. Both modes are switched off under reduced motion.
const CSS =
'.dsg-faq summary::-webkit-details-marker{display:none}' +
'.dsg-faq details[open] .dsg-faq-chev{transform:rotate(180deg)}' +
'.dsg-faq details[open] .dsg-faq-ch{animation:dsg-faq-in 300ms var(--ease-out) both;animation-delay:calc(var(--i) * 15ms)}' +
'.dsg-faq details[open] .dsg-faq-fade{animation:dsg-faq-fade var(--dur-dropdown) var(--ease-out) both}' +
'@keyframes dsg-faq-in{from{opacity:0;filter:blur(calc(var(--blur-mask) * 5))}to{opacity:1;filter:blur(0)}}' +
'@keyframes dsg-faq-fade{from{opacity:0}to{opacity:1}}' +
'@media (prefers-reduced-motion: reduce){.dsg-faq details[open] .dsg-faq-ch,.dsg-faq details[open] .dsg-faq-fade{animation:none}}'
export interface FaqItem {
q: string
a: string
}
export interface RevealFaqProps extends Omit<React.HTMLAttributes<HTMLElement>, 'title'> {
title: string
sub?: string
/** A line with a contact link, shown under the heading on wide screens and under the list on narrow ones. */
help?: React.ReactNode
items: FaqItem[]
/** How an answer appears when it opens. */
reveal?: 'fade' | 'letters'
}
function Answer({ text, reveal }: { text: string; reveal: 'fade' | 'letters' }) {
if (reveal === 'fade') return <p className="dsg-faq-fade m-0 pb-4 text-body text-text-muted [word-break:keep-all]">{text}</p>
let n = 0
const words = text.split(' ')
return (
<p className="m-0 pb-4 text-body text-text-muted">
<span className="sr-only">{text}</span>
{words.map((word, w) => (
<span key={w} className="inline-block whitespace-pre" aria-hidden>
{[...word].map((ch) => (
<span key={n} className="dsg-faq-ch inline-block" style={{ ['--i' as string]: n++ }}>
{ch}
</span>
))}
{w < words.length - 1 ? ' ' : null}
</span>
))}
</p>
)
}
export function RevealFaq({ title, sub, help, items, reveal = 'fade', id, className, ...props }: RevealFaqProps) {
useStyleOnce('dsg-faq-css', CSS)
const reactId = React.useId()
const group = `faq-${id ?? reactId.replace(/:/g, '')}`
return (
<section id={id} className={cn('dsg-faq', className)} {...props}>
<div className="grid gap-8 md:grid-cols-[2fr_3fr] md:gap-12">
<div className="grid content-start gap-3 md:sticky md:top-12 md:self-start md:gap-6">
<h2 className="m-0 text-h1 font-semibold text-text [word-break:keep-all]">{title}</h2>
{sub ? <p className="m-0 text-title text-text-muted [word-break:keep-all]">{sub}</p> : null}
{help ? <p className="m-0 hidden text-sm text-text-muted md:block [word-break:keep-all]">{help}</p> : null}
</div>
<div>
{items.map((item) => (
<details key={item.q} name={group} className="border-b border-border">
<summary className="flex cursor-pointer list-none items-center justify-between gap-3 rounded-sm py-4 text-title font-medium text-text outline-none focus-visible:ring-2 focus-visible:ring-ring">
<span>{item.q}</span>
<svg className="dsg-faq-chev shrink-0 text-text-muted transition-transform duration-dropdown ease-out" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" aria-hidden>
<path d="m6 9 6 6 6-6" />
</svg>
</summary>
<Answer text={item.a} reveal={reveal} />
</details>
))}
</div>
{help ? <p className="m-0 text-sm text-text-muted md:hidden [word-break:keep-all]">{help}</p> : null}
</div>
</section>
)
}