Spinners
Spinners can be used to show the loading state in your projects.
Animations
Bootstrap offers two animation styles for spinners. The animation style
can be configured with the animation
property. An animation style
must always be provided when creating a spinner.
Border Spinner - border
Grow Spinner - grow
Variants
All standard visual variants are available for both animation styles by
setting the variant
property. Alternatively spinners can be custom
sized with the style
property, or custom CSS classes.
Sizing
In addition to the standard size, a smaller additional preconfigured
size is available by configuring the size
property to sm
.
Buttons
Like the original Bootstrap spinners, these can also be used with
buttons. To use this component out-of-the-box it is recommended you
change the element type to span
by configuring the as
property when
using spinners inside buttons.
Accessibility
To ensure the maximum accessibility for spinner components it is
recommended you provide a relevant ARIA role
property,
and include screenreader-only readable text representation of the
spinner's meaning inside the component using Bootstrap's sr-only
class.
The example below provides an example of accessible usage of this component.
API
Spinnerview source file
import Spinner from 'react-bootstrap/Spinner'
Copy import code for the Spinner componentName | Type | Default | Description |
---|---|---|---|
animation required | 'border' | 'grow' | true | Changes the animation style of the spinner. |
as | elementType | <div> | You can use a custom element type for this component. |
children | element | This component may be used to wrap child elements or components. | |
role | string | An ARIA accessible role applied to the Menu component. This should generally be set to 'status' | |
size | 'sm' | Component size variations. | |
variant | 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'info' | 'light' | 'dark' | The visual color style of the spinner | |
bsPrefix | string | 'spinner' | Change the underlying component CSS base class name and modifier class names prefix. This is an escape hatch for working with heavily customized bootstrap css. |