Skip to content
ArcadiaDesign

TSX

A 2px line along one edge of a surface that says what is under it is loading, when nothing else on that surface can say so in place: a toolbar over a view whose content is on its way. A stretch of ink, two fifths of the width, runs across it on the sweep curve, once per half of the shared clock, and pauses when the line is off screen or the window is unwatched. It lies on its positioned parent's bottom edge, or its top.

It keeps the loading rule itself: it shows 200ms after active turns on, so a quick load draws nothing, and once shown it stays 400ms, so it never blinks. It fades out where it stands. In ink, never the accent: it is not a light.

Which loader? A Spinner says one control is busy and a Skeleton holds the place of content. The loading line is for a whole view behind a bar, where the bar keeps working while it loads.

Examples

Top edge

top lays it along the top of its parent, over a view that loads from above.

rootStyle takes layout and these knobs.

--loading-line-h
"1px" | "2px"Default 2px
Thickness.
--loading-line-color
PaintDefault var(--icon-2)
The stretch that runs.

Hidden from assistive technology unless given a label, which makes it a progressbar with that name while it runs (no value: it is indeterminate). Omit the label when a control beside it already says so, such as a Reload button that turned into Stop. With reduced motion the stretch holds still across the middle.

LoadingLine

activerequired
boolean
Runs while true: shown 200ms after it turns on, then held at least 400ms.
edge
"top" | "bottom"Default "bottom"
The edge of its positioned parent it lies on.
label
string
Accessible name while it runs ("Loading"). Omit when nearby text or a control already says so.
rootStyle
RootStyle<LoadingLineKnobs>
Typed StyleX override: layout and the --loading-line-* knobs.

Rest props go to <span> props and render.