For AI agents: the complete documentation index is available at https://rickyshin93.github.io/tao-ui/llms.txt, the full documentation bundle is available at https://rickyshin93.github.io/tao-ui/llms-full.txt, and this page is available as Markdown at https://rickyshin93.github.io/tao-ui/components/spinner.md.
v0.0.57
  • English
  • Spinner

    Feedback@rockshin/tao-ui

    Indicates indeterminate loading activity.

    When to use

    Use Spinner for short indeterminate waits when progress cannot be measured.

    Recommended

    • Prefer inline placement near the content that is loading.
    • Use aria labels for standalone spinners.

    Avoid

    • Do not use Spinner for determinate progress.

    Examples

    Basic usage

    Loading
    TSX

    Tips and custom indicators

    Loading data◌CustomPreparing preview
    TSX

    Content overlay and delay

    Content remains mounted below the overlay.
    TSX

    Loading over content

    spinning controls loading over a content area.

    Card title

    Content stays in place and dims while the spinner overlays it.

    Loading
    TSX

    Delayed loading

    A short request can finish before delay to avoid flicker.

    500ms delay — quick toggles won't flash the spinner.

    Toggle quickly to see the delay in action.
    TSX

    Custom indicator

    indicator replaces the visual mark; retain clear status text.

    ⏳Please wait
    TSX

    Controlled loading

    Control spinning externally while keeping content in place.

    Your workspace content stays here.
    TSX

    API

    Spinner

    PropertyDescriptionTypeDefault Value
    spinningWhether the spinner is visible. Defaults to true.boolean | undefinedtrue
    sizeSize of the indicator. Inherits from TaoProvider.TaoSize | undefined-
    tipDescription text rendered under the indicator.ReactNode-
    delayDelay (ms) before showing the spinner — prevents flicker on fast loads.number | undefined-
    indicatorCustom indicator node, replaces the default spinner.ReactNode-
    childrenWrap content: the spinner overlays children while spinning.ReactNode-
    fullscreenRender a full-screen backdrop with a centered spinner.boolean | undefined-
    classNameAdditional css classstring | undefined-
    styleAdditional styleCSSProperties | undefined-