Components/Feedback
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/loader
Loader is used to show users when an action is being processed.
<Skeleton/> instead.<CircularProgressBar/> or <LinearProgressBar/> instead.<Skeleton/> instead.Adjust loader size using the size prop. It supports 4 sizes:
large - use for a full page, like when saving applied changes.medium (default) - use for a specific area inside of a page.small - use in larger components, like a table or a modal.tiny - use in smaller components, like a button.Change the colors of the loader circle with the color prop. There are 2 color options:
blue (default) - use on white and light grey backgrounds.white - use on dark backgrounds.status defines the current state of the Loader indicator.
loading: shows an active loading state.success: shows a successful completion state.error: shows a failed/error state.Show the process status using the statusMessage prop. The message is displayed when a user mouse hovers over the loader.
Note: users navigating with a keyboard will not be able to see the message.
Add a descriptive label below a loader with the text prop. Use it to explain what is happening when additional info is required.
Use loader to indicate that more items are being loaded to a list as a user scrolls down a component or layout, e.g., inside a <Table/>.
Add a loader inside of a <Button/> to inform users that the action has started and is currently being processed.
Use a loader to indicate that changes a user made on the page are being saved.
| Name | Type | Default | Description |
|---|---|---|---|
color | "blue" | "white" | — | Controls the skin of the loader. |
dataHook | string | — | Applies a data-hook HTML attribute to be used in the tests. |
size | "small" | "tiny" | "medium" | "large" | — | Controls the size of the loader. |
status | "error" | "loading" | "success" | "loadingWithErrors" | — | Specifies the status of a loader. |
statusMessage | string | — | Defines the message that explains the current status of the loader. The message is displayed on loader hover. If not given or empty, no tooltip is displayed. |
text | ReactNode | — | Defines a text message to show below the loader. |
Import the driver matching your test environment:
| Method | Description |
|---|---|
component | — |
getColor | returns the loader color ('blue' or 'white') |
getText | returns the element text |
hasText | true if the element has text |
statusIndicatorExists | true if the status indicator is rendered |
isLarge | true when using the large loader |
isMedium | true when using the medium loader |
isSmall | true when using the small loader |
isTiny | true when using the tiny loader |
isLoading | true when loader is in loading status |
isLoadingWithErrors | true when loader is in loading-with-errors status |
isError | true when loader is in error status |
isSuccess | true when loader is in success status |
getStatusMessage | trigger the tooltip and returns the value of the tooltip message (async function) |
exists | Checks whether the component found with the given data hook. |
element | Gets the component root element. |
click | Clicks on the component root element. |
base | Returns UniDriver for the base element. |
Last updated: 21 October 2026