Skip to main content

Components

Citations

One quiet marker per fact. It opens a list of every source for that fact, with links. No footnote numbers.

How it works

A .cite sits right after the fact it supports. It shows a small quote mark, plus a count when more than one source backs the fact. The marker is a <button popovertarget>. The list of sources is a native popover next to it. One marker covers any number of sources, so a fact backed by three sources gets one mark, not [1][2][3].

  • Baseline: Popover API (Chrome 114, Safari 17, Firefox 125). Click, tap or press Enter to open. Escape or a click outside closes it. The browser reports the button's expanded state to assistive tech.
  • Enhancement: anchor positioning opens the list just under the marker and flips it when there is no room. Without it, the list opens centred on screen.
  • Phones: under 576px wide the list is a bottom sheet with large touch targets. It never opens off-screen.
  • Fallback: without the Popover API, the marker hides and the source names show inline in small text, like (Cagematch; Wikipedia). Print does the same and adds each URL.
Everything is a <span>. A citation can go anywhere phrasing content can: headings, paragraphs, table cells, <dd>, list items. Do not put one inside a link. Each popover id must be unique on the page.

Example

A single source shows only the glyph. Two or more show the count.

The Armory holds 4,200 for wrestling1 sourceThe Armory — venue factsRetrieved Oct 3, 2026Archived copy and first ran a show in 19983 sourcesProfightdbRetrieved Oct 3, 2026Archived copyWrestling Inc.Retrieved Sep 28, 2026Archived copyThe Armory — historyRetrieved Sep 12, 2026All sources on this page.

HTML
<p>
  The Armory holds 4,200 for wrestling<span class="cite"><button type="button" class="cite-marker" popovertarget="cite-demo-1" aria-label="1 source"><span class="cite-count" aria-hidden="true"></span></button><span class="cite-popover" popover id="cite-demo-1" role="dialog" aria-labelledby="cite-demo-1-title"><span class="cite-header"><span class="cite-title" id="cite-demo-1-title">1 source</span><button type="button" class="btn-close" popovertarget="cite-demo-1" popovertargetaction="hide" aria-label="Close"></button></span><span class="cite-list" role="list"><span class="cite-item" role="listitem"><a class="cite-source" href="#!">The Armory — venue facts</a><span class="cite-meta"><span>Retrieved Oct 3, 2026</span><a href="#!">Archived copy</a></span></span></span></span></span>
  and first ran a show in 1998<span class="cite"><button type="button" class="cite-marker" popovertarget="cite-demo-2" aria-label="3 sources"><span class="cite-count" aria-hidden="true">3</span></button><span class="cite-popover" popover id="cite-demo-2" role="dialog" aria-labelledby="cite-demo-2-title"><span class="cite-header"><span class="cite-title" id="cite-demo-2-title">3 sources</span><button type="button" class="btn-close" popovertarget="cite-demo-2" popovertargetaction="hide" aria-label="Close"></button></span><span class="cite-list" role="list"><span class="cite-item" role="listitem"><a class="cite-source" href="#!">Profightdb</a><span class="cite-meta"><span>Retrieved Oct 3, 2026</span><a href="#!">Archived copy</a></span></span><span class="cite-item" role="listitem"><a class="cite-source" href="#!">Wrestling Inc.</a><span class="cite-meta"><span>Retrieved Sep 28, 2026</span><a href="#!">Archived copy</a></span></span><span class="cite-item" role="listitem"><a class="cite-source" href="#!">The Armory — history</a><span class="cite-meta"><span>Retrieved Sep 12, 2026</span></span></span></span><span class="cite-footer"><a href="#!">All sources on this page</a></span></span></span>.
</p>

Markup

<span class="cite">
  <button type="button" class="cite-marker" popovertarget="cite-7" aria-label="2 sources">
    <span class="cite-count" aria-hidden="true">2</span>   <!-- leave empty for one source -->
  </button>
  <span class="cite-popover" popover id="cite-7" role="dialog" aria-labelledby="cite-7-title">
    <span class="cite-header">
      <span class="cite-title" id="cite-7-title">2 sources</span>
      <button type="button" class="btn-close" popovertarget="cite-7" popovertargetaction="hide" aria-label="Close"></button>
    </span>
    <span class="cite-list" role="list">
      <span class="cite-item" role="listitem">
        <a class="cite-source" href="https://…" rel="nofollow noopener" target="_blank">Profightdb</a>
        <span class="cite-meta"><span>Retrieved Oct 3, 2026</span><a href="/sources/12/">Archived copy</a></span>
      </span>
      <span class="cite-item" role="listitem">…</span>
    </span>
    <span class="cite-footer"><a href="#sources">All sources on this page</a></span>  <!-- optional -->
  </span>
