BorderBeam
General
@rockshin/tao-uiHighlights an active surface with a moving border light.
This native tao-ui component follows the public API of Ant Design 6.7.0. Appearance, theme tokens and Semantic DOM customization belong to tao-ui; configure themes with TaoProvider.
Props follow the 6.7.0 beam API. The child must expose a native DOM ref or nativeElement handle. Motion uses transform and respects reduced-motion preferences.
When to use
Use sparingly for a meaningful active or processing state. Keep an explicit text status alongside the effect.
Examples
Active card
Processing
12 tasks are running.
Count and duration
Two beams
Two highlights follow the same border with evenly spaced phases.
Custom gradient and item overrides
Independent beams
Each item controls its own color, size and line width.
Inset and nonuniform corners
Toggle a meaningful active state
Syncing changes
The border animation follows the current state.