Skip to content

FAQ

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>

Installation

// package.json: "capsomer": "github:DrDustinEdwards/capsomer#v0.152.2"
import "capsomer/tokens.css";
import "capsomer/base.css";
import "capsomer/faq.css";

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

PropTypeRequiredDoes
itemsFaqItem[]Yes
variant"accordion" | "cards" | "list""accordion": one answer open at a time (no script). "cards": the same, each a card. "list": every answer shown.
namestringThe shared details name; the browser keeps one of a name open. Default "faq".
openFirstbooleanOpen the first question at first (accordion and cards).
headingLevel"h2" | "h3" | "h4"

CSS variables

VariableDefault
--cap-faq-facevar(--ui)
--cap-faq-gapvar(--space-3)
--cap-faq-measure48rem
--cap-faq-sizevar(--fs-body)

Parts and data attributes

ClassIs
.cap-faqthe root
.cap-faq-answera part
.cap-faq-questiona part
AttributeValues
data-variantaccordion cards list
StateRead from
[open]an attribute

Accessibility

KeyDoes
TabMoves from question to question
Enter, SpaceOpens 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.