</span>

Put the .cite directly after the fact, with no space in between, so it never wraps onto a line of its own. .cite-meta takes any number of children, separated by middle dots.

In context

Headings

The marker and the list reset the heading's display font, size, caps and gold ramp.

Kenny Omega2 sourcesallelitewrestling.com — rosterRetrieved Oct 29, 2026ProfightdbRetrieved Oct 20, 2026

Gold ramp title1 sourcewwe.com — titles

HTML
<h1 class="display-5 text-marquee">Kenny Omega<span class="cite"><button type="button" class="cite-marker" popovertarget="cite-demo-h" aria-label="2 sources"><span class="cite-count" aria-hidden="true">2</span></button><span class="cite-popover" popover id="cite-demo-h" role="dialog" aria-labelledby="cite-demo-h-title"><span class="cite-header"><span class="cite-title" id="cite-demo-h-title">2 sources</span><button type="button" class="btn-close" popovertarget="cite-demo-h" popovertargetaction="hide" aria-label="Close"></button></span><span class="cite-list" role="list"><span class="cite-item" role="listitem"><a class="cite-source" href="#!">allelitewrestling.com — roster</a><span class="cite-meta"><span>Retrieved Oct 29, 2026</span></span></span><span class="cite-item" role="listitem"><a class="cite-source" href="#!">Profightdb</a><span class="cite-meta"><span>Retrieved Oct 20, 2026</span></span></span></span></span></span></h1>
<p class="h3 text-gold-ramp">Gold ramp title<span class="cite"><button type="button" class="cite-marker" popovertarget="cite-demo-g" aria-label="1 source"><span class="cite-count" aria-hidden="true"></span></button><span class="cite-popover" popover id="cite-demo-g" role="dialog" aria-labelledby="cite-demo-g-title"><span class="cite-header"><span class="cite-title" id="cite-demo-g-title">1 source</span><button type="button" class="btn-close" popovertarget="cite-demo-g" popovertargetaction="hide" aria-label="Close"></button></span><span class="cite-list" role="list"><span class="cite-item" role="listitem"><a class="cite-source" href="#!">wwe.com — titles</a></span></span></span></span></p>

Definition lists

Billed from
Winnipeg, Manitoba2 sourcesallelitewrestling.comProfightdb
Billed height
6 ft 0 in1 sourceallelitewrestling.com
HTML
<dl class="row small mb-0">
  <dt class="col-sm-3">Billed from</dt>
  <dd class="col-sm-9">Winnipeg, Manitoba<span class="cite"><button type="button" class="cite-marker" popovertarget="cite-demo-d1" aria-label="2 sources"><span class="cite-count" aria-hidden="true">2</span></button><span class="cite-popover" popover id="cite-demo-d1" role="dialog" aria-labelledby="cite-demo-d1-title"><span class="cite-header"><span class="cite-title" id="cite-demo-d1-title">2 sources</span><button type="button" class="btn-close" popovertarget="cite-demo-d1" popovertargetaction="hide" aria-label="Close"></button></span><span class="cite-list" role="list"><span class="cite-item" role="listitem"><a class="cite-source" href="#!">allelitewrestling.com</a></span><span class="cite-item" role="listitem"><a class="cite-source" href="#!">Profightdb</a></span></span></span></span></dd>
  <dt class="col-sm-3">Billed height</dt>
  <dd class="col-sm-9">6 ft 0 in<span class="cite"><button type="button" class="cite-marker" popovertarget="cite-demo-d2" aria-label="1 source"><span class="cite-count" aria-hidden="true"></span></button><span class="cite-popover" popover id="cite-demo-d2" role="dialog" aria-labelledby="cite-demo-d2-title"><span class="cite-header"><span class="cite-title" id="cite-demo-d2-title">1 source</span><button type="button" class="btn-close" popovertarget="cite-demo-d2" popovertargetaction="hide" aria-label="Close"></button></span><span class="cite-list" role="list"><span class="cite-item" role="listitem"><a class="cite-source" href="#!">allelitewrestling.com</a></span></span></span></span></dd>
</dl>

Quiet markers in dense tables

Add .cite-quiet to a table or list where every cell is cited. On devices with a mouse, the markers fade until you hover or focus that cell. Touch screens and keyboard users always see them at full strength.

