TextReveal
Word-by-word reveal animation on scroll.
Installation
dotnet add package Lumeo.Motion
One-time app setup (AddLumeo(), CSS & JS) is covered in the
installation guide.
Usage
@using Lumeo <TextReveal />
12 tests across 2 files. Auto-generated from the test suite.
When to Use
- Create engaging hero headings or testimonial quotes that animate as the user scrolls into view.
- Draw attention to a key value proposition in a long-form landing page.
- Control the reveal pace with
Stagger(ms between words) andThreshold(scroll visibility fraction).
Threshold = 0.30 — scroll the text into view to trigger the reveal. Use the Replay button after changing the threshold.
Drag the slider to change how far into view the text must scroll before the reveal begins. A higher value means more of the element must be visible.
Adjust the stagger interval (ms between words). Scroll down to see the reveal — or reload the demo.
Stagger = 80 ms
API Reference
TextReveal
| Prop | Type | Default | Description |
|---|---|---|---|
| Text | string | string.Empty | The text to reveal, split on whitespace into individually-animated words. |
| Stagger | int | 80 | Delay in milliseconds added per word index, so later words reveal after earlier ones. Default 80. |
| Threshold | double | 0.3 | Fraction of the element that must be visible in the viewport before the reveal triggers, passed to the underlying IntersectionObserver. Clamped to [0, 1]. Default 0.3. |
| Class | string? | — | Additional CSS classes merged onto the root <span>. |
| AdditionalAttributes | Dictionary<string, object>? | — | Captures any unmatched attributes and applies them to the root <span>. |
Related Components
- NumberTicker — Animated count-up from zero to a target number.
- Marquee — Infinitely scrolling horizontal band of children.