v0.9.9defuss-shadcn
Theme
Design your own

defuss-shadcn / Website / Landing Page / faq

Built with: CSS

FAQBLK

Frequently asked questions as icon cards - every answer visible, indexable, and screen-reader friendly.

On this page (6)
Component Skill — components/faq/component-skill.md

Native basis

Sectioning <article>s in a grid - headings + paragraphs, nothing interactive. If you need collapsing answers, that's the Accordion (<details name> exclusive), not this block.

Web Platform APIs

<article>CSS Gridtext-wrap: balance

Classes

.mk-faq.mk-faq-head.mk-faq-eyebrow.mk-faq-title.mk-faq-grid.mk-faq-item.mk-faq-icon.mk-faq-text.mk-faq-question.mk-faq-answer

§Default

Six items; 1 → 2 → 3 columns by container width.

§Accordion

data-variant='accordion': the head centered above an Accordion - <details name> keeps one answer open at a time, no script - and a contact band (.mk-faq-contact) below.

§Split

.mk-faq-split: the head and a contact band on the left - sticky while the questions scroll past on the right (from 52rem).

§Cards with search

data-variant='cards' on .mk-faq-grid: each pair on a bordered card; a search field (.mk-faq-search) and topic links (.mk-faq-topics) above.

§Numbered

data-variant='numbered' on .mk-faq-grid: a mono counter (01, 02…) from a CSS counter instead of the icon, with a rule on top of each pair.

§CSS view file

/* -- FAQ (marketing) -----------------------------------------------
   "Frequently asked questions" as an icon-card grid (each answer is
   visible - no disclosure widget). Cards hold a muted icon tile and a
   question/answer pair. Responsive columns follow container width. */