ChampionWonDays
Swerve Strickland2 sourcesallelitewrestling.comProfightdb Apr 21, 20241 sourceProfightdb 1461 sourceProfightdb
HTML
<table class="table table-sm cite-quiet mb-0">
  <thead><tr><th scope="col">Champion</th><th scope="col">Won</th><th scope="col">Days</th></tr></thead>
  <tbody>
    <tr>
      <td>Swerve Strickland<span class="cite"><button type="button" class="cite-marker" popovertarget="cite-demo-t1" aria-label="2 sources"><span class="cite-count" aria-hidden="true">2</span></button><span class="cite-popover" popover id="cite-demo-t1" role="dialog" aria-labelledby="cite-demo-t1-title"><span class="cite-header"><span class="cite-title" id="cite-demo-t1-title">2 sources</span><button type="button" class="btn-close" popovertarget="cite-demo-t1" popovertargetaction="hide" aria-label="Close"></button></span><span class="cite-list" role="list"><span class="cite-item" role="listitem"><a class="cite-source" href="#!">allelitewrestling.com</a></span><span class="cite-item" role="listitem"><a class="cite-source" href="#!">Profightdb</a></span></span></span></span></td>
      <td>Apr 21, 2024<span class="cite"><button type="button" class="cite-marker" popovertarget="cite-demo-t2" aria-label="1 source"><span class="cite-count" aria-hidden="true"></span></button><span class="cite-popover" popover id="cite-demo-t2" role="dialog" aria-labelledby="cite-demo-t2-title"><span class="cite-header"><span class="cite-title" id="cite-demo-t2-title">1 source</span><button type="button" class="btn-close" popovertarget="cite-demo-t2" popovertargetaction="hide" aria-label="Close"></button></span><span class="cite-list" role="list"><span class="cite-item" role="listitem"><a class="cite-source" href="#!">Profightdb</a></span></span></span></span></td>
      <td>146<span class="cite"><button type="button" class="cite-marker" popovertarget="cite-demo-t3" aria-label="1 source"><span class="cite-count" aria-hidden="true"></span></button><span class="cite-popover" popover id="cite-demo-t3" role="dialog" aria-labelledby="cite-demo-t3-title"><span class="cite-header"><span class="cite-title" id="cite-demo-t3-title">1 source</span><button type="button" class="btn-close" popovertarget="cite-demo-t3" popovertargetaction="hide" aria-label="Close"></button></span><span class="cite-list" role="list"><span class="cite-item" role="listitem"><a class="cite-source" href="#!">Profightdb</a></span></span></span></span></td>
    </tr>
  </tbody>
</table>

Accessibility

  • The marker is a real <button>. Give it an aria-label that says how many sources it opens ("2 sources"). The visible count is aria-hidden so it is not read twice. The browser exposes its expanded state.
  • The popover is labelled by its title. Tab moves from the marker into the list. Escape closes it and returns focus to the marker.
  • The marker's hit area is at least 24×24px (WCAG 2.2 target size), though the visible mark is smaller. In the phone sheet, rows and the close button are larger still.
  • The quote glyph is a CSS mask filled with the text colour, so it stays visible in dark and forced-colours (high contrast) modes.
  • .cite-quiet fades markers only on devices that can hover, and never below a visible level. Markers are full strength when focused.
  • The sheet's entry animation respects prefers-reduced-motion.

CSS variables

.cite {
  --bs-cite-color: var(--bs-secondary-color);
  --bs-cite-hover-color: var(--bs-primary-text-emphasis);
  --bs-cite-bg: transparent;
  --bs-cite-hover-bg: var(--bs-primary-bg-subtle);
  --bs-cite-open-bg: var(--bs-primary);
  --bs-cite-open-color: var(--color-accent-fg);
  --bs-cite-popover-width: 22rem;
  --bs-cite-popover-bg: var(--bs-body-bg);
  --bs-cite-popover-color: var(--bs-body-color);
  --bs-cite-popover-border-color: var(--bs-border-color);
  --bs-cite-popover-border-radius: var(--bs-border-radius);
  --bs-cite-popover-box-shadow: var(--bs-box-shadow);
  --bs-cite-accent: var(--bs-primary);   // top edge of the list
}

Sass

$cite-sheet-breakpoint: 576px !default;   // below this the list is a bottom sheet
$cite-icon: url("data:image/svg+xml,…") !default;   // the marker glyph (used as a mask)