Questions and answers as an accordion that keeps one open, as cards, or as a full list.
<ul class="cap-faq" id="faq-accordion">
<li><details class="cap-disclosure" data-variant="accordion" name="faq-a" open><summary><h3 class="cap-faq-question">How long does an edit take?</h3></summary><div class="cap-disclosure-body"><div class="cap-faq-answer"><p>Five business days for most manuscripts.</p></div></div></details></li>
<li><details class="cap-disclosure" data-variant="accordion" name="faq-a"><summary><h3 class="cap-faq-question">Can I ask for a second read?</h3></summary><div class="cap-disclosure-body"><div class="cap-faq-answer"><p>Yes. Sam Lee reads it again within two days.</p></div></div></details></li>
<li><details class="cap-disclosure" data-variant="accordion" name="faq-a"><summary><h3 class="cap-faq-question">Do you keep my files?</h3></summary><div class="cap-disclosure-body"><div class="cap-faq-answer"><p>For 30 days, then they are deleted.</p></div></div></details></li>
</ul>
import "capsomer/tokens.css";
import "capsomer/faq.css";
import { Faq } from "capsomer/react/faq";
Usage
<ul class="cap-faq"> <!-- data-variant="cards" | "list" -->
<li>
<details class="cap-disclosure" data-variant="accordion" name="faq">
<summary><h3 class="cap-faq-question">How long does an edit take?</h3></summary>
<div class="cap-disclosure-body"><div class="cap-faq-answer"><p>Five business days.</p></div></div>
</details>
</li>
</ul>
<ul class="cap-faq" data-variant="list">
<li><h3 class="cap-faq-question">Is there a minimum?</h3><div class="cap-faq-answer"><p>No.</p></div></li>
</ul>
Examples
Cards
<ul class="cap-faq" data-variant="cards" id="faq-cards">
<li><details class="cap-disclosure" data-variant="card" name="faq-c"><summary><h3 class="cap-faq-question">Is there a free plan?</h3></summary><div class="cap-disclosure-body"><div class="cap-faq-answer"><p>The checks are free on one site.</p></div></div></details></li>
<li><details class="cap-disclosure" data-variant="card" name="faq-c"><summary><h3 class="cap-faq-question">Can I cancel?</h3></summary><div class="cap-disclosure-body"><div class="cap-faq-answer"><p>Any time, from Settings.</p></div></div></details></li>
</ul>
List, every answer shown
<ul class="cap-faq" data-variant="list" id="faq-list">
<li><h3 class="cap-faq-question">Is there a minimum?</h3><div class="cap-faq-answer"><p>No. A one-page letter is fine.</p></div></li>
<li><h3 class="cap-faq-question">How do I pay?</h3><div class="cap-faq-answer"><p>By card when you send the file.</p></div></li>
</ul>
API reference
Faq
Prop
Type
Required
Does
items
FaqItem[]
Yes
variant
"accordion" | "cards" | "list"
"accordion": one answer open at a time (no script). "cards": the same, each a card. "list": every answer shown.
name
string
The shared details name; the browser keeps one of a name open. Default "faq".
openFirst
boolean
Open the first question at first (accordion and cards).
headingLevel
"h2" | "h3" | "h4"
CSS variables
Variable
Default
--cap-faq-face
var(--ui)
--cap-faq-gap
var(--space-3)
--cap-faq-measure
48rem
--cap-faq-size
var(--fs-body)
Parts and data attributes
Class
Is
.cap-faq
the root
.cap-faq-answer
a part
.cap-faq-question
a part
Attribute
Values
data-variant
accordioncardslist
State
Read from
[open]
an attribute
Accessibility
Key
Does
Tab
Moves from question to question
Enter, Space
Opens or closes the question; opening one closes the one open
Native details and summary: the browser gives the expanded state.
Question --text, answer --muted: in the contrast report.