Components/Feedback
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/liveregion
Live region is a mechanism that broadcasts a message for screen reader users to inform them about the change in the page layout or the status.
<LiveRegion/> when user focus remains where it is, but users must be aware of the changes that happened on the page.Specify a message to announce for screen reader users with broadcast prop.
Specify how urgently a message should be broadcasted with role prop.
There are 2 roles types:
status (default) - use it when it's important that user receives updates about changes in the region, but not so rapidly that natural flow would be interrupted. Screen reader will announce a message after the current message is delivered.alert - use for time sensitive and critical notifications that require immediate users attention. Message will be announced right away, even if screen reader is currently in the middle of a sentence. As such, it can be disruptive and should be used sparingly.Use live region to inform screen reader users about items removed from the page.
Use live region to inform screen reader users about duplicated items added to the page.
Use live region to inform users about the number of items that match their filter criteria.
| Name | Type | Default | Description |
|---|---|---|---|
dataHook | string | — | Applies a data-hook HTML attribute that can be used in the tests. |
ref | null | string | (instance: LiveRegionRefType | null) => void | RefObject<LiveRegionRefType> | — | Allows getting a ref to the component instance. Once the component unmounts, React will set ref.current to null (or call the ref with null if you passed a callback ref). |
Import the driver matching your test environment:
| Method | Description |
|---|---|
exists | Checks whether the component found with the given data hook |
element | Gets the component root element |
getMessage | Returns the message |
getRole | Returns the role |
click | Clicks on the component root element. |
base | Returns UniDriver for the base element. |
Last updated: 22 October 2026