Components/Actions
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/composerbutton
Composer button as it's name suggest, is a custom button for composers tools and functions.
Use shape prop to change the shape of the composer button.
Square is the default shapeRoundUse color prop to change button color, you can choose one of these:
standardbluecyanpurplepinkorangeredgreenUse ellipsis prop to get truncated label when it reached max width.
Use maxLines prop to limit the number of lines the button label has before getting truncated.
To disable a composer button, use the disabled prop which indicates a button can't be selected.
Add form fields
| Name | Type | Default | Description |
|---|---|---|---|
as | "button" | — | Renders component as any other component or a given HTML tag. |
children (required) | ReactNode | — | Used for passing any @wix/design-system icon. For external icon make sure to follow ux sizing guidelines. |
color | "standard" | "blue" | "cyan" | "green" | "orange" | "pink" | "purple" | "red" | "teal" | "violet" | — | Sets button color. |
dataHook | string | — | Applies a data-hook HTML attribute that can be used in tests. |
disabled | boolean | — | Specifies whether user interactions are disabled. |
ellipsis | boolean | — | Truncates label that is longer than its parent container and displays ellipsis at the end of the last line. |
label (required) | ReactNode | — | Sets label value. |
maxLines | number | — | Truncates label text at a specific number of lines when using ellipsis. |
onClick | MouseEventHandler | — | Defines a callback function which is called every time a button is clicked. |
ref | null | string | (instance: ComposerButtonHandle | null) => void | RefObject<ComposerButtonHandle> | — | 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). |
shape | "round" | "square" | — | Sets button shape. |
Import the driver matching your test environment:
| Method | Description |
|---|---|
isDisabled | Checks whether button is disabled |
getLabelValue | Returns button label value |
isFocused | Checks whether button is focused |
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: 22 October 2026