Components/Actions
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/selectorbutton
Selector button triggers a selection panel or modal, such as a font picker or link settings, from a settings panel. Its text can show the current selection.
<Button/> instead.Control selector button size with size prop:
large is best for calls to action that require more emphasis.medium is for layouts where other medium sized elements are used.small is default for panels. Provides more compact UI layout.Use the dark skin variant in panels and contexts where the component should visually blend into the UI.
Apply the standard skin in contexts where the button needs to appear more actionable.
Add more context to actions with suffix icons:
suffixIcon.suffixIcon can be removed.To disable a button, use the disabled prop which indicates a button can't be selected.
Use the ellipsis prop for overflow text. The full text will be displayed in a <Tooltip/> when a user hovers over the button. Control the style of the tooltip using the tooltipProps.
Note: Try to avoid lengthy action labels. CTA text should be short and clear – one to two words, or max three for specific use cases.
Use the fullWidth prop to fill the button to 100% of the parent container.
Use the Selector Button in app settings panels to provide an entry point for opening a font picker.
Use the Selector Button in panels to provide an entry point for opening the link settings panel.
| Name | Type | Default | Description |
|---|---|---|---|
children | ReactNode | — | Accepts any item as a child element. For all common cases pass a standard text string. |
dataHook | string | — | Applies a data-hook HTML attribute that can be used in the tests. |
disabled | boolean | — | Specifies whether user interactions are disabled. |
ellipsis | boolean | — | Specifies whether component handles text overflow with ellipsis. If enabled, a label that exceeds the available space is displayed inside a tooltip when the user hovers over the button. |
fullWidth | boolean | — | Sets button width to fill a 100% of a parent container width. |
onClick | MouseEventHandler | — | Defines a callback function which is called every time a button is clicked. |
ref | null | string | (instance: Button | null) => void | RefObject<Button> | — | 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). |
showTooltip | boolean | — | Specifies whether the full button label is displayed in a tooltip when label overflows available space. Behaviour is enabled by default. Set property value to false to show ellipsis without a tooltip. |
size | "small" | "medium" | "large" | medium | Controls the size of a button. |
skin | "standard" | "dark" | dark | Controls the text color skin of the button. |
suffixIcon | ReactElement | — | Pass an icon or a component to display at the end of a label (e.g., svg, image, etc.) |
tooltipProps | TooltipCommonProps | — | Allows to pass all common tooltip props. Use it to customize a tooltip created from text ellipsis. |
Import the driver matching your test environment:
| Method | Description |
|---|---|
getButtonTextContent | Gets button text |
isFocused | Checks whether button is focused |
isDisabled | Checks whether button is disabled |
hasSuffix | Checks whether button has suffix |
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. |
size="small" the suffix icon container is now 18×18px (was 24×24px), matching the 18px icons small buttons use — the icon no longer overflows the button's content box vertically and the extra gap before the right edge is gone. Medium and large keep the 24×24px container. (#16725) — has visual changesLast updated: 22 October 2026