Skip to main content
brickwork
GitHub Log in Get started
Display
Theme
Density
Direction
Brand

Documentation

Spinner

An indeterminate activity indicator.

All components Component Brickwork 4.3.1

Try it

Saving state

Open full-page preview

Named activity indicator.

Use only when a named operation has no measurable completion value; use progress for measurable work.

Use it

Working invocation

This code creates the configuration shown above. Copy the template and the required Python context together.

templates/your_app/component.html

Django template

{% include "brickwork/components/_spinner.html" %}

your_app/views.py

Python

context = {}

Guide

Add it to your project

  1. Include with a clear label where the surrounding context does not already name the work.

View this component's source for the installed release

Options

Public API

Behaviour

Accessibility and responsive behaviour

Accessibility
It is always aria-hidden. Put aria-busy and any operation name on its host control; the spinner is never the only busy signal.
Responsive
No breakpoint-specific behaviour.
Without JavaScript
Static indicator is still visible when motion is reduced.

Need help?

Troubleshooting

Contract check: Accessibility: aria-hidden="true" always; the busy state is conveyed by

Pair a spinner with host-owned visible busy status; the glyph itself is never an accessible name or an error message.

Documentation