Article Headings
TypographySemantic article headings resolve through a brief, grapheme-safe noise frontier.
Try it
Add to your project
npx shadcn@latest add https://luv-jeri.github.io/cojeev-ui/r/article-headings.jsonThe command includes the component’s shared dependencies. Your project keeps editable source files.
Include the complete example
This example also composes button. Install its parts together:
npx shadcn@latest add https://luv-jeri.github.io/cojeev-ui/r/button.json https://luv-jeri.github.io/cojeev-ui/r/article-headings.jsonUsing article headings
Supply stable unique item ids, full titles and optional metadata or hrefs; choose the correct heading level for the surrounding page.
Change replayKey to deliberately decode again. Pausing or leaving view restores complete text and cancels the current sequence.
Use on a compact editorial list; duration and total stagger are bounded, and large titles/lists retain readable static text.
API
Compose the exported parts below. The prop types are read from the React source during the registry build.
Native element or underlying primitive props are inherited where declared, including accessible labels, event handlers and refs.
ArticleHeadingsProps
| Prop | Type | Required |
|---|---|---|
items | readonly ArticleHeadingItem[] | Yes |
label | string | No |
headingLevel | 2|3|4 | No |
duration | number | No |
stagger | number | No |
scrambleLength | number | No |
preserveChance | number | No |
tailChance | number | No |
paused | boolean | No |
replayKey | string|number | No |
size | "sm"|"default"|"lg" | No |
onDecodeComplete | ()=>void | No |
Accessibility
Actual complete heading text remains in the accessibility tree throughout; decorative changing glyphs are aria-hidden and never announced.
Each glyph reserves its true footprint so noise does not move the heading, metadata or neighboring content.
Reduced motion, shared motion/flow off and hidden/offscreen stages keep exact still headings. Optional links remain keyboard accessible with visible focus.
States and appearance
For conditional content, keep a MotionPresence boundary around keyed MotionSurface children. The shared entrance and exit states work with native primitives and respect your motion preference.
Try pointer and keyboard interaction, and switch the appearance control in the navigation to compare light and dark mode. Motion respects reduced motion preferences.