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.
<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 facts and first ran a show in 19983 sourcesProfightdbWrestling Inc.The Armory — history.
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 — rosterProfightdb
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.
| Champion | Won | Days |
|---|---|---|
| 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 anaria-labelthat says how many sources it opens ("2 sources"). The visible count isaria-hiddenso 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-quietfades 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)