@layer components {
  .mk-faq {
    container: mk-faq / inline-size;
    display: flex;
    flex-direction: column;
    gap: 3rem;
    width: 100%;
    max-width: 80rem;
    margin-inline: auto;
    padding-inline: 1.25rem;
  }
  .mk-faq-head {
    display: flex;
    flex-direction: column;
    align-items: flex-start;
    gap: 0.75rem;
    width: 100%;
    max-width: 48rem;
    text-align: left;
  }
  .mk-faq-eyebrow {
    color: var(--primary);
    font-size: 1rem;
    font-weight: 500;
  }
  .mk-faq-title {
    line-height: 1.15;
    margin: 0;
    font-size: 1.875rem;
    font-weight: 500;
    letter-spacing: -0.025em;
    text-wrap: balance;
  }
  .mk-faq-grid {
    display: grid;
    gap: 3rem;
  }
  .mk-faq-item {
    display: flex;
    flex-direction: column;
    align-items: flex-start;
    gap: 1rem;
    max-width: 36rem;
    text-align: left;
  }
  .mk-faq-icon {
    display: flex;
    align-items: center;
    justify-content: center;
    width: 4rem;
    height: 4rem;
    flex-shrink: 0;
    border: 1px solid var(--border);
    border-radius: var(--radius-lg);
    background: var(--muted);
    & svg {
      width: 1.5rem;
      height: 1.5rem;
      color: var(--primary);
    }
  }
  .mk-faq-text {
    display: flex;
    flex-direction: column;
    gap: 0.25rem;
  }
  .mk-faq-question {
    line-height: 1.3;
    margin: 0;
    font-size: 1.25rem;
    font-weight: 500;
    letter-spacing: -0.025em;
    text-wrap: balance;
  }
  .mk-faq-answer {
    margin: 0;
    color: var(--muted-foreground);
    font-size: 1rem;
    text-wrap: pretty;
  }
  /* a link to the full answer (a detail page or a help article) */
  .mk-faq-link {
    display: inline-flex;
    align-items: center;
    gap: 0.25rem;
    margin-block-start: 0.5rem;
    color: var(--primary);
    font-size: 0.875rem;
    font-weight: 500;
    text-decoration: none;
    & svg {
      width: 0.875rem;
      height: 0.875rem;
      transition: translate 150ms ease;
    }
    &:hover {
      text-decoration: underline;
      text-underline-offset: 0.2em;
    }
    &:hover svg {
      translate: 0.125rem 0;
    }
    &:focus-visible {
      outline: 2px solid var(--ring);
      outline-offset: 2px;
      border-radius: var(--radius-sm);
    }
  }
  @container mk-faq (min-width: 30rem) {
    .mk-faq-title {
      font-size: 2.25rem;
    }
    .mk-faq-grid {
      grid-template-columns: 1fr 1fr;
      gap: 2.25rem 2.25rem;
      row-gap: 3rem;
    }
  }
  @container mk-faq (min-width: 52rem) {
    .mk-faq-grid {
      grid-template-columns: repeat(3, 1fr);
    }
  }
  /* -- variants ------------------------------------------------- */
  /* accordion: the head centered above an Accordion */
  .mk-faq[data-variant="accordion"] {
    align-items: center;
    & .mk-faq-head {
      align-items: center;
      text-align: center;
    }
  }
  .mk-faq-accordion {
    width: 100%;
    max-width: 48rem;
    margin-inline: auto;
  }
  .mk-faq-accordion .accordion-trigger {
    padding-block: 1.125rem;
    font-size: 1.0625rem;
  }
  .mk-faq-desc {
    margin: 0;
    color: var(--muted-foreground);
    font-size: 1rem;
    text-wrap: pretty;
  }
  /* split: the head (sticky) beside the questions */
  .mk-faq-split {
    display: grid;
    gap: 2rem 4rem;
  }
  .mk-faq-split > :first-child {
    display: flex;
    flex-direction: column;
    align-items: flex-start;
    gap: 1.25rem;
  }
  /* cards: each pair on a bordered card */
  .mk-faq-grid[data-variant="cards"] {
    gap: 1.25rem;
  }
  .mk-faq-grid[data-variant="cards"] .mk-faq-item {
    max-width: none;
    padding: 1.5rem;
    border: 1px solid var(--border);
    border-radius: var(--radius-xl);
    background: var(--card);
    & .mk-faq-question {
      font-size: 1.0625rem;
    }
  }
  /* numbered: a mono counter instead of the icon, a rule on top */
  .mk-faq-grid[data-variant="numbered"] {
    counter-reset: mk-faq;
    & .mk-faq-item {
      counter-increment: mk-faq;
      gap: 0.75rem;
      padding-block-start: 1.25rem;
      border-block-start: 1px solid var(--border);
    }
    & .mk-faq-item::before {
      content: counter(mk-faq, decimal-leading-zero);
      color: var(--primary);
      font-family: var(--font-mono);
      font-size: 0.875rem;
      font-weight: 600;
    }
  }
  /* search + topics above the questions */
  .mk-faq-search {
    position: relative;
    width: 100%;
    max-width: 32rem;
    & svg {
      position: absolute;
      inset-inline-start: 0.875rem;
      top: 50%;
      translate: 0 -50%;
      width: 1.125rem;
      height: 1.125rem;
      color: var(--muted-foreground);
      pointer-events: none;
    }
    & .input {
      height: 2.75rem;
      padding-inline-start: 2.5rem;
      font-size: 1rem;
    }
  }
  .mk-faq-topics {
    display: flex;
    flex-wrap: wrap;
    gap: 0.5rem;
    & a {
      padding: 0.375rem 0.875rem;
      border: 1px solid var(--border);
      border-radius: 999px;
      color: var(--muted-foreground);
      font-size: 0.875rem;
      font-weight: 500;
      text-decoration: none;
    }
    & a:hover {
      color: var(--foreground);
    }
    & a[aria-current] {
      border-color: var(--primary);
      background: color-mix(in oklch, var(--primary) 10%, transparent);
      color: var(--primary);
    }
    & a:focus-visible {
      outline: 2px solid var(--ring);
      outline-offset: 2px;
    }
  }
  /* contact: "still have questions" with the team and an action */
  .mk-faq-contact {
    display: flex;
    flex-wrap: wrap;
    align-items: center;
    gap: 1rem 1.25rem;
    width: 100%;
    max-width: 48rem;
    margin-inline: auto;
    padding: 1.25rem 1.5rem;
    border-radius: var(--radius-xl);
    background: var(--muted);
    & > div:nth-child(2) {
      flex: 1 1 14rem;
    }
    & strong {
      font-weight: 600;
    }
    & p {
      margin: 0.125rem 0 0;
      color: var(--muted-foreground);
      font-size: 0.875rem;
    }
  }
  .mk-faq-split .mk-faq-contact {
    margin: 0;
  }
  @container mk-faq (min-width: 52rem) {
    .mk-faq-split {
      grid-template-columns: minmax(0, 2fr) minmax(0, 3fr);
    }
    .mk-faq-split > :first-child {
      position: sticky;
      top: 1.5rem;
      align-self: start;
    }
  }
  /* -- Accessibility ------------------------------------------- */
  @media (forced-colors: active) {
    .mk-faq-grid[data-variant="cards"] .mk-faq-item {
      border-color: CanvasText;
    }
    .mk-faq-topics a[aria-current] {
      border-color: Highlight;
    }
  }
  @media (prefers-reduced-motion: reduce) {
    .mk-faq-link svg {
      transition: none;
    }
    .mk-faq-link:hover svg {
      translate: none;
    }
  }
  @media (forced-colors: active) {
    .mk-faq-icon {
      border-color: CanvasText;
    }
  }
}

Comments, ideas or improvements? Edit this page's source on GitHub