components/spin/index.en-US.md
When part of the page is waiting for asynchronous data or during a rendering process, an appropriate loading animation can effectively alleviate users' inquietude.
<code src="./demo/basic.tsx">Basic Usage</code> <code src="./demo/size.tsx">Size</code> <code src="./demo/nested.tsx">Embedded mode</code> <code src="./demo/tip.tsx">Customized description</code> <code src="./demo/delayAndDebounce.tsx">Delay</code> <code src="./demo/custom-indicator.tsx">Custom spinning indicator</code> <code src="./demo/percent.tsx" version="5.18.0">Progress</code> <code src="./demo/style-class.tsx" version="6.0.0">Custom semantic dom styling</code> <code src="./demo/fullscreen.tsx">Fullscreen</code>
Common props ref:Common props
| Property | Description | Type | Default | Version |
|---|---|---|---|---|
| classNames | Customize class for each semantic structure inside the component. Supports object or function. | Record<SemanticDOM, string> | (info: { props }) => Record<SemanticDOM, string> | - | |
| delay | Specifies a delay in milliseconds for loading state (prevent flush) | number (milliseconds) | - | |
| description | Customize description content | ReactNode | - | 6.3.0 |
| fullscreen | Display a backdrop with the Spin component | boolean | false | 5.11.0 |
| indicator | React node of the spinning indicator | ReactNode | - | |
| percent | The progress percentage, when set to auto, it will be an indeterminate progress | number | 'auto' | - | 5.18.0 |
| size | The size of Spin, options: small, medium and large | string | medium | |
| spinning | Whether Spin is visible | boolean | true | |
| styles | Customize inline style for each semantic structure inside the component. Supports object or function. | Record<SemanticDOM, CSSProperties> | (info: { props }) => Record<SemanticDOM, CSSProperties> | - | |
Customize description content when Spin has children. Deprecated, use description instead | ReactNode | - | ||
The className of wrapper when Spin has children. Deprecated, use classNames.root instead | string | - |
Spin.setDefaultIndicator(indicator: ReactNode)
You can define default spin element globally.
<code src="./demo/_semantic.tsx" simplify="true"></code>
<ComponentTokenTable component="Spin"></ComponentTokenTable>