Research sources
ProA list of sources with relevance, excerpt and status.
pnpm dlx shadcn@latest add @caliper/research-sources3 of 5 sources used in the answer
Is a spinner motion? A thread
forum.example.net
Opinions differ, but most agree that essential indicators of progress can stay if they are small and calm.
forumSkimmed55%
Motion design guidelines, chapter 7
docs.example.dev
Duration and easing tokens, and when to skip animation entirely.
docsNot read yet48%
When to use #
Use it for
- An assistant gathers material and the user may check it.
- Sources should be selectable.
Skip it when
- There is only one source; cite it inline.
Installation #
pnpm dlx shadcn@latest add @caliper/research-sources
Adds its 5 files to components/ui/, each with its own stylesheet, and installs their packages. Pro installs with your access token, set up once per project. See Pro access. The first part also adds Caliper UI’s tokens; import them once as in Installation.
Usage #
Import it from your copy of the source. The example behind the preview comes with the source.
import { ResearchSources } from "@/components/ui/research-sources"
The worked example comes with Pro
The 20-line example behind the preview opens here with a Pro or Team licence.
API reference #
ResearchSources
component
Accessibility #
It exposes status, group and img semantics, with aria-label, aria-pressed and aria-hidden kept in step with state. Changes that matter are announced through a live region.
Keyboard and focus handling comes from Radix popover: arrow keys move through items, Enter and Space select, and Escape closes and returns focus.
Motion #
It declares no animation in its component source. Any transition comes from its stylesheet, which uses the duration tokens that collapse to instant under prefers-reduced-motion.