Skip to content

Cited by

How many works cite a record and which, each with its index and when that was read.

<div data-mount="count"></div>

Installation

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

Usage

<p class="cap-cited-by-count"><a href="https://example.org/works?cites=example">Cited by 12</a> <span class="cap-cited-by-source">Example Index, read 2026-11-01</span></p>

<section class="cap-cited-by" aria-labelledby="cb">
  <h2 class="cap-cited-by-title" id="cb">Cited by 25 of 40</h2>
  <p class="cap-cited-by-source">Example Index, read 2026-11-01. Newest first.</p>
  <ol class="cap-cited-by-list">
    <li><a href="https://doi.org/10.5555/example">Field notes from a second season</a><span class="cap-cited-by-source">, Example Journal</span><span class="cap-cited-by-source">, 2026</span></li>
  </ol>
</section>

Examples

The count without a link, and no count drawn below 1

<div data-mount="count-plain"></div>
<div data-mount="count-zero"></div>

The list, all of it

<div data-mount="list"></div>

The list, fewer than the count, with missing fields

<div data-mount="capped"></div>

API reference

CitedByCount

PropTypeRequiredDoes
countnumber | null | undefinedYesThe count the index reports. Below 1 nothing is drawn: a cold cache must not look like a measured zero.
hrefstring | nullThe index's page of citing works, when there is one.
sourcestringYesWhere the count comes from and when it was read: "OpenAlex", "2026-11-01" or a Time.
readAtReactNode

CitedBy

PropTypeRequiredDoes
totalnumberYesThe true count, which may be more than works holds.
worksreadonly CitingWork[]Yes
sourcestringYes
readAtReactNode
orderstringHow the list is ordered, said after the source: "Newest first."
headingLevel2 | 3 | 4

Parts and data attributes

ClassIs
.cap-cited-bythe root
.cap-cited-by-counta part
.cap-cited-by-lista part
.cap-cited-by-sourcea part
.cap-cited-by-titlea part

Accessibility

KeyDoes
TabMoves through the count's link and each work's link, as any link
  • The list is a labeled section (its heading) and an ordered list.
  • Titles are text links; the provenance, venue and year are --muted at 4.5:1.